{"id":27483,"library":"twin-pilot-cli","title":"twin-pilot-cli","description":"twin-pilot-cli v0.2.50 is a CLI tool for running AI-powered software factory pipelines from the terminal. It acts as a thin HTTP client that dispatches commands to the Twin Pilot Command Center for project creation, pipeline scheduling, and human-gate approvals. Pipeline execution is handled by Trigger.dev cloud or a local worker for filesystem access. Requires Node.js 20+. Key differentiators: supports local worker execution for agent tasks that need local filesystem access; CI mode with environment variables; human-gate approval workflow. Alternative to other AI coding agents but focused on structured pipeline orchestration.","status":"active","version":"0.2.50","language":"javascript","source_language":"en","source_url":"https://github.com/twinpilot-app/twinpilot-app","tags":["javascript","twinpilot","twin-pilot","cli","ai","pipeline","factory"],"install":[{"cmd":"npm install twin-pilot-cli","lang":"bash","label":"npm"},{"cmd":"yarn add twin-pilot-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add twin-pilot-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"twin-pilot-cli is a command-line tool, not a library. Use npx or global install.","wrong":"import twinPilot from 'twin-pilot-cli'","symbol":"CLI","correct":"npx twin-pilot-cli <command>"},{"note":"Direct command, not via npm scripts.","wrong":"npm run twin-pilot login","symbol":"login","correct":"twin-pilot login"},{"note":"Use environment variable, not CLI flag.","wrong":"twin-pilot --api-key sk_live_... from-scratch \"...\"","symbol":"API_KEY","correct":"TWINPILOT_API_KEY=sk_live_... twin-pilot from-scratch \"...\""}],"quickstart":{"code":"# Install globally\nnpm install -g twin-pilot-cli\n\n# Authenticate (opens browser)\ntwin-pilot login\n\n# Create a new project from a market signal\ntwin-pilot from-scratch \"Meal planning app for busy parents\"\n\n# Check status\ntwin-pilot status\n\n# View pending human gates\ntwin-pilot pending\n\n# Approve a gate\ntwin-pilot approve <run-id> --comment \"looks good\"\n\n# Non-interactive CI mode (set env vars)\nexport TWINPILOT_API_KEY=sk_live_examplekey\nexport TWINPILOT_TENANT=acme\nexport TWINPILOT_FACTORY=main\ntwin-pilot from-scratch \"Automated bug fix\"","lang":"javascript","description":"Install, authenticate, create a project, and manage human gates. Also shows CI mode with environment variables."},"warnings":[{"fix":"Update Node.js to v20 or later.","message":"Requires Node.js 20+ (engines field). Older Node.js versions will fail.","severity":"gotcha","affected_versions":"<0.2.50"},{"fix":"Check TWINPILOT_COMMAND_CENTER_URL and network connectivity.","message":"CLI is a thin client; most logic runs server-side. If Command Center is down, CLI commands fail.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Rotate keys if leaked, use environment variables in CI.","message":"API key must be factory-scoped; a leaked key can only operate within that factory, but still a security risk.","severity":"gotcha","affected_versions":">=0.2.50"},{"fix":"Use 'twin-pilot' not 'twin-pilot-cli' in terminal.","message":"The 'twin-pilot' binary is used instead of 'twin-pilot-cli'.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'npm install -g twin-pilot-cli'.","cause":"twin-pilot-cli is not installed.","error":"Error: Cannot find module 'twin-pilot-cli'"},{"fix":"Run 'npm install -g twin-pilot-cli' and ensure npm global bin is in PATH.","cause":"Global install not in PATH.","error":"twin-pilot: command not found"},{"fix":"Set TWINPILOT_API_KEY environment variable or run 'twin-pilot login'.","cause":"TWINPILOT_API_KEY not set in non-interactive mode.","error":"Authorization failed: API key missing"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}