tycono
Your company, in code.
Define your org. Give one order. Your AI team plans, builds, and learns — and they remember everything next time.
Terminal-native. Local-first. Open source.
Quick Start
Claude Code Plugin (Recommended)
claude plugin install tycono
You: /tycono "Build a landing page for my SaaS"
CEO → Breaks it down, dispatches CTO
CTO → Plans architecture, dispatches Engineer
Engineer → Writes code
QA → Reviews and tests
CEO → Approves final result
Terminal (TUI)
npx tycono
A setup wizard walks you through naming your company, picking a team, and starting your first wave.
Company-as-Code
Terraform turns .tf files into running infrastructure.
Tycono turns YAML and Markdown into a running company.
# roles/engineer/role.yaml
id: engineer
name: "Alex"
level: member
reports_to: cto
model: claude-sonnet-4
authority:
autonomous: ["Code implementation", "Bug fixes"]
requires_approval: ["Architecture changes"]
knowledge_scope:
readable: ["projects/", "architecture/"]
writable: ["projects/*/technical/"]
One file defines who the agent is, what they can do, what they know, and who they report to.
- One order, whole org moves. You tell the CEO what you want. The hierarchy handles the rest.
- Authority is enforced. Engineers can't make architecture decisions. PMs can't merge code.
- Knowledge compounds. Every session reads what came before and writes back what it learned.
How It Works
1. Install claude plugin install tycono
2. Build team Guided setup wizard — or pick an agency preset
3. Give order "Build a tower defense game"
4. Watch CEO dispatches CTO → Engineer → QA, in real time
5. Learn Knowledge persists. Next wave starts smarter.
Real-World Results
A crypto trading research team ran 13.5 hours of autonomous AI work — zero human intervention:
| Metric | Value |
|---|
| Duration | 13.5 hours |
| Agent sessions | 174 |
| Hypotheses tested | 29 |
| Cost | $54 total ($2.5/hypothesis) |
| Critic role | Caught a false-positive before production |
Cost trajectory: $1,342/wave (early beta) → $4/wave (current).
Features
| Feature | What it does |
|---|
| Wave Dispatch | One order cascades through the entire org hierarchy |
| Auto-Amend | Follow-up work continues in the same session — 70% cost reduction |
| Handoff Summary | Re-dispatched roles get previous session context automatically |
| Prompt Caching | Static system prompt sections cached — up to 90% input cost reduction |
| Critic Role | Built-in Devil's Advocate that challenges team conclusions |
| AKB | File-based knowledge system. Pre-K reads, Post-K writes. Compounds over time. |
| Heartbeat Watch | Real-time supervision. Redirect mid-execution if direction drifts. |
Surfaces
| Surface | Status | What |
|---|
| Plugin | ✅ Active | Claude Code plugin. Primary entry point. |
| TUI | ✅ Active | Terminal dashboard — org tree, agent streams, wave management. |
| Server | ✅ Active | Headless API backend. All surfaces consume this. |
| Pixel | ❄️ Frozen | Isometric pixel office UI. Kept for demos. |
Plugin
claude plugin install tycono
/tycono "Build a landing page"
/tycono --agency gamedev "Build a tower defense"
TUI
npx tycono
┌── W1 Build the API ──────┬── Stream ──────────────────────────┐
│ 3 sessions │ cto → dispatch engineer │
│ ── Org Tree ── │ engineer → Write src/api/routes.ts│
│ ● CEO │ qa ▶ Running test suite... │
│ ├─ ● CTO │ │
│ │ ├─ ● engineer │ │
│ │ └─ ● qa │ │
│ └─ ○ CBO │ │
└───────────────────────────┴─────────────────────────────────────┘
Pixel (Frozen)
Isometric pixel office — watch your AI team walk around and collaborate visually.
Not actively developed. See tycono.ai for a preview.
Agencies
Pre-built team configurations for common workflows.
