@stackbone/cli
v0.6.2
Published
The CLI for [Stackbone](https://stackbone.ai): scaffold, run and deploy agents and workflows written in TypeScript, on Stackbone Cloud or your own infrastructure.
Readme
@stackbone/cli
The CLI for Stackbone: scaffold, run and deploy agents and workflows written in TypeScript, on Stackbone Cloud or your own infrastructure.
Status:
alpha. The contract may break between releases. Pin a version or stay on thelatestdist-tag.
Quick start
Install the CLI once, globally. The same command updates it:
pnpm add -g @stackbone/cli@latest
stackbone login
stackbone init my-workspace
cd my-workspace
stackbone devThat's it. init scaffolds a new workspace shell (agents + workflows + coding-agent skills), installs its dependencies with pnpm install and links it to your organization, so you sign in first; dev boots the whole workspace locally (Postgres, Redis, MinIO and Stackbone Studio at http://localhost:4242) so you can iterate before you deploy.
Commands
| Command | What it does |
| ----------------------------- | --------------------------------------------------------------------- |
| stackbone init [name] | Scaffold a new workspace shell and link it to your org (needs login). |
| stackbone add <kind> <name> | Add an agent / workflow / workflow-agent to the workspace (offline). |
| stackbone dev | Boot the whole workspace locally + Stackbone Studio. |
| stackbone workflows <verb> | List, inspect the schema of, or start the install's workflows. |
| stackbone build | Compile the workspace into the bundle your container image bakes in. |
| stackbone login / logout | Authenticate the CLI via the device-code flow (RFC 8628). |
| stackbone whoami | Show the active user and organization. |
| stackbone current | Print the organization currently linked to this session. |
| stackbone link | Link the current directory to an existing organization + agent. |
| stackbone list | List organizations the current user owns. |
| stackbone metadata | Agent-friendly snapshot of the workspace state. |
| stackbone db <subcmd> | Manage the local emulator database (migrations, queries). |
| stackbone docs | Show how to reach the documentation over MCP. |
Run any command with --help for the full flag reference. The full documentation lives at https://docs.stackbone.ai, and is also served to coding agents over MCP at https://docs.stackbone.ai/mcp — run stackbone docs for the connection details.
Requirements
- Node.js
>= 20.18.0 - Docker (only required for
stackbone dev— the emulator runs Postgres + Redis + MinIO locally)
Links
- Documentation: https://docs.stackbone.ai
- Website: https://stackbone.ai
- Issues & feedback: contact the team directly.
License
Proprietary. © Stackbone.
