Agent workflows
Forge
Forge combines structured tasks, dependency tracking, and a web interface for controlling agent-driven development. A connected local worker prepares isolated worktrees, runs Codex, coordinates checks and review, and uses Rail to publish changes and release the approved revision.
Key features
- Projects and structured task specifications with dependencies, a task graph, status history, and reusable preparation prompts.
- A local worker that prepares worktrees, installs project instructions and dependencies, and runs Codex.
- Local check and GitHub CI cycles that return failures to the agent for fixes.
- Codex pull request review and human feedback that can continue the existing agent session.
- Stage history, results, and errors in the web interface, with full-pipeline or single-step execution.
- Git workflow management through Rail.
Technical design
The React interface connects to a FastAPI backend backed by PostgreSQL. The backend dispatches work to a connected local worker over WebSocket. The worker runs Codex in task worktrees, uses Rail for Git operations, and interacts with GitHub for CI and review.
Loading diagram…
Development workflow
Start a task from the web interface to prepare a worktree and run Codex. Rail checks and publishes the changes as a pull request; failed local checks or CI can return to the agent for fixes.
Codex review findings can be sent back to the implementation agent for fixes, followed by publication and CI validation. Human review can trigger another fix and validation cycle. Explicit approval of the checked revision allows Rail to merge, tag, and clean up. The workflow can advance automatically or one step at a time.
Loading diagram…
Git workflow with Rail
Forge coordinates task execution and review. Rail creates worktrees, runs configured checks, prepares pull requests, and merges approved changes with tagging and cleanup. The same Git workflow is also available independently through the Rail CLI and Python API.