AI Flow — Overview¶
AI Flow is an IntelliJ IDEA plugin that brings a coding agent's panel straight into the IDE: queues of tasks, a kanban board per flow, and the agent's own terminal next to it. It drives Claude Code today, with Codex and GitHub Copilot behind the same driver abstraction.
📷 Screenshot — the AI Flow panel, with a running flow: kanban board on the left, agent console on the right.
Key concepts¶
- Flow — one working session with an agent, shown as one tab in the panel. A project can run several flows in parallel, each with its own agent, branch, and console.
- Kanban board — every flow has a four-column board: Waiting, In progress, To test, Done. Issues move across it as the agent works through them — see Board.
- Card — one issue on the board. It can come from the Gotan Project Dashboard plugin (if installed) or be a purely local task typed directly into AI Flow.
- Agent — the command-line tool actually doing the work in a real terminal, so you can answer its permission prompts yourself. Claude Code is supported today; Codex and GitHub Copilot are recognized by the same abstraction, ready to be enabled as their CLIs mature.
- Way of working — how a flow touches the repository: on the main branch directly, or in its own worktree (a separate working copy, so the one you have open stays untouched).
Requirements¶
- IntelliJ IDEA 2026.2 or newer.
- A Git repository for the current project (for worktree-based flows and the commit/merge actions).
- At least one agent CLI installed and on the shell's
PATH— for example theclaudecommand for Claude Code. - Optionally, the Gotan Project Dashboard plugin, to feed the kanban board with real issues from Jira/Redmine instead of local-only cards.
Getting started¶
- Open the AI Flow tool window (bottom of the IDE, or Tools → AI Flow → New flow).
- Click Add a flow, give it a name, and pick its way of working (main branch or worktree).
- Drop an issue onto the board from the Dashboard panel or the issue list — or double-click the Waiting column to type a local task, if the setting allows it.
- Press Start (or hit Enter when a card is waiting: the button is armed). The agent picks up the first waiting issue and starts working in its console — see Console.
- Watch progress on the board: issues move from Waiting to In progress, then to To test once the agent is done, and finally to Done once you approve them.
See also: Board · Console · Toolbar · Notifications · Settings