https://github.com/inputforge/agentforge
A Kanban board that spawns AI coding agents (Claude Code, Codex, or any CLI) in isolated git worktrees
https://github.com/inputforge/agentforge
agents claude-code codex orchestration
Last synced: about 2 months ago
JSON representation
A Kanban board that spawns AI coding agents (Claude Code, Codex, or any CLI) in isolated git worktrees
- Host: GitHub
- URL: https://github.com/inputforge/agentforge
- Owner: inputforge
- License: bsd-2-clause
- Created: 2026-04-10T14:53:43.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-30T09:01:40.000Z (about 2 months ago)
- Last Synced: 2026-04-30T13:35:14.564Z (about 2 months ago)
- Topics: agents, claude-code, codex, orchestration
- Language: TypeScript
- Homepage: https://www.inputforge.com/agentforge
- Size: 411 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: docs/agents.md
Awesome Lists containing this project
README
# AgentForge
A Kanban board that spawns AI coding agents (Claude Code, Codex, or any CLI) in isolated git worktrees — one agent per ticket.
## Getting started
```bash
bun install
bun run dev
```
Open [http://localhost:5173](http://localhost:5173). The backend runs on port `3001`.
### Prerequisites
- [Bun](https://bun.sh) runtime
- At least one AI coding agent installed (e.g. `claude`, `codex`, `aider`)
## Usage
### 1. Connect your repository
Set the `REPO_PATH` environment variable to point at the repository you want agents to work in, or run AgentForge from inside that repo. The header shows the active repo URL and current branch once detected.
### 2. Create a ticket
Click **+ TICKET** in the header and describe the task. The first line becomes the ticket title automatically. Check **Start now** to immediately move the ticket to **In Progress**.
### 3. Launch an agent
Drag the ticket to **IN PROGRESS** (or click it). A launcher panel opens — pick an agent:
| Agent | Command used |
| ---------- | --------------------------------------- |
| **Claude** | `claude --dangerously-skip-permissions` |
| **Codex** | `codex` |
| **Custom** | Any CLI you type in |
AgentForge creates an isolated git worktree and branch (`agent/`) and spawns the agent inside it.
### 4. Watch and interact
The panel shows a live terminal on the left and a diff view on the right. You can type directly in the terminal if the agent needs input. If the agent exits with an error, a **RELAUNCH** button appears to restart it in the same worktree.
### 5. Review and merge
When the agent finishes, the ticket moves to **REVIEW** automatically. Click **MERGE TO MAIN** to rebase the agent branch onto your base branch. On success the ticket moves to **DONE** and the worktree is cleaned up.
You can also drag tickets between columns manually at any point, **KILL** a running agent to stop it, or open the built-in **TERMINAL** (header) for a shell in the configured repository.
## Commands
```bash
bun run dev # frontend + backend with hot-reload
bun run dev:backend # backend only
bun run dev:frontend # frontend only (Vite on :5173)
bun run typecheck # type-check all packages
bun run build # production build
bun run start # run production build
```
## Configuration
| Environment variable | Default | Purpose |
| -------------------- | --------------- | ------------------------------ |
| `PORT` | `3001` | Backend port |
| `REPO_PATH` | `process.cwd()` | Git repo for agents to work in |
## Stack
| | |
| -------- | ---------------------------------- |
| Runtime | Bun |
| Backend | Hono + Bun WebSockets |
| Database | SQLite (`bun:sqlite`) |
| Frontend | React 18, Zustand, Tailwind CSS v4 |
| Terminal | xterm.js + node-pty |
| Git | simple-git (worktrees) |