freshcrate
Home > Frameworks > flow-next

flow-next

Plan-first AI workflow plugin for Claude Code, OpenAI Codex, and Factory Droid. Zero-dep task tracking, worker subagents, Ralph autonomous mode, cross-model reviews.

ai-agentai-workflowanthropicautonomous-agentclaude-codeclaude-code-pluginclicode-reviewpython

Description

Plan-first AI workflow plugin for Claude Code, OpenAI Codex, and Factory Droid. Zero-dep task tracking, worker subagents, Ralph autonomous mode, cross-model reviews.

README

Flow-Next

License: MIT Flow-next Docs

Author Twitter Sponsor Discord

Plan-first AI workflow. Zero external dependencies.

💬 Join the Discord — discussions, updates, feature requests, bug reports

What Is This?

Flow-Next is an AI agent orchestration plugin. Bundled task tracking, dependency graphs, re-anchoring, and cross-model reviews. Everything lives in your repo — no external services, no global config. Uninstall: delete .flow/.

Works on Claude Code, OpenAI Codex (CLI + Desktop), Factory Droid, and OpenCode.

Install

Claude Code OpenAI Codex Factory Droid 
/plugin marketplace add \
  https://github.com/gmickel/flow-next
/plugin install flow-next
/flow-next:setup
 
git clone https://github.com/gmickel/flow-next.git
cd flow-next && codex
# /plugins → install Flow-Next
# then: $flow-next-setup
 
droid plugin marketplace add \
  https://github.com/gmickel/flow-next
# /plugins → install flow-next

Update Codex: cd flow-next && git pull, then /plugins → uninstall → install.

📖 Full docs · Codex install guide · OpenCode port

Why It Works

Problem Solution
Context drift Re-anchoring before every task — re-reads specs + git state
Context window limits Fresh context per task — worker subagent starts clean
Single-model blind spots Cross-model reviews — RepoPrompt or Codex as second opinion
Forgotten requirements Dependency graphs — tasks declare blockers, run in order
"It worked on my machine" Evidence recording — commits, tests, PRs tracked per task
Infinite retry loops Auto-block stuck tasks — fails after N attempts, moves on
Duplicate implementations Pre-implementation search — worker checks for similar code before writing new

Commands

Command What It Does
/flow-next:plan Research codebase, create epic + tasks
/flow-next:work Execute tasks with re-anchoring
/flow-next:interview Deep spec refinement (40+ questions)
/flow-next:impl-review Cross-model implementation review
/flow-next:plan-review Cross-model plan review
/flow-next:epic-review Epic-completion review gate
/flow-next:prime Assess codebase agent-readiness
/flow-next:ralph-init Scaffold autonomous loop

Ralph (Autonomous Mode)

Run overnight. Fresh context per iteration + multi-model review gates + auto-block stuck tasks.

/flow-next:ralph-init           # One-time setup
scripts/ralph/ralph.sh          # Run from terminal

📖 Ralph deep dive · Ralph TUI (bun add -g @gmickel/flow-next-tui)

Ecosystem

Project Platform
flow-next-opencode OpenCode
FlowFactory Factory.ai Droid

Also Check Out

GNO — Local hybrid search for your notes, docs, and code. Give Claude Code long-term memory over your files via MCP.

bun install -g @gmickel/gno && gno mcp install --target claude-code

Made by Gordon Mickel · @gmickel · gordon@mickel.tech

SponsorRelease History

VersionChangesUrgencyDate
flow-next-v0.29.4 ### Fixed - **rp-cli 2.1.6: builder output missing tab/context ID** — `cmd_rp_builder` and `cmd_rp_setup_review` now always pass `--raw-json` to builder (was conditional on `--response-type`). RP 2.1.6 removed the `Tab:`/`Context:` text line from plain-text output; IDs are only in JSON mode. JSON parse tried first, regex fallback for older RP versions. Closes #109. Thanks @berhanbero - **Python 3.12+ `datetime.utcnow()` deprecation** — replaced with `datetime.now(timezone.utc)` in `now_iso()` aHigh4/12/2026
flow-next-v0.29.2 ### Fixed - **RepoPrompt 2.1.4 `Context:` builder output** — `flowctl rp builder` / `flowctl rp setup-review` now accept the new `Context: <uuid>` text format and `context_id`/`context`/`contextId` JSON keys alongside the legacy `Tab:` / `tab_id` shapes. Downstream `--tab` flag unchanged; legacy paths still tried first for backward compat. CI regression coverage added. Thanks @clairernovotny — [#106](https://github.com/gmickel/flow-next/pull/106)High4/9/2026
flow-next-v0.29.1 ### Fixed - **RepoPrompt workspace leak in setup-review** — Ralph sessions with `WORK_REVIEW=rp` could accumulate dozens of duplicate RepoPrompt workspaces/windows for the same repo when window matching fell through to `workspace create --new-window` on every retry. Now falls back through three layers: `bind_context` (RP's native repo-path matching, newest API) → workspace inventory lookup by repo path → last-resort creation. Hidden workspaces are reopened via `manage_workspaces switch` insteadHigh4/8/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

anty-frameworkAI Workforce plugin for Claude Code — proactive sales & marketing strategy for startup founders. 24 domain knowledge skills, 10 commands, 4 AI agents. Integrates 15+ strategic frameworks.v0.1.0
Agent_Life_SpaceSelf-hosted autonomous AI agent — 9-layer cascade, Docker sandbox, encrypted vault, review/build/control plane, 1407+ testsv1.36.0
claude-context-os🧠 Enhance Claude AI context retention by optimizing prompt efficiency and enabling seamless session handoff for consistent memory across interactionsmain@2026-04-21
aiA productive AI coworker that learns, self-improves, and ships work.main@2026-04-21
ralph-claude-codeNo descriptionmain@2026-04-21