> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Integration Protocol

> Add support for an AI coding agent that Entire does not ship with

If your agent is not listed in our [native agent integrations](/agents/overview), you can still integrate it with Entire. This can be done with the Agent Integration Protocol by building an `entire-agent-<name>` executable and putting it on your `$PATH`. Entire discovers it there and registers it as an agent.

## Add an Agent Integration

After you put the executable on your `$PATH`, install its hooks in an existing Entire repository:

```bash theme={null}
entire agent add NAME
```

During initial setup, select it with:

```bash theme={null}
entire enable --agent NAME
```

See [`entire agent add`](/cli-reference/agent#agent-add) and [`entire enable --agent`](/cli-reference/enable) for their flags and setup behavior.

<Note>
  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.
</Note>

<Warning>
  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.
</Warning>

## Protocol Reference

<CardGroup cols={2}>
  <Card title="Build an Agent Integration" icon="hammer" href="/agents/agent-integration-protocol/build-an-agent-integration">
    Scaffold an executable and implement the protocol with working examples.
  </Card>

  <Card title="Architecture" icon="sitemap" href="/agents/agent-integration-protocol/architecture">
    See how the CLI discovers an integration and invokes it.
  </Card>

  <Card title="Lifecycle" icon="timeline" href="/agents/agent-integration-protocol/lifecycle">
    Follow the CLI calls through discovery, setup, sessions, and shutdown.
  </Card>

  <Card title="Commands" icon="terminal" href="/agents/agent-integration-protocol/commands">
    Implement each subcommand, input, and output.
  </Card>

  <Card title="Data Model" icon="brackets-curly" href="/agents/agent-integration-protocol/data-model">
    Use the JSON shapes that the protocol exchanges.
  </Card>
</CardGroup>