Agent Tmux Toolkit banner
barnierg76 barnierg76

Agent Tmux Toolkit

Productivity community

Description

tmux-based workflow for running multiple Claude Code agents in parallel

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Agent Tmux Toolkit

A tmux-based workflow for running multiple AI agents in parallel with **compound engineering integration** - snippet support, session management, and git worktree integration.

What it looks like

![agent-tmux-toolkit showing 3-pane layout with PLAN, WORK, and REVIEW panes, and the agent-flow menu open for workflow orchestration](docs/images/hero-agent-flow.png)

*The agent-flow menu (Option+F) orchestrating work across PLAN, WORK, and REVIEW panes*

Features

  • 3-pane layout: PLAN | WORK | REVIEW for parallel agent workflows
  • Compound workflow orchestration: PLAN -> WORK -> REVIEW -> COMPOUND loop
  • Pane-aware snippets: Shows relevant snippets based on current pane
  • Cross-pane handoffs: Transfer context between panes with smart templates
  • Task-based sessions: Name sessions by task ID for easy navigation
  • Git worktree integration: Isolated branches for parallel development
  • Multi-agent delegation: Spawn multiple agent sessions at once
  • Status dashboard: View all agent sessions at a glance
  • Copy/paste: Extract pane content to clipboard or paste into panes
  • Session manager: Interactive session/pane management
  • Desktop notifications: Optional alerts when agents need attention

Installation

# Clone the repo
git clone https://github.com/YOUR_USERNAME/agent-tmux-toolkit.git
cd agent-tmux-toolkit

# Run installer
./install.sh

Quick Start

# Start a new agent session
agent-session

# Start a task-specific session
agent-session --task auth-fix

# Spawn multiple parallel agents
agent-delegate task-1 task-2 task-3

# View all agent sessions
agent-status

# Open the interactive manager
agent-manage

Keybindings

Key Action
Option+S Open snippet picker (pane-aware)
Option+F Open workflow flow orchestrator
Option+H Handoff context between panes
Option+D Open status dashboard
Option+M Open agent manager