🏄🏼‍♂️ agtx

The blackboard for coding agents - 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

Capture ideas without leaving your agent session — /agtx:brainstorm to explore freely, /agtx:sweep to push the conversation to the board as tasks in one step.

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.

When ideas come up mid-session, /agtx:brainstorm keeps your agent in exploration mode — then /agtx:sweep turns the conversation into board tasks with a single confirmation step. No context switching, no copy-pasting — ideas flow directly into work.

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)
• Brainstorm & Sweep skills: Capture ideas and push them to the board from any coding agent session — /agtx:brainstorm to explore freely, /agtx:sweep to decompose and create tasks with one confirmation step (details)
• 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/

Requirements

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

Usage

| 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) | | Ctrl+f | Fullscreen attach to task's tmux 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 |

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

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

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

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 Sessions

Each task runs in its own tmux window with a dedicated coding agent. The session persists across the entire task lifecycle — you can open the task popup at any time to see live agent output, or press Ctrl+f to attach fullscreen.

• Persistent context: The agent's full conversation history is preserved across Planning → Running → Review
• Resume from Review: Moving a task back to Running simply reconnects to the existing session — no re-initialization needed
• Inline view: Press ↩ on any active task to open a scrollable tmux view inside the TUI
• Fullscreen: Press Ctrl+f to attach directly to the agent's tmux window
• Auto merge-conflict resolution: When a Review task becomes idle, agtx checks for merge conflicts with the default branch using a non-destructive virtual merge (git merge-tree). If conflicts are detected, the agent is automatically sent the /agtx:merge-conflicts skill to resolve them and re-commit

Brainstorm & Sweep Skills

Two companion skills for capturing ideas in any coding agent session and turning them into tasks in the agtx board.

| Skill | Command | When to use | |-------|---------|-------------| | Brainstorm | /agtx:brainstorm | Explore a feature idea — discussion only, no planning or implementation | | Sweep | /agtx:sweep | Push conversation outcomes to the agtx board as tasks |

Typical flow:

/agtx:brainstorm   ← explore the idea freely
      ↓
/agtx:sweep        ← extract tasks, confirm, push to board
      ↓
agtx board         ← tasks appear in Backlog, ready to advance

The brainstorm skill keeps the agent in discussion mode — asking questions, surfacing trade-offs, no code or plans. When the conversation feels complete, run /agtx:sweep to decompose outcomes into feature-level tasks and push them to the board with a single confirmation step.

Install

claude plugin marketplace add fynnfluegge/agtx
claude plugin install agtx@agtx-marketplace
claude mcp add --scope user agtx -- agtx mcp-serve

codex mcp add agtx -- agtx mcp-serve

Add to your project's .agents/plugins/marketplace.json:

{
  "name": "local-repo",
  "plugins": [
    {
      "name": "agtx",
      "source": {