CLI

kimo

The Kimo command line. It works offline, needs no account, and runs with Bun:

1 min read

·

Kimo 1.0 · format 1.0

bunx kimo --help                    # from the repository (workspace bin)
bun packages/cli/src/main.ts --help # the same, without the bin link

Command	What it does	Exit codes
`kimo merge <base> <ours> <theirs> [path]`	Semantic three-way merge of `.kimo` files; the git merge driver	0 clean · 1 conflicts stored · 2 not mergeable
`kimo gc <file> [--yes]`	Removes asset files nothing references	0 ok · 2 unreadable · 3 locked
`kimo validate <file…>`	Schema, references, cycles and lints	0 valid · 1 errors · 2 unreadable
`kimo mcp [--attach\|--headless]`	MCP server for coding agents on stdio	0 when the agent host disconnects
`kimo mcp install\|remove\|status`	The `kimo` entry in agent host configs	0 ok · 1 a config was refused (unparsable) or kept changing

kimo merge <base> <ours> <theirs> [path]

What it does Semantic three-way merge of .kimo files; the git merge driver

Exit codes 0 clean · 1 conflicts stored · 2 not mergeable

kimo gc <file> [--yes]

What it does Removes asset files nothing references

Exit codes 0 ok · 2 unreadable · 3 locked

kimo validate <file…>

What it does Schema, references, cycles and lints

Exit codes 0 valid · 1 errors · 2 unreadable

kimo mcp [--attach|--headless]

What it does MCP server for coding agents on stdio

Exit codes 0 when the agent host disconnects

kimo mcp install|remove|status

What it does The kimo entry in agent host configs

Exit codes 0 ok · 1 a config was refused (unparsable) or kept changing

Malformed command lines exit with 64.