{
"markdown": "# tycono\n\n**Your company, in code.**\n\nDefine your org. Give one order. Your AI team plans, builds, and learns — and they remember everything next time.\n\nTerminal-native. Local-first. Open source.\n\n
\n \n \n
\n\n
\n \n
\n\n---\n\n## Install\n\nTycono runs as a [Claude Code](https://claude.ai/download) plugin. Inside Claude Code:\n\n```\n/plugin marketplace add seongsu-kang/tycono\n/plugin install tycono@seongsu-kang-tycono\n```\n\nThat's it. The first `/tycono` command auto-downloads `tycono-server` into your plugin data directory — no manual `npm install`, no extra config.\n\n```\n/plugin update tycono # update later\n/tycono:version # check installed versions\n```\n\n---\n\n## First Wave\n\n```\nYou: /tycono \"Build a tower defense game\"\n\nCEO → Breaks it down, dispatches CTO\nCTO → Plans architecture, dispatches Engineer\nEngineer → Writes code\nQA → Reviews and tests\nCEO → Approves final result\n```\n\nWatch the team work in real time at `http://localhost:8765/ui` (browser dashboard) or with `/tycono:tycono-status`.\n\n---\n\n## Company-as-Code\n\nTerraform turns `.tf` files into running infrastructure.\nTycono turns YAML and Markdown into a running company.\n\n```yaml\n# roles/engineer/role.yaml\nid: engineer\nname: \"Alex\"\nlevel: member\nreports_to: cto\nmodel: claude-opus-4-7\neffort: medium\n\nauthority:\n autonomous: [\"Code implementation\", \"Bug fixes\"]\n requires_approval: [\"Architecture changes\"]\n\nknowledge_scope:\n readable: [\"projects/\", \"architecture/\"]\n writable: [\"projects/*/technical/\"]\n```\n\nOne file defines who the agent is, what they can do, what they know, and who they report to.\n\n- **One order, whole org moves.** You tell the CEO what you want. The hierarchy handles the rest.\n- **Authority is enforced.** Engineers can't make architecture decisions. PMs can't merge code.\n- **Knowledge compounds.** Every session reads what came before and writes back what it learned.\n\n---\n\n## Agencies\n\nPre-built team configurations — pick one or design your own.\n\n```\n/tycono --agency gamedev \"Build a browser game\"\n/tycono --agency startup-mvp \"Build an MVP\"\n/tycono --agency solo-founder \"Research and plan my next product\"\n```\n\nNeed a custom team for *your* project?\n\n```\n/tycono:agency-create\n```\n\nWalks you through scanning your project, suggesting roles, auto-generating role files, and verifying the team works — all in one guided flow.\n\nBrowse the marketplace at [tycono.ai/agencies](https://tycono.ai/agencies).\n\n---\n\n## Commands\n\n```\n/tycono \"\" Start a wave\n/tycono:tycono-status Check current wave progress\n/tycono:tycono-cancel Cancel active wave\n/tycono:board View task board for active wave\n/tycono:report Generate wave report (markdown)\n/tycono:analysis Wave cost + token breakdown by role\n/tycono:benchmark Compare wave performance\n/tycono:version Show plugin/server versions\n/tycono:help Full reference\n/tycono:agency-create Build a custom agency for your project\n/tycono:agency-install Install agency from marketplace\n/tycono:agency-list List installed agencies\n/tycono:agency-publish Publish to tycono.ai marketplace\n```\n\n---\n\n## Features\n\n| Feature | What it does |\n|---------|-------------|\n| **Wave Dispatch** | One order cascades through the entire org hierarchy. |\n| **Auto-Amend** | Follow-up work continues in the same session — major cost reduction. |\n| **Handoff Summary** | Re-dispatched roles get previous session context automatically. |\n| **Prompt Caching** | Static system prompt sections cached — up to 90% input cost reduction. |\n| **Critic Role** | Built-in Devil's Advocate that challenges team conclusions. |\n| **Memory System** | Pre/During/Post-K. Each wave reads relevant memory, writes new insights, persists across sessions. |\n| **Workflow Visibility** | Browser dashboard (`/ui`) — live org tree, dispatch flow, per-role streams. |\n| **Role-Level Effort** | `effort: low/medium/high` per role — match cognition budget to task. |\n| **AKB** | File-based knowledge system. Search-driven. Compounds over time. |\n| **Heartbeat Watch** | Real-time supervision. Redirect mid-execution if direction drifts. |\n\n---\n\n## Real-World Results\n\nA crypto trading research team ran **13.5 hours of autonomous AI work** — zero human intervention:\n\n| Metric | Value |\n|--------|-------|\n| Duration | 13.5 hours |\n| Agent sessions | 174 |\n| Hypotheses tested | 29 |\n| Cost | $54 total ($2.5/hypothesis) |\n| Critic role | Caught a false-positive before production |\n\n**Cost trajectory across versions:**\n\n| Version | Cost per wave |\n|---------|--------------|\n| Early beta (0.1.0-beta.8) | $1,342 |\n| 0.2.0 | $19 |\n| **0.2.16 (current)** | **$4** |\n\nAuto-Amend + Handoff + Prompt Caching = 67–79% cost reduction per wave on identical workloads.\n\n---\n\n## Surfaces\n\n| Surface | Status | What |\n|---------|--------|------|\n| **Plugin** | ✅ Primary | Claude Code plugin. Recommended entry point. |\n| **Server** | ✅ Backbone | `tycono-server` headless API. All surfaces consume this. |\n| **TUI** | 🟡 Maintenance | Standalone terminal UI — `npx tycono`. |\n| **Pixel** | ❄️ Frozen | Isometric pixel office. Demo-only. |\n\n### Pixel (Frozen)\n\nWatch your AI team walk around and collaborate in an isometric office. Not actively developed — kept for demos. See [tycono.ai](https://tycono.ai) for a preview.\n\n
![\"server](\"https://img.shields.io/npm/v/tycono-server.svg?label=server\")
\n ![\"license\"](\"https://img.shields.io/github/license/seongsu-kang/tycono.svg\")
\n![\"Tycono](\".github/assets/wave-center.png\")
\n![\"Pixel](\".github/assets/hero-office.png\")
\n