Interactive Mode
The hara REPL — slash commands, attaching files, steering a running task, and managing context.
Run hara with no arguments to open the REPL: a bottom-pinned input box, streaming output, and
colored diffs. (HARA_TUI=0 falls back to a classic readline prompt.)
The chrome under the transcript is constant-height: a one-row status slot shows a spinner +
the current step while a turn runs and key hints when idle, so the input box never jumps at turn
boundaries. shift+tab swaps that same slot for a one-row mode picker
(suggest → auto-edit → full-auto → plan — see Permissions for what each
mode does, including plan mode's exit_plan handshake).
Steering & attaching
- Type while it works. A message sent mid-turn reaches the model between tool calls and gets triaged: a refinement folds into the running task; a new task goes onto the todo queue (work continues); urgent input ("stop", "this first") makes it finish the current step safely and switch.
@pathattaches a file's contents inline (Tab completes;@dir/lists a directory).
Slash commands
Type / to see them. The essentials:
| Command | Does |
|---|---|
/model [id] | show or switch the model |
/approval [mode] | cycle or set approval (suggest · auto-edit · full-auto) |
/tools · /usage · /context | list tools · token usage · what's filling the window |
/org <task> · /plan <task> | dispatch to a role · plan & execute as atoms |
/roles · /skills · /skill <id> | list roles · list skills · load a skill into your next message |
/diff [staged] · /review · /commit | working-tree diff · review for bugs/security · AI commit |
/undo | revert the last file change(s) this session |
/rewind [n] | fork the conversation back to an earlier turn (files unchanged) |
/checkpoint [restore n] | list / restore a file-state snapshot |
/compact | summarize the conversation to free up context |
/recall <query> | pull snippets from your code-asset library into context |
/sessions · /name <name> | list saved sessions · rename this one |
/vision <model> | set a describer model so a text-only model can read images |
/init · /doctor | regenerate AGENTS.md · check setup |
/reset · /exit | clear context · leave |
See Memory & Sessions for how /rewind, /checkpoint, and
/compact relate to hara's persistence model.