Command reference
The pgpg REPL is where you run every incident scenario. Launch it from your shell, then drive the session with the commands below.
REPL commands
| Command | What it does |
|---|---|
start <id> | Spins up a fresh PostgreSQL sandbox and loads the scenario <id>. |
hint | Asks the AI for a nudge toward the next step. Tracked, never penalized. |
score | Runs deterministic, offline scoring and prints your Detect / Fix / Trap breakdown out of 100. |
reset | Rolls the database back to the scenario's starting state so you can retry. |
stop | Tears down the sandbox and ends the current scenario. |
help | Lists available commands and basic usage. |
pgpg> start stage-03/07-runaway-vacuum
pgpg> hint
pgpg> score
pgpg> reset
pgpg> stop
pgpg> help
Scenario IDs
Every scenario has an ID in the form stage-NN/NN-name:
stage-NN— the track (stage) the scenario belongs to, zero-padded.NN— the scenario's position within that track, zero-padded.name— a short, hyphenated slug describing the incident.
For example, stage-03/07-runaway-vacuum is the seventh scenario in track 3. Pass the full ID to start:
pgpg> start stage-03/07-runaway-vacuum
Launcher CLI
A few things happen outside the REPL, at your normal shell prompt.
Check your installed version:
pgpg --version
Authenticate before your first session:
rillence login
If you have an activation key, redeem it directly:
rillence activate <KEY>
Once you're logged in, launch pgpg and start your first scenario.