Skip to main content
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

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:
AgentHook locationFormat
Claude Code.claude/settings.jsonJSON hooks config
Codex.codex/hooks.jsonJSON hooks config
Copilot CLI.github/hooks/entire.jsonJSON hooks config
Cursor.cursor/hooks.jsonJSON hooks config
Gemini CLI.gemini/settings.jsonJSON hooks config
OpenCode.opencode/plugins/entire.tsTypeScript plugin
Factory Droid.factory/settings.jsonJSON hooks config
Pi.pi/extensions/entire/index.tsTypeScript extension
You can enable multiple agents at the same time. Each agent’s hooks are independent.

​
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.