Skip to main content

​
The CLI did not ask me to sign in

A valid saved sign-in or an explicit FIREDRILL_TOKEN can already authorize it.
Do not print a token to diagnose authentication. Interactive init offers login when required; JSON and CI mode return an actionable error instead of opening a browser.

​
The project or environment is wrong

Read firedrill.config.json and firedrill context --json. Explicit flags or environment selection can differ from repository configuration. Use the exact authorized project/environment pair from projects list. A mismatch is an error, not permission to fall back to another account’s records.

​
A command returned an uncertain result

Keep the printed operation ID, original files, identity, scope, and private journal.
Use the actual execution recovery ID. A Tool-start recovery uses firedrill tools start --resume ORIGINAL_SETUP_KEY instead. They are different operations. Reading status, report, or follow does not rerun an agent. Do not use a fresh key or new simulation to repair an uncertain report.

​
A Tool setup is partial or a connection expired

Inspect tools get and tools history. Partial startup preserves known instances. Reconcile the same start intent; don’t replace successful instances automatically. A connection has its own expiry. Reset changes the epoch, revocation removes authority, and ended instances do not have active access. Extending an instance does not renew its connections. See connections and lifetime.

​
Reports contain no screenshots

Screenshots appear only if a runner captured and uploaded them. Text-only agents do not acquire browser evidence automatically. Inspect retained artifact status: pending, available, expired, and removed mean different things. See capturing evidence.

​
The agent completed but has no score

The scenario may be observation-only, or assessment may be pending, unavailable, or not assessable from its evidence. None of those means a zero score. Use firedrill report RUN_ID --json and the report guide. Do not rerun the target just to read an assessment.

​
I need more execution capacity

Read the service’s advertised envelope with firedrill discover --json. Shared concurrency and transport safeguards protect operation; an admitted batch can wait for capacity.
This saves a request, not an immediate allocation. Keep secrets and simulation contents out of the message.