{"id":28394,"library":"tirsa-factory-cli","title":"Tirsa Factory CLI","description":"Tirsa Factory CLI (v0.2.19) is a thin HTTP client that dispatches AI-powered software factory pipelines from the terminal. Commands delegate to a remote Command Center for project creation, pipeline scheduling, and human-gate approvals. Pipeline execution runs on Trigger.dev cloud or a local worker for filesystem access. Requires Node.js 20+. Designed for the Tirsa Factory ecosystem (TwinPilot-based), not a general-purpose CLI.","status":"active","version":"0.2.19","language":"javascript","source_language":"en","source_url":"https://github.com/tirsasoftware/tirsa-factory","tags":["javascript","twinpilot","twin-pilot","cli","ai","pipeline","factory"],"install":[{"cmd":"npm install tirsa-factory-cli","lang":"bash","label":"npm"},{"cmd":"yarn add tirsa-factory-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add tirsa-factory-cli","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Requires Node >=20 for execution","package":"node","optional":false}],"imports":[{"note":"This is a CLI tool, not a library. Run via npx or global install.","wrong":"import cli from 'tirsa-factory-cli'","symbol":"cli","correct":"npx tirsa-factory <command>"},{"note":"Authentication is done via login command or env vars, not programmatic API.","wrong":"require('tirsa-factory-cli').setApiKey(...)","symbol":"environment variables","correct":"export TIRSA_API_KEY=sk_live_...; tirsa-factory login"},{"note":"All interactions are CLI commands, not function calls.","wrong":"tirsaFactory.fromScratch('project idea')","symbol":"commands","correct":"tirsa-factory from-scratch \"project idea\""}],"quickstart":{"code":"#!/usr/bin/env bash\n# Install globally\nnpm install -g tirsa-factory-cli\n\n# Login (opens browser)\ntirsa-factory login\n\n# Create a new project from scratch\ntirsa-factory from-scratch \"Meal planning app for busy parents\"\n\n# Check status of projects\ntirsa-factory status\n\n# View pending human gates\ntirsa-factory pending\n\n# Approve a gate (replace <run-id> with actual ID)\ntirsa-factory approve <run-id> --comment \"looks good\"\n\n# Or use env vars for CI\nTIRSA_API_KEY=sk_live_example TIRSA_TENANT=acme TIRSA_FACTORY=main tirsa-factory status","lang":"javascript","description":"Shows installation, browser-based login, creating a project from scratch, checking status, and approving a gate, plus CI env var usage."},"warnings":[{"fix":"Upgrade Node.js to version 20 or higher.","message":"Requires Node.js >=20. Older versions will not run.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Ensure network connectivity to Command Center URL (default: https://tirsa-factory.vercel.app).","message":"CLI is a thin client; most logic runs server-side. Offline or network issues will break all commands except 'doctor'.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Store keys securely, rotate regularly, use env vars in CI, never commit to source control.","message":"API keys are factory-scoped. Leaked keys can only operate within that factory, but still sensitive.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Pin version in CI to avoid unexpected breaking changes.","message":"No breaking changes deprecated yet in v0.2.x. Watch for future semver bumps.","severity":"deprecated","affected_versions":"<0.3.0"},{"fix":"Use TIRSA_API_KEY, TIRSA_TENANT, TIRSA_FACTORY env vars instead of interactive login.","message":"The 'login' command opens a browser; headless CI environments require env var authentication.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Install globally with 'npm install -g tirsa-factory-cli' or use npx: 'npx tirsa-factory-cli login'","cause":"Package not installed or not found in PATH when using global install.","error":"Error: Cannot find module 'tirsa-factory-cli'"},{"fix":"Upgrade Node.js to v20 or later (e.g., via nvm: 'nvm install 20')","cause":"Using an older Node.js version.","error":"Error: Node.js version must be >=20. Current version is 18.x.x"},{"fix":"Run 'tirsa-factory login' interactively, or set TIRSA_API_KEY, TIRSA_TENANT, TIRSA_FACTORY environment variables.","cause":"Not logged in and no env vars set.","error":"Error: Authentication failed. No valid profile or API key found."},{"fix":"Ensure network access and correct URL. Optionally override via TIRSA_COMMAND_CENTER_URL env var.","cause":"Network unreachable or wrong URL (default https://tirsa-factory.vercel.app).","error":"Error: Cannot find Command Center at <url>. Check network or TIRSA_COMMAND_CENTER_URL"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}