Getting started

Workspace anatomy: vault, docs, tables, agent

A simple mental model: vault = house, documents and tables = rooms, agent = the housemate who actually does chores.

Kition Team·Jan 26, 2026·5 min read

Vault: the workspace root

A vault = a local directory on your machine. All `.md` documents, `.kitable` tables, attachments, and config live under it. Kition activates one vault at a time.

Documents: your notes

Documents are `.md` files supporting `[[wikilinks]]`, callouts, code blocks, math, and embedded table views. Documents link to each other forming a graph; the sidebar shows backlinks.

Tables: structured data

Tables use Notion-style fields and views: content calendar, CRM, issue board. They live next to documents and can be embedded into documents or driven by the agent.

Agent: the housemate that ships

The agent uses filesystem / execution / web / browser / table / MCP tools to operate on the vault. It is not a Q&A bot — it actually performs work. Hooks let you audit every action.

Ready when you are.

Kition is a local-first AI workspace. Markdown documents, structured tables, and an AI agent — running on your own machine, against the model provider you choose.