# Foreman

Foreman keeps a project roadmap beside the code for Claude Code, Codex and Antigravity, and recommends the next task with its reasoning checked against the current state of the files before you start it.

Foreman is meant to preserve continuity between coding sessions: it records requested work with its reason and boundaries, tracks status, blockers and work waiting for acceptance, and when asked "what's next", checks a candidate task's assumptions against the project's actual files before recommending it. Optional lessons let a later task learn from earlier ones without maintaining a separate knowledge base, and acceptance of finished work is always kept as a separate decision from a passing test run.

It is used through plain-language requests or through each assistant's own command style - slash commands in Claude Code, a named skill in Codex, or a slash command in Antigravity - and installs as one plugin shared across all three.

It is written in JavaScript.

Website: https://github.com/V-Songbird/foreman