CLI scripts
Run from the vocion-core root. Root scripts forward to @vocion/core; scripts marked core run with npm run <script> --workspace @vocion/core -- <args>.
Run locally
| Script | Does |
|---|---|
dev:up / dev:down / dev:status | Start, stop, inspect the Docker platform (Postgres + pgvector, Langfuse) |
dev:next | The app on against your DATABASE_URL |
dev | The app with an embedded Postgres (PGlite) instead of Docker |
dev:agent-runtime | The agent-runtime container locally () |
build / start | Production build and serve |
Database
| Script | Does |
|---|---|
db:migrate | Apply migrations |
db:generate | Generate a migration after a schema change (contributors) |
db:studio | Browse the database |
Users and tokens
| Script | Does |
|---|---|
user:create (core) | Create a user; with --account on an empty install, the account and first workspace. --email, --name, --password (generated if omitted), --role admin|member |
tokens:issue / tokens:list / tokens:revoke | Manage vcn_live_ API tokens |
personal-projects:backfill (core) | Create every member's personal workspace now instead of at next sign-in |
Workspace
| Script | Does |
|---|---|
workspace:scaffold -- <name> [--path <dir>] | New workspace at ../workspace/<name> |
workspace:check -- <path> | Validate without writing (no database needed) |
workspace:apply -- <path> [--project <id|slug>] [--org <id>] [--dry-run] | Apply to the database |
workspace:export | One-time export of agents, object types, teams and manifest from a database |
Connectors
| Script | Does |
|---|---|
creds:set (core) | Store a connector credential |
google:oauth (core) | Run a Google login from the shell |
sync:source (core) | Sync one source now |
Evals and quality
| Script | Does |
|---|---|
eval:run (core) -- --dataset <slug> | Run an eval dataset |
eval:upgrade (core) -- --dataset <slug> --baseline <model> --candidate <model> | Compare two models on a dataset |
test, test:e2e, lint, check:types, check:deps, check:i18n | Contributor checks |
openapi:generate | Regenerate the OpenAPI spec |
MCP and observability
| Script | Does |
|---|---|
mcp:serve | The local stdio MCP server |
langfuse:smoke / langfuse:bootstrap (core) | Check or set up Langfuse |
Infrastructure
| Script | Does |
|---|---|
tofu:init / plan / apply / output / destroy | OpenTofu in infra/terraform |
docker:build / docker:run | Build and run the app image |