---
title: "Kition SDK docs — embed, script, headless, agents and co-editing"
description: "The Kition SDK puts real editors for docx, xlsx, pptx, PDF, PSD and more in your product: embed them, script them, run them headless, or hand them to an AI agent."
canonical: "https://developer.kition.ai/docs"
source: "kition-sdk docs/sdk/README.md"
---

> Canonical HTML: [https://developer.kition.ai/docs](https://developer.kition.ai/docs)

# Kition SDK developer docs

The Kition SDK puts real editors for docx, xlsx, pptx, PDF, PSD and more in your product: embed them, script them, run them headless, or hand them to an AI agent.

Version **0.2.0** (`sdk.json`; changes in [CHANGELOG.md](https://github.com/KitionAI/kition-sdk/blob/main/CHANGELOG.md)).

The [platform documentation](https://github.com/KitionAI/kition-sdk/blob/main/docs/platform/index.md) describes the SDK contracts.

The Kition SDK delivers published Kition kits to products and AI agents. The published kits are
Note, for Markdown documents, and Table, for `.ktable` tables. A kit is one engine behind four delivery forms, so a person in your web
app and your agent work on the same file with the same engine:

| Form | Use it to | Package or executable | Guide | Platform |
| --- | --- | --- | --- | --- |
| **Embed** | put a kit's editor in your web page, over your storage and your users | `@kition/embed` | [Embed: in your page](https://developer.kition.ai/docs/embed.md) | [`KitEmbed 1.8`](https://github.com/KitionAI/kition-sdk/blob/main/docs/platform/sets/embed.md) (`@kition/embed` serves `KitEmbed 1.3`, with EM25's opening and EM28–EM31); [Kit UI protocol](https://github.com/KitionAI/kition-sdk/blob/main/docs/platform/reference/ui-protocol.md) (UI-H1–H7, UI-K1–K7); [kit editors](https://github.com/KitionAI/kition-sdk/blob/main/docs/platform/kits/ui.md) |
| **Script** | read and edit documents from code, in a page or in Node | `@kition/script` | [Script](https://developer.kition.ai/docs/script.md) | [`KitObjectModel 1.0`](https://github.com/KitionAI/kition-sdk/blob/main/docs/platform/sets/object-model.md); exchange in [`KitModel 1.1`](https://github.com/KitionAI/kition-sdk/blob/main/docs/platform/sets/model.md) |
| **Headless** | run a kit without a page, from any language: servers, desktop apps, batch jobs, tests | `kition-kits serve`, `kition-<kit>` executables | [Headless](https://developer.kition.ai/docs/headless.md), [hosts.md](https://github.com/KitionAI/kition-sdk/blob/main/docs/sdk/hosts.md) | [engine contract](https://github.com/KitionAI/kition-sdk/blob/main/docs/platform/kits/engine.md); [`KitAgent 1.4`](https://github.com/KitionAI/kition-sdk/blob/main/docs/platform/sets/agent.md) (A1–A4, headless Kit Process Protocol) |
| **Agent** | give an AI agent a kit's tools, including checking its own output | `kition-kits-mcp` (MCP over stdio; `@kition/kits-mcp` on npm), agent skill | [Agents (MCP)](https://developer.kition.ai/docs/agent.md) | [`KitAgent 1.4`](https://github.com/KitionAI/kition-sdk/blob/main/docs/platform/sets/agent.md) (A1–A23, D1) |

Co-editing: [Co-editing](https://developer.kition.ai/docs/collab.md) (Kition Cloud for your tenant: sync tokens from your server,
or Kition Server on your own machines).
Training and evaluation: [env.md](https://github.com/KitionAI/kition-sdk/blob/main/docs/sdk/env.md) (any kit as an environment: generated editing tasks,
rewards, verified traces; `kit-env`).
Delivery: [Distribution](https://developer.kition.ai/docs/distribution.md) (the release: a bundle per platform with every executable, a manifest and SHA-256 sums; verifying and pinning it).
Licence: every form is free and needs no key; only collaboration does (see [licence](#licence)).

## The path a customer takes

1. **Embed** Note in the web app with its own `StorageProvider` (files on its server).
2. **Agent**: the customer's agent edits the same files with `kition-kits-mcp --workspace <folder>`
   (`note_run`, `note_query`, `note_batch`) and calls `note_check`.
3. The person sees the agent's edits as new versions of the files; the agent reads the person's.

## Versions

- The SDK has one version (`sdk.json` `version`); a bundle records it in `manifest.json` and in
  each package's `kitionSdk` field.
- Each npm package keeps its own semver inside the SDK; each kit package is the version Kition
  pins (`kits/kits.lock.json`) when the bundle is made, with its source commit.
- The contracts have their own versions: KHP 1.0, the Kition kit platform (edition 2026.11), the kit engine contract
  (`kition_kit::CONTRACT_VERSION`), the Kit UI protocol (1.x), the Kit Process Protocol. The SDK's minor
  version moves when one of them gains a feature, its major version when one breaks.

## Licence

Every form is free, open source (Apache-2.0), and needs no licence key, in development and in
production: editors embedded in a web page (`@kition/embed`) and single-user URL embedding,
`@kition/script` scripts, the headless executables on any machine (your servers included), and
`kition-kits-mcp`. Nothing shows a mark or prints a warning.

Only collaboration is paid: running Kition Server yourself (free for companies of up
to 8 people; Business and Enterprise plans are paid) or co-editing on Kition Cloud (hosted by
Kition, billed by usage). See [Co-editing](https://developer.kition.ai/docs/collab.md).

Kition Server's licence (format, claims, verification): [licence format](https://github.com/KitionAI/kition-sdk/blob/main/docs/platform/licence-format.md).
