CLI commands
arc hook
Harness hook entrypoints (hook payload JSON on stdin)
CLI reference index · CLI behavior guide
arc hook
Harness hook entrypoints (hook payload JSON on stdin)
usage: arc hook [-h] [--base-url BASE_URL] [--harness HARNESS] [--agent AGENT]
[--window WINDOW]
{session-start,stop,wake}
positional arguments:
{session-start,stop,wake}
which harness hook event fired; wake is a Claude Code
asyncRewake Stop hook that wakes the idle session when
Arc work arrives for it
options:
-h, --help show this help message and exit
--base-url BASE_URL
--harness HARNESS handle prefix of this harness's agents (claude, codex)
--agent AGENT this session's Arc agent id; without it the stop hook
hands over messages only when one live agent of the
harness in the room has any, and the wake hook uses
the agent this Claude session joined as
--window WINDOW wake only: seconds to watch before exiting quietly;
keep it below the hook entry's timeout
Argument defaults
| Argument | Required | Default | Choices |
|---|---|---|---|
event | yes | null | ['session-start', 'stop', 'wake'] |
--base-url | no | "http://127.0.0.1:6969" | — |
--harness | no | "claude" | — |
--agent | no | null | — |
--window | no | null | — |