flow-marketplace

Flow

Measure twice, code once.

Flow is a unified toolkit for Context-Driven Development that works with Claude Code, Gemini CLI, Codex CLI, OpenCode, and Google Antigravity. 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:

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, and Google Antigravity
• 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

Quick Start

Installation

Intelligent Installer (Recommended)

The install script detects your CLIs, backs up existing configs, and merges intelligently:

# Clone the repo
git clone https://github.com/cofin/flow.git
cd flow

# Run installer
./tools/install.sh

The installer supports:

• Claude Code (~/.claude/)
• Codex CLI (~/.codex/)
• OpenCode (~/.config/opencode/)
• Google Antigravity (~/.gemini/antigravity/skills/)

Note: Gemini CLI now uses native extension installation: gemini extensions install flow

Installation

Flow can be installed as a native plugin or extension on supported AI CLI platforms.

Gemini CLI

gemini extensions install https://github.com/cofin/flow

To update:

gemini extensions update flow

Claude Code

Install Flow via marketplace (recommended for reliability):

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

This installs Flow at user scope (~/.claude/plugins/...).

To update explicitly:

claude plugins marketplace update flow-marketplace
claude plugins update flow@flow-marketplace

Direct GitHub install may work in some Claude builds via interactive /plugin commands, but claude plugins install resolves plugin@marketplace sources and can reject flow@git+https://github.com/cofin/flow.git in non-interactive mode.

OpenCode

Add Flow to your global or project-level opencode.json:

{
  "plugin": ["flow@git+https://github.com/cofin/flow.git"]
}

Restart OpenCode to auto-register all skills and commands.

Cursor IDE

Install Flow from the plugin system:

/add-plugin flow

Or add to your .cursor-plugin configuration manually.

Codex CLI

Install Flow as a Codex plugin:

1. Clone Flow:

   git clone https://github.com/cofin/flow.git ~/.codex/plugins/flow
   

2. Create marketplace entry at ~/.agents/plugins/marketplace.json:

   {
     "name": "personal-plugins",
     "interface": { "displayName": "Personal Plugins" },
     "plugins": [
       {
         "name": "flow",
         "source": { "source": "local", "path": "~/.codex/plugins/flow" },
         "policy": { "installation": "AVAILABLE" },
         "category": "Development"
       }
     ]
   }
   

3. Restart Codex. Run /plugins to verify Flow appears.

Current Codex plugin support does not 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 or Use Flow to create a PRD for add user authentication. Older preview-era Codex builds may have used hyphenated Flow commands such as /flow-setup, but Flow no longer assumes those preview-only aliases are available.

Legacy Installation (bash)

For manual installation or custom environments:

curl -fsSL https://raw.githubusercontent.com/cofin/flow/main/tools/install.sh | bash

Initialize a Project

# Claude Code
/flow-setup

# Gemini CLI / OpenCode
/flow:setup

In Codex CLI, ask: Use Flow to set up this project

Flow will:

1. Check/install Beads
2. Initialize Beads
3. Create project context files
4. Guide you through product, tech stack, and workflow setup
5. Create your first flow

Create a Flow

# Claude Code
/flow-prd "Add user authentication"

# Gemini CLI / OpenCode
/flow:prd "Add user authentication"

In Codex CLI, ask: Use Flow to create a PRD for add user authentication

This creates: