Skip to main content
Use the Agent Integration Protocol to capture sessions from an AI coding agent that Entire does not ship with. An agent integration is an entire-agent-<name> executable. A CLI plugin is an entire-<name> executable that adds a command such as entire graph. Entire discovers both systems on your $PATH. The agent- segment determines whether Entire registers the executable as an agent or a command.

​
Add an Agent Integration

After you put the executable on your $PATH, install its hooks in an existing Entire repository:
During initial setup, select it with:
See entire agent add and entire enable --agent for their flags and setup behavior.
Selecting a discovered agent with entire agent add or entire enable --agent sets external_agents to true. If you install an integration executable after setup, run entire agent add NAME or add "external_agents": true to .entire/settings.json. The setting key keeps its original name.
Agent integrations receive repository paths and session data, and they run with the same filesystem access as the Entire CLI. Only install integrations you trust.

​
Protocol Reference

Build an Agent Integration

Scaffold an executable and implement the protocol with working examples.

Architecture

See how the CLI discovers an integration and invokes it.

Lifecycle

Follow the CLI calls through discovery, setup, sessions, and shutdown.

Commands

Implement each subcommand, input, and output.

Data Model

Use the JSON shapes that the protocol exchanges.