agent-factory

Agent Factory (`af`) is a tool designed to run a fleet of AI coding agents simultaneously, providing isolated workspaces and a unified control plane. It supports various agents including Claude Code, Codex, Aider, Gemini, Amp, opencode, and Devin. Each agent operates within its own git branch and git worktree, ensuring that parallel agents do not share checkouts and that results are returned as standard git branches for easy review and merging. The system is driven by a background daemon that maintains state, keeps sessions active even when client windows are closed, schedules recurring tasks, and serves a web client. Users can interact with Agent Factory through three primary surfaces that all connect to the same daemon state: 1. **Web Client**: Accessible at `http://localhost:8443` by default, it provides a browser-based interface for managing sessions, viewing real terminals, handling tasks, and configuring settings. 2. **Terminal UI (TUI)**: Launched via the `af` command within a git repository, it offers a dense interface for managing sessions, allowing in-place interaction and full-screen attachment to agent terminals. 3. **CLI**: Provides JSON output for commands like `af sessions` and `af tasks`, enabling scripting and integration with other automated tools to create, prompt, watch, and archive sessions. Key concepts include: - **Session**: An individual agent working on a specific task with its own lifecycle. - **Worktree**: An isolated checkout and branch for each session to prevent collisions. - **Daemon**: The background process managing state and serving clients. - **Task**: Prompts scheduled via cron or triggered by watch commands. - **Account**: Named credential homes for agents to manage different logins. Installation requires tmux, git, and at least one supported agent CLI on Linux, macOS, or WSL2. It can be installed via a shell script or built from source with Go. The tool also supports running sessions in containers or on remote machines via SSH.