Repository navigation
Releases
foreman 4.5.2
No behavior change.
The README shows its banner, host cards, Ember scene and evidence graphics again, in assets/. The detail pages are back under docs/knowledge/: how it works, settings, limits and benchmarks.
The README now follows the shape and the wording the Foundry plugins share.
foreman 4.5.1
Antigravity
Foreman's roadmap guard runs again on current Antigravity. That host now sends a created file as write_file and an edit as edit_file, with the path in Path. Foreman watched only the three older tool names, so on Antigravity 1.5.9 a direct write or edit of ROADMAP.jsonl or .foreman/archive.jsonl was not refused. Foreman now watches both sets of names.
The write_file and edit_file payload shapes were observed on Antigravity 1.5.9. The guard under those names is covered by Foreman's tests and was not run in a live Antigravity session.
Antigravity installs are copies: pull your Foundry clone, run git submodule update --init, and run agy plugin install again to take this release.
Claude Code and Codex
No change in behaviour.
foreman 4.5.0
Claude Code
Foreman gains an optional Roadmap pane. In a project that has a ROADMAP.jsonl, a Roadmap button joins the mode labels in the prompt footer. It opens a pane that lists the roadmap in four groups: in progress, ready, blocked and deferred, with a search field and a card per entry.
- The pane only reads the roadmap file. It never writes it.
- A card's Resume, Accept or Pick button sends one request as the next prompt, such as "Pick roadmap entry 12 with Foreman". Foreman's pick flow then takes that entry. To prompt puts the same request in the prompt box without sending it.
- In a project without a roadmap nothing is drawn.
- A roadmap line Foreman cannot read is named in the pane.
- The pane speaks English and Spanish, by the
languagesetting, and adds no slash command.
The pane needs Claude Code 2.1.323 or later. It was seen in the desktop app, in the dark theme and in Spanish. The light theme, English and the terminal were not seen. The pane is for Claude Code only: Codex's and Antigravity's manifests and hook files change only in the version.
Every host
scripts/roadmap.js now answers an unknown get or show subcommand with the way to read one entry, list --ids <id>, and an unknown help with --help.
The repository now holds only what Foreman uses at run time, plus its tests, CI, LICENSE, SECURITY.md and CONTRIBUTING.md, so an install downloads less. The README is text only and names Claude Code as the primary host, with Codex and Antigravity as compatibility hosts. Release notes now live on this page; the repository carries no changelog file.
foreman 3.3.0
Every host
- Foreman has a new icon: a green tag with a plumb line, from Foundry's
hallmark-seal identity. The README banner, wordmark and Codex plugin icon use
it. The Ember scene now ends with a stamp pressing that seal onto the answer,
and each README graphic carries the seal in a corner. No recorded text,
number or timing in the graphics changed.
Codex
- After you update Foreman, review and trust its hooks again in
/hooks.
Codex runs a hook only after you trust it. This update adds a hook on
collaborationspawn_agentand addsBashto the matcher of the decision
recall hook. Both change the hook registrations, so until you trust them
again, Codex does not run the new hook or the decision recall hook at all. - On Windows, each hook now starts Node from cmd instead of PowerShell. Each
command in the Codex shell starts two Foreman hooks. On the test machine,
those two hooks now take about 0.6 seconds less in total. When PATH has no
Node, the hooks still find it through a configured fnm default. This changes
the command of every Foreman hook. Until you trust the hooks again in
/hooks, Codex runs none of them. - A subagent that carries a roadmap entry's handoff is now named
foreman_<id>, for exampleforeman_042. When it stops, Foreman ties its
finish to that entry. WithtaskCloseGateset to"block", the session that
spawned it is blocked once from ending its turn while the entry is still
plannedorin_progress. An entry awaiting acceptance, or already closed,
passes. So does an entry whose last note line ispaused:or
review pending:, so eachcollaborationfollowup_taskto a subagent whose
review is pending does not block the coordinator again. An explicit
codex-task.js checkstill blocks once on such an entry. - A
task_namethat isforemanor starts withforeman_is refused unless
it is exactlyforeman_<id>for an entry inROADMAP.jsonl. Every other
name passes, and a handoff spawned under another name runs normally, but its
finish is not tied to its entry. - A reviewed increment that is paused or gets no answer now records
Codex session <session id>in its note. You can continue it from a new
process withcodex exec resume <session id> -. The-makes Codex read
your decision from standard input, so the shell does not parse it. Type or
paste the decision, then end input with Ctrl+D in a POSIX shell or Ctrl+Z
and Enter in PowerShell or cmd. A new session that finds the note offers this
command before it crafts the work again. - When a command's output contains a
[Foreman: <id>]anchor and the decision
documents folder has<id>.md, Foreman now tells the model to read that
document before it changes what the anchor governs. Codex reads files
through its shell, so this covers files it reads that way. One notice names
at most 20 decision documents and says how many it left out. Recorded
lessons are still recalled only when Codex usesapply_patch,Read,Edit
orWriteon the file. Claude Code keeps decision recall onRead,Edit
andWrite.