CLI

In early access, Postrun's commands are pnpm scripts run from the root of a checkout. Each one forwards its flags to a script in the core package. This page lists every command, its flags, and the environment variables it reads.

pnpm capture

pnpm capture
pnpm capture --once

Without flags, it runs until you press ctrl-c:

1. Checks ~/.claude/settings.json and applies Postrun's Claude Code configuration if it is missing or out of date (see pnpm capture:cc:setup). If it is already present, it logs claude-code config: already present in <path>.
2. Starts the OTLP receiver on 127.0.0.1:4318.
3. Sorts Claude Code's hook log into one folder per session and writes each session to the store on every Stop and SessionEnd, after a 4 second pause. On start it catches up on every session it missed, and removes a session's raw files 24 hours after the session goes quiet (the store keeps everything).
4. Watches ~/.cline/data/sessions, writes new or changed Cline sessions on start, and rewrites a session at least 2 seconds after its files change.

Both are paced so a busy session costs about 1% of one CPU core at most: a very long session is refreshed less often rather than costing more.

Every log line starts with the time, for example [22:14:03] otlp receiver on http://127.0.0.1:4318 (127.0.0.1 only) -> ....

pnpm capture:cc:setup

pnpm capture:cc:setup

Merges Postrun's env vars and six hooks into ~/.claude/settings.json and prints a one-line summary of what changed. Backs the file up once to settings.json.postrun-backup, keeps every other setting, and never duplicates its own entries, so it is safe to run again. Reads POSTRUN_CAPTURE_DIR, POSTRUN_OTLP_PORT and POSTRUN_CLAUDE_SETTINGS. See Claude Code for exactly what it writes.

pnpm ingest

pnpm ingest --agent claude-code [<captures-dir>] [--session <id>] [--db <path>]
pnpm ingest --agent cline <session-id | session-dir | messages.json> [--db <path>]

Builds sessions from an agent's files and writes them to the store. Every write is an upsert, so re-ingesting is safe.

The positional argument:

• For claude-code, a captures folder. Defaults to ~/.postrun/captures.
• For cline, required: a session id (looked up in ~/.cline/data/sessions), a session folder, or a <id>.messages.json file.

Output, one line per session and a total:

ingested claude-code session 3ac04cde-...: 112 steps, 9 turns, 1 segments, 1 actors -> /home/you/.postrun/postrun.db
store totals: sessions=4 segments=4 actors=4 turns=31 steps=402

The first word is updated when the session was already in the store.

pnpm sessions

pnpm sessions [--agent <kind>] [--db <path>]

Lists stored sessions, newest first. For each: start time, agent, id and workspace; then step counts by type, turns, failed, reference-only and flag counts, and cost; then the first line of the first prompt.

Prints no sessions in <path> when the store is empty.

pnpm delete

pnpm delete <session-id>
pnpm delete <session-id> --yes

Without --yes, prints what would be deleted (agent, title, step count, and the raw capture folder if there is one) and changes nothing. With --yes, deletes the session from the store with secure delete on, removes its raw capture files, and keeps its id so the recorder never records it again. Get the id from pnpm sessions.

It does not touch the agent's own copy under ~/.claude/projects or ~/.cline/data/sessions, and says so. If the id is unknown it exits with an error, or says the session was already deleted.

The review app's Delete button does the same. See Deleting a session.

pnpm serve

pnpm serve [--port <n>] [--db <path>] [--ui <dir>]

Builds the review app, then serves it and the API on 127.0.0.1. Runs until ctrl-c. The host is always 127.0.0.1 and cannot be changed.

pnpm export

pnpm export <session-id> [-o <file>] [--force] [--db <path>]

Writes one redacted, self-contained HTML report and lists every value it masked. Redaction cannot be switched off.

The file is written with mode 0600. See Exporting and redaction.

pnpm adapter:cc and pnpm adapter:cline

pnpm adapter:cc <captures-dir> [session-id] > steps.json
pnpm adapter:cline <session-id | session-dir | messages.json> > steps.json

Run an adapter on its own: the session's steps go to stdout as a JSON array, and a one-line summary goes to stderr. Nothing is written to the store. Useful for checking how an agent's files are read.

Point adapter:cc at one session's folder, ~/.postrun/captures/sessions/<id>. Given a folder of shared log files that holds several sessions, it needs the session id; the error lists the ids it found.

pnpm dev:core and pnpm dev:ui

pnpm dev:core     # the server on 127.0.0.1:1234, serving the last built UI (no build step)
pnpm dev:ui       # Next dev server on 127.0.0.1:3000, with /api proxied to 127.0.0.1:1234

dev:core takes the same flags as pnpm serve. dev:ui reads UI_PORT for its own port and POSTRUN_CORE_URL for the server it proxies to.

Workspace commands

pnpm typecheck    # every package
pnpm test         # every package
pnpm build        # every package

Exit codes

Errors go to stderr, prefixed with the command, such as postrun serve:, postrun store:, postrun capture: or postrun export:.