init-agentlisted
Install: claude install-skill the-cloud-clockwork/agentihooks
# Init Agent
Run it when the operator asks for it; no typed phrase and no guard gate it.
A quota handoff's `init-agent --handoff` passes while the runtime's quota
policy has the handoff due.
`agentihooks init-agent` owns host detection, terminal quoting, OAuth
account routing, and the start check. Never build a `herdr`, `wt.exe`,
`osascript`, or terminal command by hand.
The session opens in herdr when herdr is installed and enabled, otherwise in a
native terminal tab (Windows Terminal, macOS Terminal, a Linux emulator).
`AGENTIHOOKS_TERMINAL_HOST=herdr|native` or `--host` overrides that. When herdr
was chosen automatically and fails, the launch falls back to a native tab and
reports `herdr_error`.
## 1. Map the request
| Operator says | Launcher argument |
|---|---|
| a directory ("in ~/dev/foo", "at /repo") | `--dir <path>` — absolute, `~/…`, or relative to `$RUN_CLAUDE_BASE_DIR` → `~/dev` → `$HOME` |
| a session or tab name | `--name <name>` — default `s-YYMMDD-HHMMSS` |
| an opening prompt or task | `--prompt-file <file>` (see below) |
| a model ("use opus", "on fable") | `-- --model opus` or `-- --model fable` — the alias, never a versioned id; Claude resolves it to the latest release |
| resume a session | `-- --resume <session-id>` |
| fork a session | `-- --resume <session-id> --fork-session` |
| any other Claude flag | after `--`, unchanged |
| "next to me", "split" (caller runs inside herdr) | `--placement split` |
| "in its own workspace" | `--placement works