Infrastructure
A guided tour of the platform's day-2 operational surface.
Before you adopt anything, you want to know what it looks like at 2am. This walkthrough takes you through the operator CLI the same way an on-call engineer would: check service health, inspect the database, audit scheduled work, tail the logs, then review config. Every command is read-only, every answer is a single CLI call, and nothing here needs a dashboard.
-
Check service health
Runs infra services status and then --detailed to show the agent and MCP server processes the platform supervises, with pids, ports, and health. This is the first thing you reach for when something feels wrong.
What you see You see the systemprompt MCP server running as a supervised process, plus any configured agents, with health and lifecycle hooks for start/stop/restart/cleanup.
Run it — 01-services.sh
./demo/infrastructure/01-services.shOr run the individual commands below:
systemprompt infra services statussystemprompt infra services status --detailed -
Inspect the Postgres schema
Walks the database from the outside in: connection info, table list, schema of governance_decisions, indexes, row counts, size, a live read-only SQL query, migration status, and schema validation. Nothing is hidden behind an ORM.
What you see You see the real schema, a live SELECT against governance_decisions grouped by decision, and a passing migration and schema validation check.
Run it — 02-database.sh
./demo/infrastructure/02-database.shOr run the individual commands below:
systemprompt infra db infosystemprompt infra db statussystemprompt infra db tablessystemprompt infra db describe governance_decisionssystemprompt infra db indexessystemprompt infra db count governance_decisions -
Audit scheduled background jobs
Lists every registered background job, shows one job's schedule and config, then prints execution history. This is how you answer "what runs on its own, and did the last run succeed?"
What you see You see the registered jobs, a specific job's cron schedule and configuration, and the last N executions with status and duration.
Run it — 03-jobs.sh
./demo/infrastructure/03-jobs.shOr run the individual commands below:
systemprompt infra jobs listsystemprompt infra jobs show "$JOB_NAME"systemprompt infra jobs history -
Tail logs, traces, and AI requests
Runs infra logs view, summary, search, then trace list, request list, and tools list. Application logs, per-request traces, AI call logs, and MCP tool executions are all first-class and queryable from one CLI.
What you see You see recent log lines, a level-aggregated summary, keyword search, execution traces, AI request records, and MCP tool call history — enough to debug any failure end-to-end.
Run it — 04-logs.sh
./demo/infrastructure/04-logs.shOr run the individual commands below:
systemprompt infra logs view --since 1h --limit 10systemprompt infra logs summary --since 24hsystemprompt infra logs search "extension" --since 24hsystemprompt infra logs trace list --limit 5systemprompt infra logs request list --limit 5systemprompt infra logs tools list --limit 5 -
Review runtime configuration
Shows the merged config, the files it came from, validation status, runtime values, filesystem paths, and the active AI provider. Config is files on disk you can diff, not a mystery service.
What you see You see the effective configuration, the source files that produced it, a green validation check, and the current AI provider binding.
Run it — 05-config.sh
./demo/infrastructure/05-config.shOr run the individual commands below:
systemprompt admin config showsystemprompt admin config listsystemprompt admin config validatesystemprompt admin config runtime showsystemprompt admin config paths showsystemprompt admin config provider list