CLI
CLI Troubleshooting
Diagnose flaky or failing CLI runs and recover deterministic replay behavior.
Troubleshooting Flow
- Confirm every command uses the same
--nameand, when needed, the same--root-dir. - Remember that omitting
--nametargets sessiondefault. - Re-run
opensteer snapshot actionbefore counter-based actions. - Add
OPENSTEER_DEBUG=trueto surface detailed internal errors. - Ensure CLI
--nameand SDKnamestay consistent when they should share cached descriptions. - If replay breaks after UI changes, refresh cached descriptions for that page template.
Notes
- This suite is intentionally manual/explicit and is not part of the default
testrun. - Deterministic checks are the primary pass criteria.
- In
advisorymode, judge failures do not fail the test.
Covered Features
cli:snapshotenv:OPENSTEER_DEBUG
