twin-pilot-cli

Twin Pilot CLI — run AI-powered software factory pipelines straight from your terminal. The CLI is a thin HTTP client: commands dispatch to Command Center, which handles project creation, pipeline scheduling and human-gate approvals server-side. Pipeline execution runs wherever your factory is deployed — Trigger.dev cloud or a local worker you run yourself (for agents that need to read and write to your local filesystem using your own coding-CLI subscriptions).

Website · Docs · Source

Install

npm install -g twin-pilot-cli

Requires Node.js 20 or newer.

Quick start

# 1. Authenticate — opens a browser to pick a workspace & factory.
twin-pilot login

# 2. Start a brand-new project from a market signal.
twin-pilot from-scratch "Meal planning app for busy parents"

# 3. Track progress and human gates.
twin-pilot status
twin-pilot pending
twin-pilot approve <run-id> --comment "looks good"

Commands

| Command | Description | |---|---| | twin-pilot login | Browser-based login. Adds a profile keyed by <tenant>/<factory>. | | twin-pilot logout | Remove the active profile. | | twin-pilot whoami | Show the currently active profile. | | twin-pilot profiles | List every saved profile. | | twin-pilot use <name> | Switch the active profile. | | twin-pilot from-scratch "…" | Create a new project and dispatch the full pipeline. | | twin-pilot continue <slug> | Resume a paused project. | | twin-pilot evolve <slug> … | Run a shorter sustentation cycle (fix / feature / improvement). | | twin-pilot stop <slug> | Pause a running project after its current step. | | twin-pilot status [slug] | List projects, or show detail + agent runs. | | twin-pilot pending | Every human gate waiting for approval across your factory. | | twin-pilot approve <run-id> | Approve a pending gate (optional --comment / --instructions). | | twin-pilot reject <run-id> | Reject a pending gate (optional --comment). | | twin-pilot clean <slug> | Delete a project and all its events, runs and artifacts. | | twin-pilot doctor | Check local prerequisites (Node, Claude Code, Aider, Codex…). |

CI / non-interactive mode

Set these environment variables in your CI runner — the CLI skips the saved profile and uses them directly:

TWINPILOT_API_KEY=sk_live_…          # generate at /api-keys in the Command Center
TWINPILOT_TENANT=acme                # your workspace slug
TWINPILOT_FACTORY=main               # the factory slug to operate on
TWINPILOT_COMMAND_CENTER_URL=https://twinpilot.app   # optional override

A factory-scoped API key limits the blast radius — a leaked key can only operate within that factory.

License

UNLICENSED — Tirsa Software. Contact Tirsa Software for usage terms.