Docs
Documentation
Kition documentation is a task-based guide to the desktop workspace: documents, tables, Whiteboards, Layout Studio, Agents, and workflows. Each maintained guide states its verification version; check that boundary against your installed release.
Guides are checked against Kition 0.2.0 (7d49036f), reviewed on . Start with a real input, follow the numbered steps, and inspect the expected output before enabling repeatable work.
Get started
What is Kition
A desktop workspace where kits edit notes, tables, Boards, and other files, with an Agent and visual workflows working on the same files.
Install Kition
Download the official desktop build for macOS, Windows, or experimental Linux and complete first launch.
Open your first workspace
A workspace is the local project folder that holds your notes, tables, Boards, other kit files, and workspace-owned state.
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.
Configure an AI provider
Use Kition Cloud or connect OpenAI, Anthropic, DeepSeek, Kimi, or a supported custom endpoint.
Protect provider credentials
Understand how Kition stores provider secrets and reduce the impact of device or key compromise.
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.
Scenarios
Real-world scenarios
Complete Kition workflows for campaign assets, receipt OCR, and product asset pipelines.
Generate campaign assets in batches
Turn one story brief and portrait into platform-ready YouTube thumbnails and TikTok covers while keeping identity and review state visible.
Turn receipt images into searchable records
Extract vendor, address, category, structured JSON, and plain OCR text from receipt attachments in the same table row.
Expand one product brief into a complete asset pipeline
Generate coherent concept designs, orthographic views, campaign imagery, style boards, and launch copy while keeping every result linked to its source brief.
Document editor
Markdown editing basics
Write Markdown notes in the Note kit with live preview, the menus, the slash menu, and the keyboard shortcuts it supports today.
Wikilinks
Link notes with target, alias, heading, and block syntax, and open them from the Note kit.
Callout syntax
Write `[!type]` blockquotes that the Note kit draws as callouts, and keep the source portable as ordinary Markdown blockquotes.
Command palettes and quick navigation
Use the app command palette, workspace search, and the Note kit’s own menus without mixing up their shortcuts.
Document templates
Create a new note from the built-in Template Center or from Markdown files stored under `Templates/`.
Embeds and tables in notes
Edit Markdown tables as a grid inside a note, link to `.ktable` tables, and know what `![[...]]` embeds show today.
Math and Mermaid diagrams
Write inline and block math and Mermaid code fences that the Note kit draws as formulas and diagrams away from the caret.
Export a document
Export a note as HTML or PDF, or print it, from the Note kit’s File menu.
Data tables
Create a table
Create a `.ktable` file from the workspace Create menu, add more tables from templates inside it, then customize fields, records, and views.
Field types overview
Choose from the 23 field types the Table editor offers, know which ones do not fill in values, and configure AI on supported fields.
Create and switch views
Create Grid, Gallery, Kanban, or Calendar views and keep each view’s presentation settings separate from the table records.
Filter, sort, and group
Build bounded AND/OR filter trees, apply ordered multi-field sorts, and group by text, single-select, or checkbox fields.
Configure AI on a table field
Attach text or image AI actions to supported fields, choose manual or source-driven regeneration, and review batch limits.
Import spreadsheet data
Preview CSV, TSV, or XLSX data, review the inferred field types, and import it as a new table in your `.ktable` file.
Export a table to CSV or Markdown
Use the Export menu in the tab bar to write the table you are looking at as a new CSV or Markdown file next to the `.ktable` file.
Link documents and tables
Store a workspace document path in a Document link field, link to the `.ktable` file from a note with an ordinary wikilink, and know what is not kept in sync.
AI agent
Agent chat basics
Open a workspace-scoped chat, attach only the context you need, choose a model, and review the streamed work and the files it changed.
Agent tool calls
Read the runtime tool names, how availability is decided, and the inputs, outputs, errors, and changed files shown in the Agent timeline.
Plans, drafts, and review
Distinguish the informational Agent plan card from the review steps that actually hold changes back: kit drafts and shell approvals.
Hooks status
The Kition runtime can run shell hooks on Agent events, but the app does not offer a Hooks settings pane or a hooks file to configure them.
Connect MCP servers
Add external MCP servers through the `mcp.toml` configuration file; Kition has no MCP settings pane.
Web research for the Agent
Let the Agent search the web through the model provider, fetch public pages, and save articles into the workspace.
Control Agent usage and cost
Use provider-side limits, Kition Cloud credits, smaller context, explicit model choices, and the Stop control without relying on nonexistent budget-routing features.
Agent approvals and safety boundaries
Use the shell-command approval card and kit drafts without assuming Kition has a universal per-tool permission editor.
Providers
Set up OpenAI
Connect an OpenAI API key, sync the models available to it, and use the Responses wire in Kition.
Set up Anthropic
Connect an Anthropic API key, sync the Claude models available to it, and use the Messages wire in Kition.
Set up a custom provider
Connect an endpoint that implements OpenAI Responses, OpenAI Chat Completions, or Anthropic Messages with one of Kition’s supported authentication schemes.
Set up common models
Use the DeepSeek and Kimi presets or connect another service through the custom-provider compatibility boundary.
Switch the active provider and model
Understand the device-wide model selection that Kition saves when you sync a provider or use the Agent model picker.
Desktop & data
Log and configuration locations
Find the active data, cache, log, export, workspace, and configuration locations from the running Desktop app.
Updates and versioning
Check, download, and install signed Desktop releases from Settings → About in a packaged build.
Free desktop app, pay-as-you-go sync and AI
The desktop app and every kit in it are free; hosted AI and hosted sync are paid by usage in credits, and you can optionally rent compute by the month.
Uninstall Kition and remove app data
Uninstall the application separately from its workspaces, settings, credentials, caches, and logs.
Recipes
Build an evidence table for a research report
An evidence table separates source material from interpretation. In Kition, use a table for traceable findings and a document for the report that explains them.
Create a campaign asset review queue
A campaign review queue is a table that connects each brief with its image candidates, intended channel, and approval state before publishing.
Review a product image asset pipeline
A product asset pipeline connects a product brief with related image candidates and launch copy. A review table keeps the outputs tied to the product they are supposed to represent.
Prepare a project handoff with editable sources
A project handoff packages the final output with the source files, decisions, and dependencies needed to continue the work. Kition projects may include documents, tables, boards, layouts, and other kit files.
Turn meeting notes into a reviewed action table
An action table converts a meeting’s agreed commitments into structured records. Keep the notes as context and review each proposed task before treating it as an assignment.
Reference
Settings reference
Kition settings configure device behavior, accounts, model providers, network, co-editing, extensions, and diagnostics. This reference identifies each section and the scope of each choice.
Keybindings
Keybindings are keyboard shortcuts interpreted by the application, the workspace, or the focused kit editor. Where focus is determines which action a key combination performs.
Privacy and telemetry
Privacy and telemetry describe where workspace data goes and which optional usage events are collected. Local storage does not mean every connected feature operates without network requests.
Agent is not responding
Check the active turn, provider model, account, credit, and network states before collecting diagnostics.
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.
Editor feels slow
Editor lag is a delay between an editing action and the visible response. Isolate the note, its content, and surrounding activity before treating it as a general performance problem.
Wikilinks or backlinks are missing
Check how Kition resolves a wikilink from a note, and what the Note kit does not offer.
CSV import fails
Validate the file format, encoding, headers, preview, and type inference when importing into the Table kit.
PDF export fails
Check page size, unsupported content, and the output location when exporting a note to PDF.
Whiteboards
Create your first board
A board is an editable canvas for shapes, sticky notes, text, connectors, pictures and frames, saved as a .kboard file in your workspace and edited with the Board kit.
Organize ideas with board mind maps
A mind map is a branching outline on a board. The Board kit adds branches and siblings from the keyboard and lays the map out for you as it grows.
Draw a workflow as a board flowchart
A flowchart describes actions and decisions with connected shapes. In Kition, a flowchart on a board is a visual explanation, separate from an executable workflow.
Review Agent changes to a board
The Agent edits an open board directly, through the same commands you use. Review its changes on the canvas, use the board check, and roll back through Version history when needed.
Export a board as PNG, SVG, or PDF
Board export writes a PNG, SVG, or PDF of the shown page or one selected frame as a new file next to the board. Keep the .kboard file when you need to change the diagram later.
Layout Studio
Create an editable poster with the Layout kit
Layout is Kition’s page-layout kit for posters, flyers, programmes, and social graphics built from text frames, images, and shapes. Its editable source is a .klayout file, separate from the images and PDFs you export.
Choose and customize a poster layout
A Layout starter template is an editable layout of text frames, shapes, swatches, and styles. Four templates are included: Editorial, Event, Promotion, and Quote.
Edit poster layers, shapes, and typography
A layout is made of objects such as text frames, graphic frames, and shapes, arranged on layers. The Layers and Properties panels show what each object is and how it is styled.
Combine generated images with editable poster text
Placing an image in a graphic frame and keeping the wording in separate text frames keeps the visual background reusable and the headline editable in a Kition layout.
Export a layout as PNG, JPEG, PDF, and more
The Layout kit exports PNG, JPEG, PDF, IDML, EPUB, and HTML as new files beside the layout, and remembers your export choices for each document. Keep the .klayout source as the editable master.
Create and export multiple layout sizes
Use the Sizes panel to add poster, square, story, landscape, or custom sizes of a layout, then export every size as PNG or JPEG in one step.
Review AI changes to a layout
When a layout is open, Kition AI edits it in place: each change appears on the canvas, joins the document’s undo history, and can be taken back.
Visual workflows
Build your first visual workflow
A Kition workflow is a trigger followed by a chain of actions. It turns repeatable table work into an inspectable sequence with validation, testing, and run history.
Choose a workflow trigger and source table
A workflow trigger defines when a process starts and which record reaches its actions. Choosing the right trigger and required fields prevents work from running on the wrong records.
Schedule workflows with an explicit timezone
A scheduled workflow uses a cron expression and a timezone to determine when it runs. Kition provides frequency choices, an advanced cron field, and a preview of the next runs.
Test a workflow with representative sample data
A workflow test runs a configured action against a real row. It helps uncover missing fields and connection problems before the workflow is enabled.
Inspect workflow runs and diagnose failures
Workflow run history is the record of executions and their outcomes. It connects a configured process with evidence of what actually happened.
Email workflows
Connect an email provider in Kition
An email connection stores the SMTP account a workflow uses to send messages. You create it from a workflow’s Send email action and can reuse it in other workflows.
Send email from a visual workflow
The Send email action delivers a message through a selected SMTP connection. A tested connection and a reviewed recipient, subject, and body are all required for a useful result.
Troubleshoot email connection and sending errors
Email troubleshooting separates provider authentication, transport settings, and workflow execution. Each stage can fail independently.
Articles
Longer field guides and migration notes, kept together at the end of the documentation.
Getting started · 4 min
How to open a .ktable template in Kition
Download a Kition table starter, keep the original as a clean copy, open it locally, inspect fields and sample records, and replace demo data safely.
Data tables · 4 min
Preview a Kition workflow email without sending it
Inspect the resolved recipient, subject, and body against a sample record while the workflow stays disabled and no email connection is created.
Data tables · 4 min
Unresolved workflow field reference: how to repair bindings safely
Find renamed, missing, or wrong-table field references, rebind them with a sample record, and test without creating a misleading partial result.
Data tables · 4 min
AI image field attachments not loading: safe troubleshooting steps
Separate generation failure from attachment rendering, protect prior images, verify model capability, and confirm files still load after Kition restarts.
Data tables · 4 min
Receipt OCR missing fields: review and recovery checklist
Find out why a receipt row is incomplete, protect the source image, rerun only the affected fields, and verify financial values before export.
Getting started · 5 min
What is Kition? A 5-minute product tour
Kition combines connected Markdown documents, structured data tables, web research, visual workflows, and a real AI agent.
Ready when you are.
Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.