Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
mdx 95 lines 3.23 KB
Raw
1 ---
2 title: Agent plugins
3 description: Install Composio for Codex or Claude Code
4 keywords: [agent plugins, codex, claude code, cli, composio setup, skills]
5 ---
6
7 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.
8
9 ## Install the plugin
10
11 Install the Composio CLI:
12
13 ```bash
14 curl -fsSL https://composio.dev/install | sh
15 ```
16
17 Open a new terminal, sign in, and configure every supported agent on your machine:
18
19 ```bash
20 composio login
21 composio setup --target auto
22 ```
23
24 `auto` detects Codex and Claude Code. If both are installed, it configures both.
25
26 <Callout type="info" title="Running setup from an agent or script?">
27 Setup asks before changing local files. Add `--yes` in a non-interactive shell: `composio setup --target auto --yes`.
28 </Callout>
29
30 ## Try a task
31
32 Ask Codex or Claude Code to work with one of your apps:
33
34 - `List the open GitHub issues assigned to me.`
35 - `Summarize the unread Gmail messages I received today.`
36 - `Create a Linear issue from these release notes: ...`
37
38 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.
39
40 ## Configure one agent
41
42 Use an explicit target when you only want to configure one agent.
43
44 ### Codex
45
46 ```bash
47 composio setup --target codex
48 ```
49
50 The Codex plugin bundles the Composio CLI skill. You can also install the plugin with Codex directly:
51
52 ```bash
53 codex plugin marketplace add https://github.com/ComposioHQ/composio-plugin-openai.git --json
54 codex plugin add composio@composio --json
55 ```
56
57 The plugin source is available in [`ComposioHQ/composio-plugin-openai`](https://github.com/ComposioHQ/composio-plugin-openai).
58
59 ### Claude Code
60
61 ```bash
62 composio setup --target claude
63 ```
64
65 You can also install the plugin from Claude Code:
66
67 ```bash
68 /plugin marketplace add ComposioHQ/composio-plugin-cc
69 /plugin install composio@composio
70 ```
71
72 See the [Claude Code plugin guide](/docs/claude-code-plugin) for team installation, updates, and troubleshooting.
73
74 ## What the plugin uses
75
76 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](/docs/cli).
77
78 ## Install only the CLI skill
79
80 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.
81
82 If you want the skill without the plugin, install it for your agent directly:
83
84 ```bash
85 composio setup skill claude
86 composio setup skill codex
87 ```
88
89 ## Choose another setup
90
91 <Cards>
92 <Card title="Build an agent" href="/docs/quickstart" description="Add Composio tools and authentication to your application." />
93 <Card title="Use the CLI" href="/docs/cli" description="Search, connect, and run tools from your terminal." />
94 <Card title="Connect over MCP" href="/docs/composio-connect" description="Add Composio to an existing MCP client." />
95 </Cards>