@arpanstacy/stacy
v2026.505.1
Published
Stacy CLI — setup, diagnose, and run a trust-first AI control plane
Maintainers
Readme
Stacy
Stacy is a trust-first control plane for assigning, supervising, and auditing AI agents.
It is built for operators who need more than a chat box: every agent has an owner, a budget, a workspace, a run history, logs, approvals, and a visible stop button. The first product promise is simple: you should know what each agent is doing, what it changed, what it cost, and whether it touched anything risky.

Quick Start
Run Stacy from npm:
npx stacy-cli@latest onboard --yes
npx stacy-cli@latest runThe npm package is stacy-cli; it exposes the stacy command when installed.
Inside a cloned repository, use the workspace shortcut:
pnpm stacy onboard --yes
pnpm stacy runStacy starts the local UI and API at http://localhost:3100.
When a user creates a Codex or Claude agent, Stacy verifies that user's own local CLI login on that machine. Stacy does not ship with shared Codex or Claude credentials, and it does not require operators to hand Stacy a central provider account.
What You Get
- Company dashboard for agents, tasks, runs, approvals, spend, and risk
- Agents with roles, budgets, permissions, and adapter configuration
- Projects connected to local repos and workspaces
- Issues and tasks with parent-child structure
- One-click assignment to Codex, Claude, and other local adapters
- Live run timeline with logs, status, retries, and cancellation
- Cost tracking per agent, task, project, and run
- Approval gates before risky actions
- Git worktree isolation per task
- Secrets redaction and local sandbox defaults
- Backup, restore, upgrade, and Docker self-hosting guides
Core Workflow
- Create a company.
- Connect a project or workspace.
- Connect the user's local Codex or Claude account, then add an agent with budgets and permissions.
- Assign a task.
- Watch the live run, inspect logs, and cancel when needed.
- Review cost, risk, and output before marking the task done.
The product should feel like Linear plus GitHub Actions plus an agent runtime console. Stacy keeps autonomy visible, interruptible, and auditable.
Local Development
Prerequisites: Node.js 20+ and pnpm 9+.
pnpm install
pnpm devUseful local commands:
pnpm stacy onboard --yes
pnpm stacy doctor --repair --yes
pnpm stacy db:backup
pnpm stacy upgrade:checkDocumentation
License
Stacy is released under the MIT license. See LICENSE.
