Skip to content

CLI

The on-path stockroom command is the torch-safe entrypoint to the engine. After initialization it usually lives at ~/.local/bin/stockroom (or wherever your user bin is on PATH). Use it when you want the same engine the skills call — without an agent turn.

Prerequisites

  • A completed sr-initialize so the shim is installed and on PATH
  • Familiarity with the agent path when you want it back: Skill index
which stockroom
stockroom --help

If stockroom is missing or the shim refuses, recover under Troubleshooting → Installed layout — do not invent a clone-based uv bootstrap from this page.

Invocation

Skills (sr-query, sr-semantic, …) orchestrate inside a harness. Out-of-band, you call the shim directly:

stockroom <subcommand> [flags…]
stockroom <subcommand> --help

The shim owns the torch-safe run contract and dispatches into the engine. Prefer it over calling the engine with bare uv as an end user.

Read surfaces

stockroom query "SELECT DISTINCT harness FROM sessions"
stockroom query --format table --detail full "SELECT message_id, role FROM messages LIMIT 5"
stockroom semantic "flaky dashboard tests" -k 10
Subcommand Role
query Read-only SQL against the warehouse
semantic Vector (semantic) search.

For schema and search mental model, see Search and Architecture → Warehouse / Embeddings. This page does not fork skill flag tables — use --help and the skill SKILL.md files for operational recovery detail.

Output shape

query and semantic share read-time presentation flags:

  • --format {tsv,json,table} — default tsv (stream-friendly)
  • --detail {compact,snippet,full,raw} — default snippet; truncation is display-only. Prefer --format json --detail raw when exact whitespace must match storage.

Full flag semantics: stockroom query --help / stockroom semantic --help.

Lookup ids are always printed

Every stockroom semantic shape includes session_id and message_id, so a hit can be opened with stockroom query from the default output. The preview is still truncated.

To print the search itself with exact stored whitespace, use

stockroom semantic --format json --detail raw "my query..."

See also