Docs
Documentation
Kition documentation is a task-based guide to the desktop workspace: documents, tables, Whiteboards, image generation, Design Studio, Agents, and workflows. Each maintained guide states its verification version; check that boundary against your installed release.
Translation and Design Studio guides now cover the published 0.1.49 release, 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 for documents, structured tables, Whiteboards, browser research, Agents, and visual workflows.
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 Kition documents, tables, assets, and workspace-owned state.
UI tour
The Kition interface is a set of connected work surfaces around an active workspace. Documents 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 0.1.41 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 avoid treating folder sync as real-time collaboration.
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 GitHub-flavored Markdown in Kition’s CodeMirror editor and use the verified formatting shortcuts and live preview.
Wikilinks and backlinks
Link Markdown documents with verified target, alias, heading, and block syntax, then inspect explicit references in the backlinks panel.
Callout syntax
Render supported `[!type]` blockquotes as callouts and keep the source portable as ordinary Markdown blockquotes.
Command palettes and quick navigation
Use the small app palette, the document command palette, Quick Open, and global search without mixing up their shortcuts.
Document templates
Create a new document from the built-in Template Center or reuse Markdown files stored under `Templates/`.
Document embeds and table-embed status
Kition 0.1.41 can transclude Markdown documents, headings, and blocks, but it does not render `.kitable` views through the old query syntax.
Math and Mermaid diagrams
Render inline and block KaTeX expressions plus Mermaid code fences in the live Markdown editor.
Export a document
Export the active document as Markdown, HTML, PDF, or Word with the options implemented by Kition 0.1.41.
Translate selected text in AI Docs
Translate a document selection in Kition 0.1.49 using the selected Agent model, then replace, insert, copy, or retry the result without leaving the editor.
Data tables
Create a table
Create a blank `.kitable` workspace or start from a verified built-in template, then customize its fields, records, and views.
Field types overview
Choose from the 24 field types implemented by Kition 0.1.41 and configure AI on supported fields without inventing a separate AI type.
Create and switch views
Create Grid, Gallery, Kanban, Calendar, or Form 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 verified text or image AI actions to supported fields, choose manual or dependency-driven regeneration, and review batch limits.
Import spreadsheet data
Preview and import CSV, TSV, or supported XLSX data into a new Kitable or an existing table with reviewed field types.
Download a table as CSV
Download the complete active table through the verified CSV action and treat the file as a data snapshot rather than a view or schema backup.
Link documents and tables
Store a workspace Markdown path in `document_link`, link back to the Kitable with an ordinary wikilink, and understand the missing automatic sync guarantees.
AI agent
Agent chat basics
Open a workspace-scoped chat, attach only the context you need, choose a model, and review the streamed work.
Agent tool calls
Read the actual runtime tool names, availability signals, inputs, outputs, errors, and changed-file results shown in the Agent timeline.
Plans, previews, and apply confirmation
Distinguish informational Agent plans from the table write plans and previews that have an explicit Apply step in Kition 0.1.41.
Hooks status in Kition 0.1.41
The public client contains hook types and runtime API helpers, but 0.1.41 does not expose a supported Hooks settings or file-configuration workflow.
MCP setup status in Kition 0.1.41
Kition has MCP runtime contracts and timeline support, but the 0.1.41 Desktop UI does not expose a supported server-setup workflow.
Browser context for the Agent
Open pages in Kition’s embedded desktop browser, sign in manually, and let the Agent read supported page context without promising full browser automation.
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 feature-specific previews without assuming Kition 0.1.41 has a universal per-tool permission editor.
Providers
Set up OpenAI
Connect an OpenAI project key, sync the models available to that project, and use the Responses wire in Kition.
Set up Anthropic
Connect an Anthropic API key, sync the models available to its workspace, and use the Messages wire in Kition.
Set up a custom provider
Connect an endpoint that implements OpenAI Responses or Anthropic Messages with one of Kition 0.1.41’s supported authentication schemes.
Set up common models
Use the DeepSeek and Kimi presets or connect another service through the verified custom-provider compatibility boundary.
Switch the active provider and model
Understand the device-wide model selection that Kition 0.1.41 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, Plus, and Pro
The desktop workspace is free; Plus and Pro add monthly hosted AI usage without requiring a provider key.
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.
Triage imported email with a review table
Inbox triage turns imported messages into a reviewable queue of topics and next actions. Keep the original message available while adding your own classification and ownership fields.
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, designs, and image assets.
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, email connections, and diagnostics. This reference identifies the version-specific sections and the scope of each choice.
Keybindings
Keybindings are keyboard shortcuts interpreted by the active application, workspace, or document surface. The focused surface 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 runtime, active generation, provider model, account, credit, and network states before collecting diagnostics.
Workspace folder is not syncing
Troubleshoot a third-party synchronized workspace without assuming Kition supplies first-party real-time workspace sync.
Editor feels slow
Editor lag is a delay between an editing action and the visible response. Isolate the document, rendering mode, and surrounding activity before treating it as a general performance problem.
Wikilinks or backlinks are missing
Check Kition’s live wikilink resolution order, reload its cache, and distinguish backlinks from the bounded Broken Links scan.
CSV import fails
Validate the file format, runtime capability, headers, preview, type inference, and compatibility-import limits.
PDF or DOCX export fails
Check Desktop availability, PDF scale and media access, then verify the narrower DOCX conversion boundary.
Whiteboards
Create your first AI whiteboard
A Kition Whiteboard is an editable canvas for diagrams, notes, images, and visual relationships inside a desktop workspace.
Organize ideas with Whiteboard mind maps
A mind map is a branching outline on a canvas. Kition mind-map controls help organize a central topic into related branches.
Draw a workflow as a Whiteboard flowchart
A flowchart describes actions and decisions with connected shapes. In Kition, a Whiteboard flowchart is a visual explanation, separate from an executable workflow.
Review Agent changes to a Whiteboard
A Whiteboard Agent proposal is a preview of typed changes to board elements. Kition exposes additions, updates, and deletions before you accept the proposal.
Export a Whiteboard as PNG or SVG
Whiteboard export creates a PNG or SVG snapshot of the board. Keep the editable workspace board when you need to change the diagram later.
Image generation
Generate images in your Kition workspace
Image generation turns a written brief into a visual asset through a configured image-capable service. Kition keeps the result connected to your project.
Edit an image using a reference
Reference-image editing asks an image-capable model to modify an existing visual. The reference establishes what should remain recognizable while your instruction defines the change.
Use image templates for a repeatable brief
An image template is a reusable prompt and input recipe. Kition image templates help start a generation or reference-editing task without hiding its required inputs.
Save generated images for documents and tables
A generated image becomes a reusable project asset when you save the actual file and connect it to the document, record, or design that needs it.
Troubleshoot image generation and editing
Image-generation troubleshooting separates capability, input, service, and output problems so you can correct the failing step without blindly repeating paid requests.
Design Studio
Create an editable poster in Design Studio
Kition Design Studio is a workspace editor for posters made from text, images, and shapes. Its editable source is a .kidesign file, separate from the exported image.
Choose and customize a poster layout
A Design Studio starter layout is an editable arrangement of text and shapes. Kition 0.1.49 includes editable starter layouts with headline, body, and label slots, plus workspace brand bindings.
Edit poster layers, shapes, and typography
A design layer is an editable object such as text, an image, or a shape. Layer order, visibility, and properties determine how a Kition poster is composed.
Combine generated images with editable poster text
Combining an image layer with separate text layers keeps the visual background reusable and the headline editable in a Kition design.
Export a design as PNG, JPEG, SVG, or PDF
Kition 0.1.49 exports PNG, JPEG, SVG, and desktop PDF, with remembered scale and background settings. Keep the .kidesign source as the editable master.
Set workspace brand colors, fonts, and a logo
Use the Kition 0.1.49 workspace brand kit to keep design colors, typography, and logo choices with the project.
Create and export multiple design sizes
Create poster, square, story, and landscape variants with shared layers and separate layouts in Kition 0.1.49.
Create a design from an AI table record
Start an editable design from a Kition table record, then send the exported image back to the source row for review.
Preview and review AI design changes
On a compatible runtime, inspect Agent-proposed changes to a Kition design, accept or reject them, and undo an accepted change as one step.
Visual workflows
Build your first visual workflow
A Kition workflow is a configured trigger-and-action process. It turns repeatable 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 input context reaches its actions. Choosing the right trigger prevents work from running on the wrong records.
Schedule workflows with an explicit timezone
A scheduled workflow uses a time expression and timezone to determine when it should run. Kition provides frequency controls and an advanced cron field.
Test a workflow with representative sample data
A workflow test checks a configured action against a sample input. It helps uncover missing fields and connection problems before routine execution is enabled.
Inspect workflow runs and diagnose failures
Workflow run history is the record of executions and their reported outcomes. It connects a configured process with evidence of what actually happened.
Email workflows
Connect an email provider in Kition
An Email Provider connection stores the account configuration used by inbox and delivery workflows. IMAP reads a mailbox; SMTP sends messages.
Sync an email inbox into a Kition table
An inbox synchronization workflow imports messages through IMAP into a destination Kitable. The workflow controls the mailbox, schedule, attachment policy, and run history.
Send email from a visual workflow
The Send email action delivers a configured message through a selected SMTP connection. A saved connection and a reviewed recipient mapping are both required for a useful result.
Troubleshoot email connection and sync errors
Email troubleshooting separates provider authentication, transport settings, mailbox selection, 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 .kitable 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, browser 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.
