TOON cuts ~65% off every reply
Compact field aliases, enum codes, and bare values mean a 400-token JSON ticket lands in your context as ~120 TOON tokens.
v1.0 · MIT · self-hosted
Local ticketing your LLM agents can swarm against.
Orkestra is a single ~20 MB Docker container that exposes 13 MCP tools and replies in TOON — a compact format that cuts ~65% off every response. No cloud. No rate limits. No per-request bill.
- 13MCP tools
- ~65%fewer tokens
- ~20 MBcontainer
- 0cloud calls
PROJECT_ID=myapp go run ./cmd/serversqlite WAL ready · /data/orkestra.dbmcp listener on :8080 · 13 tools registeredTOON/1 · backups every 1h
Why TOON wins on tokens
Edit the JSON on the left. The right side is what your agent actually sees in its context window. The badge in the middle is the savings.
−46%
TOON format uses approximately 46% fewer tokens than JSONTOON/1 T{id:myapp-001,t:"Fix auth bug",s:ip,p:h,typ:bug,lbl:[auth,security],ca:2024-01-15,ua:2024-01-15T10:00:00Z}Designed for autonomous agents
Purpose-built primitives for agentic workflows.
Your tickets never leave the box
A single ~20 MB Docker image. SQLite WAL. No telemetry, no phone-home, no cloud sync. The only network surface is the MCP HTTP listener.
Atomic claim, etag locking, sequential gates
Built so a swarm of agents can chew through a backlog without stepping on each other. No leader election, no leases — just one CAS.
Built for swarms, not single agents
Spawn an epic. Drop child tickets. Watch a fleet of agents pick them up in parallel —
ticket_claim is an atomic CAS, so no two agents ever grab the same ticket.
ticket_claim is atomic — no two agents grab the same one.Skim the surface area
Filter by category, search by keyword, click any card to expand its full schema.
Same data your agent sees on /skill.
Create a new ticket. Always lands in backlog (s=bk).
Parameters
Name Type Default Notes title*string — Non-empty typeenum tsk bug · ft · tsk · ep · chr priorityenum m cr · h · m · l descriptionstring — labelsstring[] [] parent_idstring — Parent ticket ID exec_modeenum par par · seq exec_orderinteger — Required for seq children; UNIQUE(parent_id, exec_order) Returns
T{...}Example
TOON/1 T{id:myapp-011,t:Fix login bug,s:bk,p:h,typ:bug,ca:2024-01-15,ua:2024-01-15T10:00:00Z}Fetch a single ticket with full relations (comments, links, child IDs).
Parameters
Name Type Default Notes id*string — Returns
T{...} including cmt, lnk, ch arraysErrors
not_foundAtomically take ownership. Moves bk/td/bl → ip.
Parameters
Name Type Default Notes id*string — Returns
T{s:ip,...} — save ua as your etagErrors
conflictseq_blockednot_foundUpdate any field. Always supply etag when working with concurrent agents.
Parameters
Name Type Default Notes id*string — etagstring — ua from last read; stale → conflict titlestring — statusenum — bk · td · ip · dn · bl · cl priorityenum — typeenum — descriptionstring — assigneestring — labelsstring[] — Replaces entire array exec_modeenum — exec_orderinteger — Returns
T{...}Errors
conflictnot_foundinvalidSoft-delete. Sets archived_at. Excluded from all queries.
Parameters
Name Type Default Notes id*string — Returns
{ok:true}Filter tickets across any combination of fields. Ordered by created_at DESC.
Parameters
Name Type Default Notes statusenum — priorityenum — typeenum — labelsstring[] — AND filter limitinteger 50 max 200 include_archivedboolean false Returns
[T{...}]Priority-ordered view of bk tickets. Use this to decide what to do next.
Parameters
Name Type Default Notes priorityenum — typeenum — labelsstring[] — limitinteger 50 Returns
[T{...}] ordered cr → h → m → l, oldest-first within priorityKanban snapshot grouped by status.
Parameters
Name Type Default Notes typeenum — labelsstring[] — Returns
BOARD{bk:[...],td:[...],ip:[...],dn:[...],bl:[...],cl:[...]}Full-text search across title, description, labels via SQLite FTS5.
Parameters
Name Type Default Notes query*string — FTS5-ranked; supports phrase search include_archivedboolean false Returns
[T{...}] ranked by relevanceList children of a ticket, sorted by exec_order.
Parameters
Name Type Default Notes id*string — recursiveboolean false depthinteger 3 1-10; only when recursive=true Returns
[T{...}]Mermaid flowchart of ticket hierarchy with status colors.
Parameters
Name Type Default Notes id*string — Root of the diagram depthinteger 3 1-10 Returns
Mermaid flowchart TDAppend a note to a ticket.
Parameters
Name Type Default Notes id*string — body*string — authorstring llm Returns
Updated T{...} with new entry in cmtCreate a directional relationship between two tickets.
Parameters
Name Type Default Notes from_id*string — to_id*string — link_type*enum — blk · rel · dup Returns
{ok:true} (idempotent)
Install in minutes
Auto-detects Claude Code, Cursor, Copilot, Windsurf, and Zed.
30-second install
Pick your setup. They all land at the same place: a local MCP endpoint your agent talks to.
git clone https://github.com/Vijay431/Orkestra cd Orkestra PROJECT_ID=myapp ./install.sh
Detects Claude Code · Cursor · Copilot · Windsurf · Zed · Continue.dev and wires up the MCP entry for you.
PROJECT_ID=myapp docker compose up -d curl http://localhost:8080/health
Single ~20 MB scratch image. SQLite lives in a named volume; survives compose down (but not down -v).
PROJECT_ID=dev DB_PATH=/tmp/dev.db go run ./cmd/server
Go 1.22+. Pure-Go SQLite (modernc.org/sqlite) — no CGO needed.
claude mcp add orkestra-myapp \ --transport http http://localhost:8080/sse
After the server is up, register it as an MCP endpoint.
Stop paying per ticket.
Orkestra runs offline, on your hardware, with the same MCP surface as the cloud alternatives. MIT-licensed. Fork it, ship it.