Foreman

Foreman is a terminal app for developers who want to supervise Claude Code agents working in a repository. It takes feature requests through planning, design review and implementation, with human approval before agents begin the build.

• Design approvals: You review plans, requirements and the issue queue; unresolved design questions block approval, and edits to approved documents invalidate that approval.
• Parallel workers: Agents work in separate Git worktrees, and declared file boundaries prevent workers with overlapping tasks from running concurrently.
• Run limits: Foreman enforces time, turn and spending limits, retry caps and a daily spending ceiling, and blocks workers from writing their own verification records.
• Progress monitoring: The keyboard-driven interface shows feature status, worker activity, costs and requests for attention.
• Reviewed workflow changes: Failure metrics help identify recurring problems, while proposed skill and prompt changes require human review and a benchmark report before acceptance.

The supervisor runs locally on Linux or WSL2, with development and testing on Ubuntu under WSL2. It requires Python, Git and an installed, authenticated Claude Code CLI for live agent work. Foreman delegates model work to that CLI rather than supplying its own local model backend. The demo uses a mocked backend.

Workflow state lives in readable files inside the target repository, without a database. Interrupted work can resume from those files after a restart.