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,
.ktabletables (including their attachments),.kboardBoards, 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