Agent Hooks - Entire
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Use this page when you are choosing which AI coding agents Entire captures, adding an agent after setup, or fixing agent sessions that are not being captured. For agent-specific setup and caveats, see Agents.
Agent hooks are different from Git hooks. Agent hooks capture the AI session while you work; Git hooks connect that captured session to commits and pushes.
What this config affects
Agent hooks control whether Entire can capture:
- prompts and transcripts
- tool activity
- changed files
- token usage, when available
- session start and session end events
Start here if
- you are adding or changing an agent
- agent sessions are not being captured or hooks need to be reinstalled
- you are enabling an external agent plugin
Configure agent hooks
- Built-in agents
- External agents
Add a supported agent with:
entire agent add AGENT_NAME
For example:
entire agent add codex
entire agent add claude-code
During initial setup, choose an agent with:
entire enable --agent codex
Agent hook files
Each agent stores its hook configuration in its own directory. When you run entire enable or entire agent add, hooks are installed in the appropriate location for each selected agent:
| Agent | Hook location | Format |
|---|---|---|
| Claude Code | .claude/settings.json |
JSON hooks config |
| Codex | .codex/hooks.json |
JSON hooks config |
| Copilot CLI | .github/hooks/entire.json |
JSON hooks config |
| Cursor | .cursor/hooks.json |
JSON hooks config |
| Gemini CLI | .gemini/settings.json |
JSON hooks config |
| OpenCode | .opencode/plugins/entire.ts |
TypeScript plugin |
| Factory | .factory/settings.json |
JSON hooks config |
| Pi | .pi/extensions/entire/index.ts |
TypeScript extension |
You can enable multiple agents at the same time. Each agent’s hooks are independent.
External agent plugins
External agent plugins let Entire discover additional agents from executables on your $PATH. Enable external agent discovery with:
.entire/settings.json
{
"external_agents": true
}
Entire looks for executables named entire-agent-<name>. See External Agent Plugins for setup, protocol, and security details.
Reinstall agent hooks
If an agent hook is missing, stale, or was edited outside Entire, reinstall it with:
entire agent add AGENT_NAME --force
Verify agent hooks
After configuring agent hooks, run:
entire agent list
entire status --detailed
Use entire agent list to confirm the agent is installed. Use entire status --detailed to confirm Entire is enabled in the repository. Then start a fresh session with the configured agent from inside the repository. If the agent was already running before hooks were installed, restart it.