Captain's Cabinet

Captain's Cabinet

An autonomous AI organization that builds, ships, and improves your work — while you steer from Telegram.

What This Is

The Captain's Cabinet is a framework for running a 24/7 AI development organization. You are the Captain. AI Officers own domains (product, engineering, research). They coordinate, execute, learn, and improve — continuously.

This repo is the infrastructure. It contains the organizational framework, memory system, safety boundaries, and Docker configuration. Your product repo is separate — the Cabinet mounts it as a workspace.

⚙ Dashboard modes — the Cabinet dashboard ships with a Consumer view (4 cards, natural-language status) as the default and an Advanced view for debugging and infrastructure config. Most user-facing docs in this repo (provisioning, hook tuning, preset authoring) assume Advanced mode. Toggle via the sidebar.

How It Works

You (Captain)
  ↕ Telegram
Cabinet (this repo)
├── CoS — orchestration, briefings, self-improvement
├── CTO — engineering, code, deploys
├── CPO — product specs, backlog, prioritization
├── CRO — market research, competitive intel, trends
└── COO — operations, deployment validation, uptime
  ↕ reads/writes
Your Product Repo (mounted at /workspace/product)

Each Officer runs as a persistent Claude Code session with Telegram Channels. They read strategy from the Library (Cabinet-native structured knowledge), pick up work from /tasks (Cabinet-native task backlog), write code in your repo, and report back via Telegram. Notion and Linear remain as legacy adapters for teams that prefer them — configured in instance/config/product.yml.

Officer sets are fully configurable per deployment — add, remove, or rename Officers in instance/config/platform.yml. The framework is officer-agnostic.

Quick Start

1. Fork This Repo

Click Fork on https://github.com/nate-step/captains-cabinet, then clone your fork:

git clone https://github.com/YOUR-GITHUB-USERNAME/captains-cabinet.git
cd captains-cabinet

2. Provision the Cabinet (Library + /tasks + state)

The cabinet-bootstrap script provisions a brand-new Cabinet end-to-end: runs the Neon SQL migrations (Library schema, officer_tasks table, Cabinet Memory), seeds the starter Library Spaces (Business Brain, Specs, Research, Decisions, Captain Patterns, Customer Success, Compliance, etc.), and registers the cabinet with its preset.

bash cabinet/scripts/cabinet-bootstrap.sh "YourProductName" --preset work --captain-name "YourName"

Re-runs are idempotent. Then add your strategy docs (vision, brand guidelines, etc.) as records in the Business Brain Space via the /library dashboard route.

Optional: legacy Notion / Linear integration. If your team already lives in Notion or Linear, run bash cabinet/scripts/bootstrap-notion.sh "YourProductName" and/or set the Linear workspace in instance/config/product.yml. Officers will read from those surfaces and migrate content into the Library over time via migrate-notion-to-library.sh and import-linear-to-library.sh.

3. Configure Your Product and Platform

Edit two config files:

• instance/config/product.yml — what you're building: product name, Neon project, voice settings, Telegram bots, optional Notion / Linear IDs if using legacy adapters
• instance/config/platform.yml — how the Cabinet operates: timezone, accountability tone, communication preferences, briefing cadence, officer set (fulltime vs consultant)

4. Set Up Telegram Bots

Create one bot per Officer via @BotFather (default set: CoS, CTO, CPO, CRO, COO — 5 bots) and a "YourProduct HQ" group. You can add or remove Officers later via bash cabinet/scripts/create-officer.sh and cabinet/scripts/suspend-officer.sh.

5. Fill In Credentials

cp cabinet/.env.example cabinet/.env
# Fill in all API keys and tokens

6. Deploy

# On your server (Hetzner/DO/AWS, Ubuntu 24.04)
# Clone into the location you want — we use /opt/cabinet as an example
cd /opt/cabinet/cabinet
docker compose build
docker compose up -d postgres redis
docker compose up -d officers watchdog

7. Start Your First Officer

docker exec -it cabinet-officers bash
./start-officer.sh cos
# Authenticate with claude /login (one-time)
# Pair Telegram bot
# Send: "Read the Constitution and report for duty"

Architecture