@stackbone/cli 0.1.0-alpha.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +14 -0
- package/README.md +50 -0
- package/main.js +8660 -0
- package/migrations/0001_runs.sql +150 -0
- package/migrations/0002_approvals.sql +110 -0
- package/migrations/0003_runs_is_playground_index.sql +15 -0
- package/migrations/0004_playground_fixtures.sql +40 -0
- package/migrations/0005_stackbone_viewer.sql +47 -0
- package/migrations/0006_secrets.sql +37 -0
- package/migrations/0007_agent_config_versions.sql +57 -0
- package/migrations/0008_approvals_idempotency_nulls_not_distinct.sql +19 -0
- package/package.json +34 -0
- package/stackbone-cli-0.1.0-alpha.0.tgz +0 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to `@stackbone/cli` are documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [Unreleased]
|
|
9
|
+
|
|
10
|
+
## [0.1.0-alpha.0] - 2026-05-12
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
|
|
14
|
+
- Initial public alpha release of the Stackbone CLI on npm under the `alpha` dist-tag.
|
package/README.md
ADDED
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# @stackbone/cli
|
|
2
|
+
|
|
3
|
+
The CLI for [Stackbone](https://stackbone.ai) — the marketplace and runtime for containerized AI agents.
|
|
4
|
+
|
|
5
|
+
> **Status:** `alpha`. The contract may break between releases. Pin a version or rely on the `alpha` dist-tag.
|
|
6
|
+
|
|
7
|
+
## Quick start
|
|
8
|
+
|
|
9
|
+
No install required — invoke the CLI through `npx`:
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npx @stackbone/cli@alpha init my-agent
|
|
13
|
+
cd my-agent
|
|
14
|
+
npx @stackbone/cli@alpha dev
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
That's it. `init` scaffolds a new agent project (templates + Claude skill); `dev` runs a local control-plane emulator with Stackbone Studio at `http://localhost:4242` so you can iterate without deploying.
|
|
18
|
+
|
|
19
|
+
## Commands
|
|
20
|
+
|
|
21
|
+
| Command | What it does |
|
|
22
|
+
| ---------------------------- | ---------------------------------------------------------------------- |
|
|
23
|
+
| `stackbone init [name]` | Scaffold a new Stackbone project from a template. |
|
|
24
|
+
| `stackbone dev` | Run the local control-plane emulator + Stackbone Studio. |
|
|
25
|
+
| `stackbone deploy` | Build, push, and deploy the current agent to Stackbone runtime. |
|
|
26
|
+
| `stackbone login` / `logout` | Authenticate the CLI via the device-code flow (RFC 8628). |
|
|
27
|
+
| `stackbone whoami` | Show the active user and organization. |
|
|
28
|
+
| `stackbone current` | Print the organization currently linked to this session. |
|
|
29
|
+
| `stackbone link` | Link the current directory to an existing organization + agent. |
|
|
30
|
+
| `stackbone list` | List organizations the current user owns. |
|
|
31
|
+
| `stackbone metadata` | Agent-friendly snapshot of the workspace state. |
|
|
32
|
+
| `stackbone db <subcmd>` | Manage the local emulator database (migrations, queries). |
|
|
33
|
+
| `stackbone docs <topic>` | Print Stackbone documentation inline. Run with no args to list topics. |
|
|
34
|
+
|
|
35
|
+
Run any command with `--help` for the full flag reference, or `npx @stackbone/cli@alpha docs cli` for the inline documentation.
|
|
36
|
+
|
|
37
|
+
## Requirements
|
|
38
|
+
|
|
39
|
+
- Node.js `>= 20.18.0`
|
|
40
|
+
- Docker (only required for `stackbone dev` — the emulator runs Postgres + Redis + MinIO locally)
|
|
41
|
+
|
|
42
|
+
## Links
|
|
43
|
+
|
|
44
|
+
- Documentation: <https://docs.stackbone.ai>
|
|
45
|
+
- Marketplace: <https://stackbone.ai>
|
|
46
|
+
- Issues & feedback: report via `stackbone docs feedback` once authenticated, or contact the team directly.
|
|
47
|
+
|
|
48
|
+
## License
|
|
49
|
+
|
|
50
|
+
Proprietary. © Stackbone.
|