Get started

Open your first workspace

A workspace is the local project folder that holds your notes, tables, Boards, other kit files, and workspace-owned state.

Updated

By Kition Docs

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

What a workspace is

A workspace is an ordinary local folder. It can contain Markdown notes, .ktable tables, .kboard Boards, files for Kition’s other kits, images and attachments, workflows, and a hidden .kition folder with workspace-owned state.

Kition keeps a list of workspaces on the current device. The workspace folder itself remains the source of truth for project-owned content.

Open one

  • In the workspace launcher, choose Open local workspace
  • Pick an existing folder, such as a folder of Markdown notes, or create a new empty folder in the folder picker
  • Use Rename in the launcher to give the entry a recognizable name
  • If another workspace is already open, choose Open here to replace it or Open new window to keep both open

Note

Remove from list only removes the launcher entry. It does not delete the folder or its files.

Getting Started

Kition adds a Getting Started folder with a Welcome to Kition note and example tables. Settings → General → Sample data can import more guided examples into it.

What stays outside the workspace

Provider credentials, account sessions, logs, caches, the device’s workspace list, and device-specific preferences live in Kition’s application data rather than the workspace folder.

After copying a workspace to another device, expect to reconnect providers, accounts, and external services.

Multiple workspaces

The launcher lists the most recently opened workspaces first. Rename or remove entries without changing the folder name or deleting data on disk. Press Cmd/Ctrl + Shift + O, or use Switch workspace at the bottom of the sidebar, to reopen the launcher.

Keep separate work and personal workspaces when they have different sharing, retention, or provider-key requirements.

Portability limits

Copying or cloning a complete workspace is the supported portability model. Concurrent merging of binary files is not guaranteed, so treat cloud-folder sync as file replication, not real-time collaboration.

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.