Coding agents
On this page
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.
Installing for your agents
Section titled "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.
npx @adonisplus/flow install --agent=claude --agent=cursorFlow 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
Section titled "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.
Claude Code
Section titled "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/.
Codex CLI
Section titled "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/.
Cursor
Section titled "Cursor"Select it with --agent=cursor. It reads AGENTS.md and .agents/skills/.
GitHub Copilot
Section titled "GitHub Copilot"Select it with --agent=copilot. It reads AGENTS.md and .agents/skills/.
OpenCode
Section titled "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
Section titled "Other coding agents"Any agent that reads AGENTS.md and .agents/skills/ gets Flow when you select Codex CLI, for example Amp and Gemini CLI.
npx @adonisplus/flow install --agent=codexNote
Gemini CLI reads GEMINI.md by default. To make it read AGENTS.md, list both file names under context.fileName in its settings.
{
"context": {
"fileName": ["AGENTS.md", "GEMINI.md"]
}
}