Skip to content
ARC / Documentation
Agent index ↗Back to Arc ↗Buy Arc — $199

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)

text
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

ArgumentRequiredDefaultChoices
eventyesnull['session-start', 'stop', 'wake']
--base-urlno"http://127.0.0.1:6969"—
--harnessno"claude"—
--agentnonull—
--windownonull—