agtx

An AI agent that manages other coding agents in a terminal kanban board - Add tasks. Press one key. An orchestrator agent picks it up, plans, and delegates to multiple coding agents running in parallel. Come back to changes ready to merge.

Let different AI coding agents collaborate autonomously on the same task with automatic session switching and context awareness -
e.g. Gemini → research | Claude → implement | Codex → review

</div>

Why agtx?

AI coding tools give you one agent, one task, one terminal. agtx gives you a kanban board where multiple coding agents work in parallel — each in its own git worktree, each in its own tmux window, running autonomously through a spec-driven workflow managed by an orchestrator agent.

With the orchestrator, you don't even manage the board yourself. An AI agent picks up tasks, delegates work, and ensures getting things done through planning, implementation, review and resolving conflicts — while you focus on what matters: research, defining tasks, and merging changes.

[!TIP] Check out the Contributing section or have a look at good first issues to get involved and become a contributor ⭐️

Features

Orchestrator agent: A dedicated AI agent that autonomously manages your kanban board via MCP — delegates to coding agents, advances phases, checks for merge conflicts (experimental)
Multi-agent task lifecycle: Configure different agents per workflow phase — e.g. Gemini for research, Claude for implementation, Codex for review — with automatic agent switching
Parallel execution: Every task gets its own git worktree and tmux window — run as many agents as needed, simultaneously
Spec-driven plugins: Plug in GSD, Spec-kit, OpenSpec, BMAD, Superpowers — or define your own with a single TOML file
Multi-project dashboard: Manage agent sessions across all projects via a single TUI
Works with: Claude Code | Codex | Gemini CLI | OpenCode | Cursor Agent | Copilot

[!NOTE] Just need a plain coding agent session manager with full human-in-the-loop control and no automatic spec-driven skill execution and orchestration on advancing tasks?

Choose the void plugin and enjoy the kanban coding agent board - with full human control.

Quick Start

# Install
curl -fsSL https://raw.githubusercontent.com/fynnfluegge/agtx/main/install.sh | bash

# Run in any git repository
cd your-project && agtx

# Dashboard mode — manage all projects
agtx -g

# Orchestrator mode — let an AI manage the board for you
agtx --experimental

[!NOTE] Add .agtx/ to your project's .gitignore to avoid committing worktrees and local task data.

# Install from source
cargo build --release
cp target/release/agtx ~/.local/bin/

</details>

Requirements

tmux — agent sessions run in a dedicated tmux server
gh (optional) — GitHub CLI for PR operations

Usage

Keyboard Shortcuts

| Key | Action | |-----|--------| | h/l or ←/→ | Move between columns | | j/k or ↑/↓ | Move between tasks | | o | Create new task | | R | Enter research mode | | ↩ | Open task (view agent session) | | m | Move task forward in workflow | | r | Resume task (Review → Running) / Move back (Running → Planning) | | p | Next phase (Review → Planning, cyclic plugins only) | | d | Show git diff | | x | Delete task | | / | Search tasks | | P | Select spec-driven workflow plugin | | O | Toggle orchestrator agent (--experimental) | | e | Toggle project sidebar | | q | Quit |

Task Creation Wizard

Press o to create a new task. The wizard guides you through:

Title — enter a short task name
Plugin — select a workflow plugin (auto-skipped if only one option)
Prompt — write a detailed task description with inline references

The agent is configured at the project level via config.toml (not per-task).

Task Description Editor

When writing a task description, you can reference files, skills, and other tasks inline:

| Key | Action | |-----|--------| | # or @ | Fuzzy search and insert a file path | | / | Fuzzy search and insert an agent skill/command (at line start or after space) | | ! | Fuzzy search and insert a task reference (at line start or after space) |

Agent Session Features

Sessions automatically resume when moving Review → Running
Full conversation context is preserved across the task lifecycle
View live agent output in the task popup
Auto merge-conflict resolution: When a Review task becomes idle, agtx checks for merge conflicts with the default branch. If conflicts are detected, the agent is automatically instructed to resolve them.

Configuration

Config file location: ~/.config/agtx/config.toml

Worktree Base Branch

agtx creates a new git worktree for each task. By default it auto-detects the base branch in this order: main, then master, then the current branch. You can override this to force a specific base branch (for example dev or develop).

Global worktree defaults can be set here:

# ~/.config/agtx/config.toml
[worktree]
base_branch = "dev"

Project Configuration

Per-project settings can be placed in .agtx/config.toml at the project root:

# Base branch used when creating new task worktrees (optional)
base_branch = "dev"

# Files to copy from project root into each new worktree (comma-separated)
# Paths are relative and preserve directory structure
copy_files = ".env, .env.local, web/.env.local"

# Shell command to run inside the worktree after creation and file copying
init_script = "scripts/init_worktree.sh"

base_branch controls which branch new task worktrees are created from. If omitted or empty, agtx auto-detects main, master, or falls back to the current branch.

These options run during the Backlog → Research/Planning/Running transition, after worktree creation and before the agent session starts.

Per-Phase Agent Configuration

By default, all phases use default_agent. You can override the agent for specific phases globally or per project:

# ~/.config/agtx/config.toml
default_agent = "claude"

[agents]
research = "gemini"
planning = "claude"
running = "claude"
review = "codex"

# .agtx/config.toml (project override — takes precedence over global)
[agents]
running = "codex"

Plugins

Plug any spec-driven framework into the task lifecycle. Define commands, prompts, and artifacts — agtx handles phase gating, artifact polling, worktree sync, agent switching, and autonomous execution.

Press P to switch plugins. Ships with 7 built-in:

| Plugin | Description | |--------|-------------| | void | Plain agent session - no prompting or skills, task description prefilled in input | | agtx (default) | Built-in workflow with skills and prompts for each phase | | gsd | Get Shit Done - structured spec-driven development with interactive planning | | spec-kit | Spec-Driven Development by GitHub - specifications become executable artifacts | | openspec | OpenSpec - lightweight AI-guided specification framework | | bmad | BMAD Method - AI-driven agile development with structured phases | | superpowers | Superpowers - brainstorming, plans, TDD, subagent-driven development |

Agent Compatibility

Commands are written once in canonical format and automatically translated per agent:

| Canonical (plugin.toml) | Claude / Gemini | Codex | OpenCode | Cursor | |--------------------------|-----------------|-------|----------|--------| | /agtx:plan | /agtx:plan | $agtx-plan | /agtx-plan | /agtx-plan |

| | Claude | Codex | Gemini | OpenCode | Cursor | Copilot | |--|:------:|:-----:|:------:|:--------:|:------:|:-------:| | agtx | ✅ | ✅ | ✅ | ✅ | ✅ | 🟡 | | gsd | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | | spec-kit | ✅ | ✅ | ✅ | ✅ | ✅ | 🟡 | | openspec | ✅ | ✅ | ✅ | ✅ | ✅ | 🟡 | | bmad | ✅ | ✅ | ✅ | ✅

Agtx

Install / Use

README