Skip to content

ForgeFlow CLI v0.2.0-preview.1 — Developer preview

Pre-release
Pre-release

Choose a tag to compare

View all tags
@rvnsre rvnsre released this 09 Nov 12:59
· 1 commit to main since this release
v0.2.0-preview.1
919694e

Coordinate coding tasks from your terminal

ForgeFlow CLI is an MIT-licensed Node.js tool that turns a detailed project prompt into scoped tasks, schedules independent work, and saves checkpoints for recovery.

ForgeFlow workflow illustration

Included in this preview

  • Dependency-aware scheduling with separate writable file scopes.
  • Configurable concurrency: 4 workers by default, up to 256 task slots.
  • Bounded retries and checkpoint/resume support.
  • Optional Playwright browser tools with compact semantic snapshots.
  • Context, tool output, estimated token, and API-call limits.
  • Structured run state and logs.
  • English setup documentation, contribution guidance, and issue templates.

Get started

Requires Node.js 20+ and an authorized API key from a compatible provider. Download the source archive below or clone the repository:

git clone https://github.com/rvnsre/forgeflow-cli.git
cd forgeflow-cli
node ./bin/forgeflow.mjs doctor
node ./bin/forgeflow.mjs --help

Set OPENAI_API_KEY in your terminal environment. Start with a small task in a disposable project copy:

node ./bin/forgeflow.mjs run --dir ./my-app --agents 2 "Inspect the README and improve the setup instructions to match the existing project."

See the README for PowerShell examples, optional browser setup, shell permissions, and provider configuration.

Preview status

Syntax checks and installation diagnostics have been run. Live provider/browser flows and cross-platform behavior still need reproducible validation. The 256-slot maximum is a configuration limit, not a benchmark or throughput claim. Shell execution uses your operating-system permissions and is not a container sandbox.

Help improve the next version

Try a small reproducible task and report a bug or suggest a workflow improvement. Include your OS, Node.js version, exact command, and redacted logs. Never share credentials.

Read the roadmap and contribution guide. If the project is useful to you, a star helps others discover it.

The illustration is conceptual artwork, not an application screenshot.

Assets 2
Loading