flow

Flow

Measure twice, code once.

Flow is a unified toolkit for Context-Driven Development that works with Claude Code, Gemini CLI, Codex CLI, OpenCode, VS Code / Copilot, Cursor, Google Antigravity, and OpenClaw. It combines spec-first planning with Beads for persistent cross-session memory, enabling AI-assisted development with deep, persistent project awareness.

Philosophy

Control your code. By treating context as a managed artifact alongside your code, you transform your repository into a single source of truth that drives every agent interaction. Flow ensures a consistent, high-quality lifecycle for every task:

Lifecycle: Context → Spec & Plan → Implement → Learn

Key Features

• Beads Integration: Persistent task memory that survives context compaction
• Multi-CLI Support: Works with Claude Code, Gemini CLI, Codex CLI, OpenCode, VS Code / Copilot, Cursor, Google Antigravity, and OpenClaw
• Spec-First Development: Create specs and plans before writing code
• TDD Workflow: Red-Green-Refactor with >80% coverage requirements
• Knowledge Flywheel: Capture and elevate patterns across flows (Ralph-style)
• Flow Management: Revise, archive, and revert with full audit trail
• Git-Aware Revert: Understands logical units of work, not just commits
• Parallel Execution: Phase-level task parallelism via sub-agents

Install

Each host has a native plugin/extension system. Use it. The tools/install.sh script is a multi-host orchestrator for users who want to install Flow across several CLIs at once — it just runs the same native commands for you.

Gemini CLI

gemini extensions install https://github.com/cofin/flow --auto-update

Update with gemini extensions update flow. Use gemini extensions link . only for local development against a checkout — Gemini copies installed extensions, so linked development and installed releases are different workflows.

{
  "general": {
    "plan": {
      "enabled": true,
      "modelRouting": true
    }
  }
}

Claude Code

claude plugin marketplace add cofin/flow
claude plugin install flow@flow-marketplace

This installs Flow at user scope (~/.claude/plugins/...). Restart Claude Code after install. The plugin ships skills, commands, and hooks; Claude-specific subagents remain optional and are not bundled in the current release.

claude plugin marketplace update flow-marketplace
claude plugin update flow@flow-marketplace

{
  "plansDirectory": ".agents/specs"
}

{
  "permissions": {
    "defaultMode": "plan"
  }
}

Codex CLI

codex plugin marketplace add cofin/flow

Then in a Codex session, run /plugins and enable Flow. Update with codex plugin marketplace upgrade flow-marketplace.

Codex CLI 0.117+ supports first-class marketplace commands — add accepts owner/repo[@ref], HTTPS/SSH git URLs, or local paths, with optional --ref <REF> and --sparse <PATH>.

Codex plugins do not currently expose plugin-defined /flow:* slash commands. Use Flow through the installed Flow skill with natural-language requests such as Use Flow to set up this project.

plan_mode_reasoning_effort = "high"