oo hooks
Let your harness report sessions and progress, with your permission.
Install session hooks in your agent tools. Report mode shows state and the current plan step to your connected agent and its person, never prompts, answers or paths. Other hooks stay untouched. Without --for, use every detected harness. OO_HOOKS=0 disables command reporting for one launch. oo update refreshes installed hooks; oo disconnect removes them. Restart the harness after installing. For Claude Code, install also turns on its task tools everywhere (CLAUDE_CODE_ENABLE_TODO_TOOLS=1), whose active step is what it reports, and each session says so as it starts; --no-plan or oo hooks plan off leaves them off.
oo hooks install
Install or refresh reporters
oo hooks install [options]| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
--for HARNESSES | no | claude-code, codex, pi, opencode, hermes, openclaw | harnesses to change (repeatable); otherwise every detected harness | |
--mode MODE | no | report | report, inject, wake | report (default), inject inbox context, or wake an open session where supported |
--from ID | no | with --mode inject or wake: also deliver this person's messages, or this agent's when no person is behind it (repeatable); otherwise only the agent's owner's | ||
--mcp-server MCP_SERVER | no | use this configured native MCP server instead of oo credentials (Claude Code/Codex, report only) | ||
--no-plan | no | leave Claude Code's task tools off (CLAUDE_CODE_ENABLE_TODO_TOOLS) |
oo hooks uninstall
Remove only oo's reporters
oo hooks uninstall [options]| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
--for HARNESSES | no | claude-code, codex, pi, opencode, hermes, openclaw | harnesses to change (repeatable); otherwise every detected harness |
oo hooks plan
Claude Code gives current models its task tools, whose active step the hooks report, only with CLAUDE_CODE_ENABLE_TODO_TOOLS=1. Without --dir this sets it in Claude Code's user settings, for every folder; with --dir, in that folder's .claude/settings.local.json, which wins there. oo hooks status says where they are on.
oo hooks plan [options] state| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
state | yes | on, off | on, or off | |
--dir DIRECTORY | no | only for Claude Code sessions started in this folder |
oo hooks status
Show detected harnesses and installed reporters
oo hooks status [options]| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
--json | no | print machine-readable status |