> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent plugins

> Install Composio for Codex or Claude Code

Agent plugins let Codex and Claude Code use Composio from your current conversation. The plugin teaches your agent how to find tools, connect accounts, and run actions through the Composio CLI.

## Install the plugin

Install the Composio CLI:

```bash theme={null}
curl -fsSL https://composio.dev/install | sh
```

Open a new terminal, sign in, and configure every supported agent on your machine:

```bash theme={null}
composio login
composio setup --target auto
```

`auto` detects Codex and Claude Code. If both are installed, it configures both.

> [!NOTE]
>
> **Running setup from an agent or script?**
>
> Setup asks before changing local files. Add `--yes` in a non-interactive shell: `composio setup --target auto --yes`.

## Try a task

Ask Codex or Claude Code to work with one of your apps:

* `List the open GitHub issues assigned to me.`
* `Summarize the unread Gmail messages I received today.`
* `Create a Linear issue from these release notes: ...`

You do not need to know a tool slug or connection ID. The agent searches by task and selects a matching tool. If the toolkit is not connected, the agent starts `composio link` and gives you a Connect Link. Approve the connection, then ask the agent to continue.

## Configure one agent

Use an explicit target when you only want to configure one agent.

### Codex

```bash theme={null}
composio setup --target codex
```

The Codex plugin bundles the Composio CLI skill. You can also install the plugin with Codex directly:

```bash theme={null}
codex plugin marketplace add https://github.com/ComposioHQ/composio-plugin-openai.git --json
codex plugin add composio@composio --json
```

The plugin source is available in [`ComposioHQ/composio-plugin-openai`](https://github.com/ComposioHQ/composio-plugin-openai).

### Claude Code

```bash theme={null}
composio setup --target claude
```

You can also install the plugin from Claude Code:

```bash theme={null}
/plugin marketplace add ComposioHQ/composio-plugin-cc
/plugin install composio@composio
```

See the [Claude Code plugin guide](https://composio-preview.mintlify.site/docs/claude-code-plugin) for team installation, updates, and troubleshooting.

## What the plugin uses

Both plugins run the Composio CLI underneath. The agent uses `composio search` to find an unknown tool, `composio link` to connect an account, and `composio execute` to run a known tool. The same connections are available when you use the [CLI directly](https://composio-preview.mintlify.site/docs/cli.md).

## Install only the CLI skill

The plugin includes a Composio CLI skill that teaches your agent how to search for and run tools. Codex receives it with the plugin, while `composio login` installs it for Claude Code by default.

If you want the skill without the plugin, install it for your agent directly:

```bash theme={null}
composio setup skill claude
composio setup skill codex
```

## Choose another setup

> [card] [Build an agent](https://composio-preview.mintlify.site/docs/quickstart.md)
>
> Add Composio tools and authentication to your application.

> [card] [Use the CLI](https://composio-preview.mintlify.site/docs/cli.md)
>
> Search, connect, and run tools from your terminal.

> [card] [Connect over MCP](https://composio-preview.mintlify.site/docs/composio-connect.md)
>
> Add Composio to an existing MCP client.
