twin-pilot-cli

library0.2.50jsnpmunverified

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.

llm-agents ai-ml devops workflow

npm install twin-pilot-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · TWIN-PILOT-CLI

twin-pilot-cli

llm-agentsjavascriptv0.2.50

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

CLI

✓ npx twin-pilot-cli <command>

✗ import twinPilot from 'twin-pilot-cli'

twin-pilot-cli is a command-line tool, not a library. Use npx or global install.

✓ twin-pilot login

✗ npm run twin-pilot login

Direct command, not via npm scripts.

API_KEY

✓ TWINPILOT_API_KEY=sk_live_... twin-pilot from-scratch "..."

✗ twin-pilot --api-key sk_live_... from-scratch "..."

Use environment variable, not CLI flag.

Install, authenticate, create a project, and manage human gates. Also shows CI mode with environment variables.

# Install globally npm install -g twin-pilot-cli # Authenticate (opens browser) twin-pilot login # Create a new project from a market signal twin-pilot from-scratch "Meal planning app for busy parents" # Check status twin-pilot status # View pending human gates twin-pilot pending # Approve a gate twin-pilot approve <run-id> --comment "looks good" # Non-interactive CI mode (set env vars) export TWINPILOT_API_KEY=sk_live_examplekey export TWINPILOT_TENANT=acme export TWINPILOT_FACTORY=main twin-pilot from-scratch "Automated bug fix"

twin-pilot --version

Debug

Known issues

gotchaRequires Node.js 20+ (engines field). Older Node.js versions will fail.

fix

Update Node.js to v20 or later.

affects: <0.2.50

gotchaCLI is a thin client; most logic runs server-side. If Command Center is down, CLI commands fail.

fix

Check TWINPILOT_COMMAND_CENTER_URL and network connectivity.

affects: >=0.0.0

gotchaAPI key must be factory-scoped; a leaked key can only operate within that factory, but still a security risk.

fix

Rotate keys if leaked, use environment variables in CI.

affects: >=0.2.50

gotchaThe 'twin-pilot' binary is used instead of 'twin-pilot-cli'.

fix

Use 'twin-pilot' not 'twin-pilot-cli' in terminal.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'twin-pilot-cli'

twin-pilot-cli is not installed.

fix

Run 'npm install -g twin-pilot-cli'.

twin-pilot: command not found

Global install not in PATH.

fix

Run 'npm install -g twin-pilot-cli' and ensure npm global bin is in PATH.

Authorization failed: API key missing

TWINPILOT_API_KEY not set in non-interactive mode.

fix

Set TWINPILOT_API_KEY environment variable or run 'twin-pilot login'.

Upgrade

Version history

0.2.50latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

58 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/twinpilot-app/twinpilot-app ↗

packagehttps://www.npmjs.com/package/twin-pilot-cli ↗

homepagehttps://twinpilot.com ↗