Get started

Back up and move a workspace

Copy or version the complete workspace, understand what is excluded, and know what Kition’s own document sync does and does not cover.

Updated

By Kition Docs

Verified against Kition 0.2.0 (7d49036f) on 2026-11-06

Back up the whole workspace

The safest backup unit is the complete workspace folder, including the hidden .kition folder. Copying only visible files can leave out workspace identity, stored assets, and Agent history.

For a consistent snapshot, let active writes finish before copying or archiving the folder.

What is workspace-owned

  • Markdown notes, .ktable tables (including their attachments), .kboard Boards, and other kit files
  • Images and assets stored in the workspace
  • Workflow definitions and run history
  • Agent sessions and their event logs under .kition/agents
  • The workspace identity in .kition/workspace.json

What is not included

  • Provider keys and account/session tokens
  • Application logs and caches
  • The device’s workspace launcher list
  • Device-specific display, proxy, and other preferences

Git and privacy

Git works well for Markdown and other reviewable text, but inspect .kition before committing. Agent history can contain prompts, generated text, record values, or other project-sensitive material even though credentials are excluded.

Large images, PDFs, and other binary files may need Git LFS or a separate backup strategy. Concurrent merging of binary files is not guaranteed.

Third-party folder sync

A folder-sync service can replicate the workspace between devices, but it is file replication, not real-time co-editing. Two devices changing the same file can create conflicts that require manual recovery.

  • Test the selected sync service with a disposable workspace first
  • Wait for synchronization to finish before opening the same workspace elsewhere
  • Keep a separate versioned or offline backup
  • Review conflict copies instead of deleting them automatically

Kition document sync and co-editing

Kition can sync individual documents to your other devices and share them for co-editing. This needs a Kition account and a sync server, such as Kition Server, whose address you enter in Settings → Advanced → Co-editing.

Use Sync to my devices on a document, or turn on Sync all my documents. It syncs documents, not the whole workspace folder, so keep backing up the workspace itself.

Restore or move

  • Copy or clone the complete workspace to the target location
  • Open the folder from the Kition workspace launcher
  • Verify notes, tables, attachments, Boards, and workflows
  • Reconnect provider credentials, Kition Account, email, and other external services
  • Run a small read-only Agent task before resuming automated work

Implementation sources

Related pages

Ready when you are.

Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.