CLI Reference
The systemprompt CLI domains and the commands an operator uses, plus the just recipes that wrap build, run and deploy.
On this page
TL;DR: The binary is systemprompt, shaped systemprompt <domain> <subcommand> [args]. Every level has --help, which is the authority; this
page is a map. Global flags: --profile <name>, --database-url <url>,
--json, --yaml, -v, -q, --non-interactive.
Domains
| Domain | Subcommands |
|---|---|
core |
artifacts, content, files, contexts, skills, plugins, marketplace, hooks, services (bundles: validate, pack, sign, publish) |
infra |
services, db, jobs, logs |
admin |
users, agents, config, setup, bootstrap, session, bridge, access-control, keys, identity, issues, licence |
cloud |
auth, init, tenant, profile, deploy, backup, doctor, status, fleet, dockerfile, sync |
analytics |
overview, conversations, agents, tools, requests, sessions, content, traffic, costs |
web |
content-types, templates, assets, sitemap, validate |
plugins |
list, show, run, validate, config, capabilities, mcp |
build |
core, mcp |
Common operator commands
| Task | Command |
|---|---|
| Service lifecycle | infra services start / stop / restart / status |
| Errors in the last hour | infra logs view --level error --since 1h |
| Live tail | infra logs stream |
| Recent AI requests | infra logs request list --limit 20 (show, stats) |
| Full chain for one request | infra logs audit <request-id> (--messages for the transcript) |
| Tool-call traces | infra logs trace list, infra logs trace show <id> |
| Warn-mode report | infra logs governance report --since 7d |
| Spend | analytics costs summary, analytics costs breakdown --by user --since 30d |
| Jobs | infra jobs list / show / run / history / enable / disable |
| Database | infra db status, tables, describe, query (read-only), migrations, migrate-status, doctor |
| Users | admin users list / show / search / create / delete / restore / legal-hold; role, api-key, service-account |
| CLI session and profile | admin session show / list / switch <profile> / login / logout |
| Bridge | admin bridge issue-code --user-id <email>, admin bridge list |
| MCP servers | plugins mcp list / status / tools / logs <server> / call |
| Skills | core skills list, core skills show |
| Export console changes as code | cloud sync |
Remote routing to a deployed instance needs the production profile active and
an admin session (admin session switch production, then
admin session login).
just recipes
Builds, tests and deploys go through the justfile so the shared build
coordinator sees them (just --summary lists every recipe).
| Recipe | Does |
|---|---|
just setup-local |
First-time local setup: profile, Docker Postgres, publish pipeline. |
just db-up / just db-down |
Per-clone Docker Postgres. |
just build, just build-status |
Coordinated build; state of in-flight and last runs. |
just start / just stop, just server-status |
Run the server; report the running server and binary staleness. |
just publish |
Bundle CSS/JS, copy assets, prerender. |
just prepare |
Regenerate the .sqlx/ offline cache (live DB). |
just repair-migrations |
Recover migration checksum drift in place. |
just clippy, just lint-gates, just test, just preflight |
Lint, source gates, tests, full local gate run. |
just deploy |
Deploy the production profile. |
just release X.Y.Z |
Open, then merge, the frozen release PR. |