Reference

Workspace folder is not syncing

Troubleshoot a workspace kept in a third-party synced folder, and tell it apart from Kition’s own document sync.

Updated

By Kition Docs

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

Know the sync boundary

Kition does not synchronize a whole workspace folder. If a workspace is inside iCloud Drive, Dropbox, OneDrive, Syncthing, Git, or another synchronized folder, that service is responsible for copying files between devices.

The sync target must contain the complete workspace, including the hidden .kition folder. Copying only selected files is not a complete workspace transfer.

Kition’s own document sync

Kition can sync individual documents to your other devices through a sync server. It needs a Kition account and a sync server address in Settings → Advanced → Co-editing. Use Test connection there: it reports whether the server can be reached, whether you need to sign in again, and whether co-editing is available for your account.

A document synced this way that is not yet in this workspace appears in Synced documents; open it here to keep it in sync on this device too.

Recover a missing or stale workspace

  • Close Kition on the device that will receive changes
  • Wait until the sync service reports the complete folder as available locally
  • Inspect conflict copies and version history before deleting anything
  • Open the synchronized folder through the Kition workspace launcher
  • Use Refresh workspace in the sidebar after file synchronization completes

Avoid conflicting edits

Do not edit the same workspace concurrently on two devices through a folder-sync service. Close or pause work on one device, wait for its upload to finish, then wait for the other device to finish downloading before opening Kition there.

Keep an independent versioned backup. A synchronization service propagates deletions and conflicts; it is not by itself a backup.

Reconnect device-local services

Provider credentials, proxy secrets, account sessions, and other application-data settings are not stored inside the workspace folder. Configure them separately on each device instead of copying plaintext application secret files through the sync service.

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.