A Reasonix session that runs for two hours will eventually forget what file you were in, write something into the wrong directory, or charge you for repeating the same prefix. The slash commands are the controls that keep the cache warm and the diff readable. Most of them are local — they cost nothing and never leave the session.
Commands and settings
| Command | What it does |
|---|---|
| /init | Scan the workspace, write an AGENTS.md with project layout and conventions. Run it once per project, then re-run with force when the layout changes significantly. |
| /plan on | Switch to read-only planning. The agent may still call read-only tools but cannot write. Submitted plans collapse to a compact summary by default; press Ctrl+P in the modal to expand. |
| /plan off | Return to standard mode. Plan and Standard now use the same Permissions rules; the Sandbox is the real boundary. |
| /pro | Arm deepseek-v4-pro for the next turn only. Pair with /pro off if you forget to switch back. |
| /pro off | Disarm Pro. Useful before long mechanical tasks that should not pay the Pro premium. |
| /compact | Manual compaction. Auto-fires at ~50% of compact_ratio; this is the manual trigger when the context feels long. |
| /rewind | Open the checkpoint picker. Same as Esc-Esc with an empty composer. Choose code, conversation, or both. |
| /doctor | Health check: API reachability, config, MCP wiring, hooks, project state. Run this first when a session refuses to start. |
| /model | Switch model mid-session. Bare opens a picker; /model deepseek-v4-pro switches directly. |
| /memory | List / show / forget / clear the pinned memory (REASONIX.md, ~/.reasonix/memory). |
| /skills | Browse user skills; /skill new my-skill scaffolds a Markdown playbook. |
| /cost | Bare shows last turn spend; with text it estimates cost of sending that next. |
A typical long session
# a typical two-hour session
# 1. orientation (cache the prefix once)
reasonix # TUI
/init # → AGENTS.md
# 2. plan first
/plan on
"design a refactor for the auth flow"
# review the summary, press Ctrl+P if you want detail
/plan off
# 3. first pass with a fast model
reasonix run "implement the plan in src/auth/" --model deepseek-v4-flash
# 4. promote to pro for the hard sub-task
/pro
"now harden the JWT validation; think about race conditions"
/pro off
# 5. checkpoint before the dangerous edit
Esc Esc # or /rewind
# pick a turn, choose [code+conversation]
# 6. keep the prefix tight
/cost # "last turn spent ¥0.04"
/compact # when the conversation feels longCommon failure modes
/prois one-shot. Without/pro off, the next turn stays on Pro and you pay for it./plan ondoes NOT block shell calls. Bash commands still run; only file writes are blocked. Combine with[permissions] mode = "ask"if you also want to gate shell./compactis safe to run repeatedly; it shortens old turns into a summary and does not touch the cache-stable prefix. Do not run it during a model turn — the active controller will not see the change./rewindis file-snapshot based, not git. Restore wipes anything you did after the snapshot, including out-of-band edits you made yourself./init forceoverwrites the existingAGENTS.md. If you have hand-written sections, save them first.
Comments