Kition

Documents, Tables, Agents, and Workflows in one desktop workspace.
Write connected knowledge, build data tools, research in the browser, and automate repeatable work.

Download Kition

Website · Releases · Contributing · Support · Security

Kition brings Markdown documents, structured table files, a tool-using AI
agent, browser research, and visual workflows into one desktop workspace. It
is built for people who want to move from raw knowledge to organized,
repeatable work without handing context between disconnected tools.

Kition is currently in beta. Back up important workspaces and review agent
changes before relying on them in production workflows.

Why Kition

• Connected documents. Write Markdown with live preview, links, backlinks,
  callouts, code, math, diagrams, daily notes, search, and export.
• Structured data beside the knowledge. Turn research and content into
  typed records, formulas, filters, groups, views, attachments, and AI fields.
• An Agent that can act. Research in browser tabs, inspect documents and
  table schemas, update content, and save useful output into the active project.
• Visible automation. Assemble trigger-and-action workflows, test steps,
  inspect run history, and resolve missing inputs before enabling a process.

Product Tour

Write connected documents Write Markdown with live preview, internal links, backlinks, tags, outlines, embeds, callouts, code, math, diagrams, templates, daily notes, tabs, and full-text search. Export finished work to PDF or DOCX when it needs to leave the workspace.
	Turn data into useful tools Create structured table files with typed fields, attachments, formulas, filters, sorting, grouping, multiple views, and fast record editing. Use them for research, content pipelines, lightweight CRM, inventory, or project tracking.
Give the agent real context Ask the Kition agent to read and update documents, inspect table schemas, create or modify records, research in browser tabs, use tools, and follow a plan. Agent output can be written back into the active workspace.
	Automate repeatable work Build trigger-and-action workflows on a visual canvas. Start from a template, assemble a workflow manually, test individual steps, inspect run history, and resolve missing inputs before enabling it.

Also included:

• AI-assisted table fields for generating text, structured values, and media
  from record context.
• Browser research tabs that stay inside the workspace and can be used by the
  agent when a task needs live web context.
• Email connections and inbox-to-table workflows. See
  Email Connections.
• Model, proxy, MCP, account, usage, update, and desktop integration settings.
• A seeded Getting Started workspace with practical document, table, and
  workflow examples.

Install

Desktop builds are published through
GitHub Releases.

• macOS: download the latest .dmg.
• Windows: download the latest installer.
• Previous versions: browse the complete
  release history.

Run From Source

Requirements:

• Node.js 22.19.0
• pnpm 10.33.0

pnpm install --frozen-lockfile
pnpm dev

pnpm dev verifies and caches the pinned released runtime outside the Git
worktree, then starts the Electron client.

For renderer, component, editor, and style work that does not require runtime
integration:

pnpm dev:web

The web preview runs without the private runtime and is the fastest path for
most client-side contributions. More options are documented in
Runtime development.

Open Source Boundary

This repository contains the public React and Electron client:

• document, table, Agent, browser, settings, email, scenario, and workflow UI;
• the Electron shell and desktop integration;
• public runtime contracts, mocks, fixtures, and black-box tests;
• packaging and unified release workflows.

The Kition runtime is maintained separately and its source is not included in
this repository. Released desktop builds pair the public client with a signed
runtime. Source checkouts communicate with it only through the public contracts
in contracts/runtime/.

There is no Go source, Go module, or runtime source-build fallback in this
repository.

Technology

Contributing

Issues and pull requests for the public client are welcome.

1. Read CONTRIBUTING.md for setup, scope, and required checks.
2. Follow the Kition Development Standard,
   including the recommended Orca worktree workflow.
3. Keep changes inside the public client/runtime contract boundary.
4. Report security-sensitive issues through
   .github/SECURITY.md, not a public issue.

For product questions, account help, and private workspace concerns, see
.github/SUPPORT.md.

Repository Layout

.
├── .github/                 # Community health files and CI workflows
├── contracts/runtime/       # Public runtime schemas
├── docs/                    # Product, contributor, design, and runtime docs
├── e2e/                     # Playwright black-box tests
├── electron/                # Electron shell and runtime manager
├── public/                  # Static assets and onboarding files
├── scripts/                 # Repository checks and inspection entry points
├── src/                     # React application organized by feature domain
├── tooling/                 # Build, lint, and test configuration
└── package.json             # Development, test, and packaging commands

License

The Kition public client is licensed under the
GNU Affero General Public License v3.0 only.

The separately distributed Kition runtime is governed by its own license and
is not included in this repository.