---
summary: The coding agents Flow supports, how to install Flow for them, and where Flow writes its files for each one.
---

# Coding agents

Flow officially supports five coding agents: [:icon{name="devicon:claude"} Claude Code]{.brand}, [:icon{name="devicon:codex"} Codex CLI]{.brand}, [:icon{name="devicon:cursor"} Cursor]{.brand}, [:icon{name="devicon:githubcopilot"} GitHub Copilot]{.brand} and [:icon{name="simple-icons:opencode"} OpenCode]{.brand}. Other agents that read `AGENTS.md` and `.agents/skills/` work with Flow too. See [Other coding agents](#other-coding-agents).

## Installing for your agents

`npx @adonisplus/flow install` asks which agents you use, and selects the ones it finds in your project. For example, a `.claude` folder or a `CLAUDE.md` file selects Claude Code. You can select more than one when people on your team use different agents.

To skip the question, pass `--agent` once for each agent.

```sh
npx @adonisplus/flow install --agent=claude --agent=cursor
```

Flow saves your choice in `flow.lock`. Commit this file, so the next `npx @adonisplus/flow install` on any computer installs for the same agents.

## Where Flow writes its files

Codex CLI, Cursor, GitHub Copilot and OpenCode read the same two files: `AGENTS.md` for instructions, and `.agents/skills/` for skills. Flow writes its docs index to `AGENTS.md` and its skills to `.agents/skills/` once, and all four agents share them. Selecting more of these agents doesn't add more copies.

Claude Code reads only `CLAUDE.md` and `.claude/skills/`, so Flow writes its docs index and skills there too.

In `CLAUDE.md` and `AGENTS.md`, Flow writes only between its own markers, and leaves the rest of the file as you wrote it. Flow adds the skills and `.flow/docs/` to `.gitignore`, because `npx @adonisplus/flow install` writes them again.

### :icon{name="devicon:claude"} Claude Code

Select it with `--agent=claude`. It reads `CLAUDE.md` and `.claude/skills/`. Flow also writes the reviewer agent that the `flow-code-review` skill starts to `.claude/agents/`.

### :icon{name="devicon:codex"} Codex CLI

Select it with `--agent=codex`. It reads `AGENTS.md` and `.agents/skills/`. Flow also writes the reviewer agent that the `flow-code-review` skill starts to `.codex/agents/`.

### :icon{name="devicon:cursor"} Cursor

Select it with `--agent=cursor`. It reads `AGENTS.md` and `.agents/skills/`.

### :icon{name="devicon:githubcopilot"} GitHub Copilot

Select it with `--agent=copilot`. It reads `AGENTS.md` and `.agents/skills/`.

### :icon{name="simple-icons:opencode"} OpenCode

Select it with `--agent=opencode`. It reads `AGENTS.md` and `.agents/skills/`. In OpenCode, you can only run a skill by name if it's also a command, so Flow writes a command to `.opencode/commands/` for each skill you can start. `.opencode/opencode.json` stops OpenCode from starting `flow-apply` and `flow-code-re-review` on its own. If the file exists, Flow adds these two rules and keeps the rest.

### Other coding agents

Any agent that reads `AGENTS.md` and `.agents/skills/` gets Flow when you select Codex CLI, for example [:icon{name="logos:amp-icon"} Amp]{.brand} and [:icon{name="logos:google-gemini-icon"} Gemini CLI]{.brand}.

```sh
npx @adonisplus/flow install --agent=codex
```

:::note
Gemini CLI reads `GEMINI.md` by default. To make it read `AGENTS.md`, list both file names under `context.fileName` in its settings.

```json [.gemini/settings.json]
{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}
```
:::
