agentdev

Features

• Git worktree management for parallel, multi-agent development
• Worktrees / Sessions UI for inspecting local runs
• Run multiple agents on the same task for a "race" comparison 🏇 (planned)
• Supports ANY CLI coding agents
  • Sessions UI currently supports: Kimi CLI, Codex, Claude Code

Installation

Prerequisites:

• Install Rust
• Install pnpm

cargo install --git https://github.com/xxchan/AgentDev agentdev

Configuration

Configure your agent pool in ~/.config/agentdev/config.toml. Use the comments in the default file for guidance or consult config.example.toml.

Usage

UI

agentdev ui --port 9999

• /sessions: inspect every local agent session (works without agentdev)
• /worktrees: inspect agentdev-managed worktrees, their agent sessions, and git diffs

Worktree-driven local parallel development

# Create a worktree and start an agent session
agentdev wt create

# Run a command inside a worktree, e.g., `pnpm dev`, `code .`
agentdev wt exec <cmd>

# Merge a worktree back to main or delete it
agentdev wt [merge|delete] <worktree>

# Inspect everything agentdev is tracking
agentdev wt list

Parallel multi-agent race (planned)

agentdev start "Research this project and summarize it in a file"
# Run only specific agents and explicitly name the task
agentdev start "Research this project and summarize it in a file" --agents claude,codex --name research

agentdev delete-task <task>