Getting Started
AgentiHooks is a lifecycle hook system and MCP tool server for Claude Code and Codex agents. Start with the Docker Compose bundle quick start, or use native installation for standalone sessions.
What you get
- Profiles, shared instructions and skills for Claude Code and Codex, with native settings for each harness.
- Lifecycle hooks for guardrails, context delivery and tool error memory.
- MCP tools for channels, enforcement, conditions and scheduling.
- Optional broadcasts and targeted channels for sessions sharing the broadcast store.
- Optional swarm services for task coordination, durable inbox messages, quota routing and handoffs.
Harness capabilities differ. See the Codex reference for hook delivery, permissions and configuration limits.
Prerequisites
- Python 3.12+
- uv (recommended) or pip
- Claude Code CLI or Codex CLI for native agent sessions; Docker with the Compose plugin for the service quick start
Pages in this section
| Page | What it covers |
|---|---|
| Docker Compose quick start | Start the packaged swarm services and connect clients |
| Single machine quick start | Run the whole swarm and its hive on one machine |
| Kubernetes quick start | Install the swarm hub from the OCI Helm chart with NATS and JetStream |
| Add a hive | Join a machine or a Kubernetes hive to a running hub with one invite |
| Installation | Install native Claude Code and Codex hooks; synchronize editable tool dependencies |
| Profiles | Choose and switch agent profiles, 3-layer merge |
| Portability & Reusability | Move setups across machines, manage credentials |