Flow officially supports five coding agents: Claude Code, Codex CLI, Cursor, GitHub Copilot and OpenCode. Other agents that read AGENTS.md and .agents/skills/ work with Flow too. See Other coding 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.

Terminal
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.

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.

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

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

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

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

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.

Any agent that reads AGENTS.md and .agents/skills/ gets Flow when you select Codex CLI, for example Amp and Gemini CLI.

Terminal
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.

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