Registry / devops / tirsa-factory-cli

tirsa-factory-cli

library0.2.19jsnpmunverified

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.

devops http-networking workflow

npm install tirsa-factory-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · TIRSA-FACTORY-CLI

tirsa-factory-cli

devopsjavascriptv0.2.19

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 tirsa-factory <command>

✗ import cli from 'tirsa-factory-cli'

This is a CLI tool, not a library. Run via npx or global install.

environment variables

✓ export TIRSA_API_KEY=sk_live_...; tirsa-factory login

✗ require('tirsa-factory-cli').setApiKey(...)

Authentication is done via login command or env vars, not programmatic API.

commands

✓ tirsa-factory from-scratch "project idea"

✗ tirsaFactory.fromScratch('project idea')

All interactions are CLI commands, not function calls.

Shows installation, browser-based login, creating a project from scratch, checking status, and approving a gate, plus CI env var usage.

#!/usr/bin/env bash # Install globally npm install -g tirsa-factory-cli # Login (opens browser) tirsa-factory login # Create a new project from scratch tirsa-factory from-scratch "Meal planning app for busy parents" # Check status of projects tirsa-factory status # View pending human gates tirsa-factory pending # Approve a gate (replace <run-id> with actual ID) tirsa-factory approve <run-id> --comment "looks good" # Or use env vars for CI TIRSA_API_KEY=sk_live_example TIRSA_TENANT=acme TIRSA_FACTORY=main tirsa-factory status

tirsa --version

Debug

Known issues

breakingRequires Node.js >=20. Older versions will not run.

fix

Upgrade Node.js to version 20 or higher.

affects: >=0.0.0

gotchaCLI is a thin client; most logic runs server-side. Offline or network issues will break all commands except 'doctor'.

fix

Ensure network connectivity to Command Center URL (default: https://tirsa-factory.vercel.app).

affects: >=0.0.0

gotchaAPI keys are factory-scoped. Leaked keys can only operate within that factory, but still sensitive.

fix

Store keys securely, rotate regularly, use env vars in CI, never commit to source control.

affects: >=0.0.0

deprecatedNo breaking changes deprecated yet in v0.2.x. Watch for future semver bumps.

fix

Pin version in CI to avoid unexpected breaking changes.

affects: <0.3.0

gotchaThe 'login' command opens a browser; headless CI environments require env var authentication.

fix

Use TIRSA_API_KEY, TIRSA_TENANT, TIRSA_FACTORY env vars instead of interactive login.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'tirsa-factory-cli'

Package not installed or not found in PATH when using global install.

fix

Install globally with 'npm install -g tirsa-factory-cli' or use npx: 'npx tirsa-factory-cli login'

Error: Node.js version must be >=20. Current version is 18.x.x

Using an older Node.js version.

fix

Upgrade Node.js to v20 or later (e.g., via nvm: 'nvm install 20')

Error: Authentication failed. No valid profile or API key found.

Not logged in and no env vars set.

fix

Run 'tirsa-factory login' interactively, or set TIRSA_API_KEY, TIRSA_TENANT, TIRSA_FACTORY environment variables.

Error: Cannot find Command Center at <url>. Check network or TIRSA_COMMAND_CENTER_URL

Network unreachable or wrong URL (default https://tirsa-factory.vercel.app).

fix

Ensure network access and correct URL. Optionally override via TIRSA_COMMAND_CENTER_URL env var.

Upgrade

Version history

0.2.19latest on npm

Audit

Dependencies

noderequiredRequires Node >=20 for execution

Agent activity

30 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/tirsasoftware/tirsa-factory ↗

packagehttps://www.npmjs.com/package/tirsa-factory-cli ↗

homepagehttps://tirsa.ai ↗