tycono

Build an AI company. Watch them work.
_{Infrastructure-as-Code defined servers. Company-as-Code defines organizations.}

Website · Quick Start · How It Works · Company-as-Code · Contributing

tycono is an open-source platform that lets you define and run an AI-powered organization. Roles, authority, knowledge, and workflows — all defined in files, executed by AI agents, visualized in real time.

One command. Your AI company is running.

npx tycono

Core Pillars

1. CEO Supervisor — Org-chart orchestration

You give one order. The system dispatches through a real hierarchy.

dispatch → watch → relay → quality gate → re-dispatch (if needed)

CEO delegates to C-levels, C-levels dispatch to their teams. Authority is enforced — engineers can't make CEO decisions, PMs can't merge code. The org chart isn't decoration, it's the execution engine.

2. Observability — See everything, intervene anytime

Your AI team isn't a black box. Watch every agent work in real time, inject directives mid-execution, and drill down to any level.

• Wave Center — Org-tree dispatch with real-time streaming
• Activity Stream — Every event logged (dispatches, tool calls, decisions)
• CEO Directive — Change direction while agents are running
• Cost Tracking — Per-role, per-model token breakdown

3. Isolation Infrastructure — Agents don't collide

Multiple agents working simultaneously without stepping on each other.

4. AKB (Pre-K / Post-K) — Knowledge that compounds

Every AI tool today: Plan → Execute → Done. Knowledge resets. Tycono adds what the industry doesn't have:

Pre-K:  Read existing knowledge → Plan grounded in what the company knows
Execute: Do the work
Post-K: Extract insights → Cross-link → Register in knowledge graph

Session 50 is dramatically smarter than session 1. Your company learns.

Why Tycono?

Coding agents simulate one developer. Tycono simulates the entire company.

Company-as-Code

Just as Terraform turns .tf files into running infrastructure, Tycono turns YAML and Markdown into a running company.

IaC                          CaC (Company-as-Code)
─────────────────────        ─────────────────────
.tf         → servers        role.yaml   → org structure
playbook    → config         CLAUDE.md   → operating rules
Dockerfile  → containers     skills/     → capabilities
state file  → infra state    knowledge/  → org memory

Your company is versionable, reproducible, and forkable — just like code.

Quick Start

mkdir my-company && cd my-company
npx tycono

A setup wizard guides you through:

1. Pick an AI engine — Claude API, Claude Max, or auto-detect
2. Name your company — set mission and domain
3. Choose a team template — or build from scratch
4. Watch them work — your browser opens to a live dashboard

Requirements

• Node.js >= 18
• Anthropic API key or Claude Max subscription

Interfaces

Web Dashboard — Visual management

A browser-based dashboard for visual management. Org tree, Wave dispatch, Knowledge graph, Activity stream.

• Wave Center — selective org-tree dispatch with target checkboxes
• Chats — 1:1 conversations with any role, persistent sessions
• Knowledge Base — graph/tree/list views, cross-linked documents
• Decisions — CEO strategic decision log with full context

TUI — Terminal-native operations (coming soon)

For developers who live in the terminal. A k9s/lazygit-style multi-panel TUI built with Ink.

┌──────────────────────────────────────────────────┐
│ TYCONO v0.2  │ Wave #37 running │ 3 active │$2.1│
├──────────────┬───────────────────────────────────┤
│ [Org Tree]   │ [Real-time Stream]                │
│  CEO         │  CTO: "Reviewing architecture..." │
│  ├ CTO ●     │    → dispatch → Engineer          │
│  │ ├ ENG ○   │  CBO: "Market analysis done" ✓    │
│  │ └ QA  ○   │                                   │
│  └ CBO ●     │                                   │
├──────────────┴───────────────────────────────────┤
│ > wave "Write the Q1 strategy report"            │
└──────────────────────────────────────────────────┘

npx tycono --tui     # Terminal mode (coming soon)
npx tycono           # Web dashboard (current)

Same API server, same engine — just a different frontend. Use what fits your workflow.

Key Features

CEO Wave — One order moves the company

Write a directive. Select target roles on the org tree. Hit dispatch. Every selected agent receives their piece of the work, filtered through the hierarchy.

Living Knowledge (AKB)

Every task produces knowledge. Cross-linked Markdown documents that grow with every session. Search, navigate, never lose context. Session 50 is dramatically smarter than session 1.

Role-Based Authority

Each role has scoped authority defined in role.yaml. Engineers can't make CEO decisions. PMs can't merge code. The org chart isn't decoration — it's enforcement.

Local-First, BYOK

Everything runs on your machine. Your data never leaves. Bring your own Anthropic API key — no middleman, no telemetry, no tracking.

How It Works

You (CEO)
  └── Give a directive via Wave or direct chat
        └── Context Engine routes to the right Role
              └── Role reads its knowledge + skills, executes within authority
                    └── Knowledge updates, results flow back up
                          └── Your company gets smarter

Every role has:

• role.yaml — Identity, authority, knowledge scope, reporting structure
• SKILL.md — Tools, commands, and capability guides
• profile.md — Public-facing description and persona
• journal/ — Work history and learnings

Your Company Structure

your-company/
├── CLAUDE.md           ← AI operating rules (auto-managed)
├── company/            ← Mission, vision, values
├── roles/              ← AI role definitions (role.yaml + skills)
├── projects/           ← Product specs, PRDs, and tasks
├── architecture/       ← Technical decisions and designs
├── operations/         ← Standups, decisions, wave history
├── knowledge/          ← Domain knowledge (compounds over time)
└── .tycono/            ← Config and preferences

Team Templates

CLI Usage

npx tycono              # Start server + web dashboard
npx tycono --tui        # Terminal UI (coming soon)
npx tycono --help       # Show help
npx tycono --version    # Show version

Environment Variables

Roadmap

• Web dashboard (Office + Pro views)
• CEO Wave dispatch with org-tree targeting
• AKB — Pre-K / Post-K knowledge loop
• Port Registry for multi-agent isolation
• TUI mode — terminal-native multi-panel interface
• Git worktree isolation per agent session
• Desktop app (.dmg / .exe) — background execution, system notifications
• Multi-LLM support (OpenAI, local models)

Built with Tycono

This isn't a demo. Tycono's own landing page, documentation, and knowledge base were built by AI agents running inside Tycono. The PM wrote the PRD. The CTO reviewed architecture. The Designer created UX specs. The Engineer implemented every section.

194 knowledge documents. 12 CEO decisions. 8 active roles. All managed through the same system you're about to use.

Development

git clone https://github.com/seongsu-kang/tycono.git
cd tycono
npm install
cd src/api && npm install && cd ../..
cd src/web && npm install && cd ../..

# Dev mode (hot reload)
npm run dev

# Type check
npm run typecheck

Contributing

See CONTRIBUTING.md for guidelines.

Get Help

• GitHub Issues — Bug reports and feature requests
• GitHub Discussions — Questions and ideas

License

MIT

_{Built with Tycono. An AI company that builds itself.}