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
Install Kition
Download the official desktop build for macOS, Windows, or experimental Linux and complete first launch.
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.
UI tour
The Kition interface is a set of kit editors around an active workspace. Notes explain, tables organize records, Boards show relationships, and the Agent works with selected context.