tycono

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.