Quickstart

export ANTHROPIC_API_KEY=...   # or another provider's key
cd your-project
hoocode                        # full-screen session

hoocode --help lists the provider keys it reads. No API key? Start hoocode and run /login to sign in with a subscription (Anthropic, GitHub Copilot, OpenAI Codex or Google) instead.

In a session

Shell, Edit and Write ask before they run: Yes, No, or Always. Read-only commands such as ls, cat, rg and git status/diff/log run without asking. To run every tool without asking, start with hoocode --skip-permissions (the header then shows SKIP PERMISSIONS).

Type	What it does
`/model`	Pick a model (Ctrl+P cycles through your favourites)
`/mode`	Switch between ask, plan, build and debug (or press Shift+Tab)
`/resume`	Reopen an earlier session in this folder
`@path/to/file`	Attach a file to your message
`/hotkeys`	Show the keyboard shortcuts
`/settings`	Change settings

Modes

hoocode starts in build.

Mode	What the agent may do
ask	Read, run shell commands, answer. Edit and Write are blocked
plan	Explore and write a plan. Edit and Write work only under `.hoocode/` (no prompt)
build	Everything: implement and verify, one change at a time
debug	Find the root cause. Edit and Write are blocked; switch to build to fix

These rules live in ~/.hoocode/hoo-config.json, written on first run; see configuration.

Sessions

Sessions are saved as JSONL under ~/.hoocode. --continue picks up the last one, /resume lists them, and /fork and /tree branch from an earlier message. Long conversations are compacted automatically. --no-session keeps a run ephemeral.

Scripted use

hoocode -p "Summarise this repo"                  # answer and exit
hoocode -p --mode json "List the TODOs in src/"   # JSON events
hoocode --tools Read,CodeSearch -p "Review src/"  # read-only
hoocode --mode rpc                                # JSON-RPC

Next: where configuration lives, or the commands and flags.