Skip to content

golbin/pman

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pman

Run multiple AI agents in parallel. Switch between them in 2 keystrokes.

Claude Code, Codex, Aider... AI agents are powerful, but slow. Why wait for one when you can run several? pman lets you manage multiple tmux sessions and git worktrees with fuzzy search—perfect for running AI agents in parallel without conflicts.

┌ Sessions ─────────────────────────────┐
│ > _                                   │
└───────────────────────────────────────┘
┌───────────────────────────────────────┐
│ ▶ ● claude-auth (myproject)           │
│   ○ codex-tests (myproject)           │
│   ○ aider-refactor (myproject)        │
│   ○ manual-review (myproject)         │
└───────────────────────────────────────┘

Why pman?

  • Parallel Agents - Run multiple AI coding agents, each in its own tmux session
  • Isolated Worktrees - Each agent works on a separate git branch, no conflicts
  • Instant Switch - Fuzzy search and jump between sessions in milliseconds

Installation

brew install golbin/tap/pman

Quick Start

# 1. Install keybindings
pman install && tmux source-file ~/.tmux.conf

# 2. Inside tmux, press Prefix+s to open session picker
#    (Prefix is usually Ctrl+b)

Usage Scenarios

Scenario 1: Multiple Agents on Separate Features

Give each AI agent its own worktree to avoid conflicts:

# Create worktrees (Prefix+p → List Worktrees → n)
# Each worktree = separate branch

┌ Worktrees ────────────────────────────┐
│ > _                                   │
└───────────────────────────────────────┘
┌───────────────────────────────────────┐
│ ▶ feature/auth (a1b2c3d)              │
│   feature/payment* (e4f5g6h)          │
│   feature/notifications (i9j0k1l)     │
│   main (m2n3o4p) [main]               │
└───────────────────────────────────────┘

# Start agents in separate sessions:
# Session 1: Claude Code → feature/auth
# Session 2: Codex → feature/payment
# Session 3: Aider → feature/notifications

# Use Prefix+s to monitor each agent's progress
# Merge completed branches with 'm' key

Scenario 2: Review While Agents Work

Work in parallel with your AI agents:

┌ Sessions ─────────────────────────────┐
│ > rev                                 │
└───────────────────────────────────────┘
┌───────────────────────────────────────┐
│ ▶ ○ review (myproject)                │
└───────────────────────────────────────┘

# Session: agent-impl    → AI implementing feature (attached ●)
# Session: review        → You reviewing code
# Session: hotfix        → You fixing urgent bugs

# Agents don't block you. You don't block agents.

Keybindings

Tmux (after pman install)

Key Action
Prefix + s Sessions
Prefix + p Command Palette
Prefix + w Worktrees
Prefix + f Find Files (fzf)
Prefix + d Git Diff

Session Picker

Key Action
Type Fuzzy search
Enter Switch to session
n New session
d Delete session
Esc Close

Worktree Picker

Key Action
Type Fuzzy search
Enter Switch to worktree
n New worktree
d Delete worktree
m Merge to main
Esc Close

Command Palette

Command Description
List Sessions Switch between tmux sessions
New Session Create a new tmux session
Kill Session Kill the current session
List Worktrees Manage git worktrees
Create Worktree Create a new git worktree
Find Files Find and open files with fzf
List Buffers Show open buffers in nvim
Git Diff Show git diff in popup

Navigation (All Views)

Key Action
Ctrl+k / Move up
Ctrl+j / Move down

Prerequisites

brew install tmux neovim fd fzf bat git-delta

Uninstall

pman uninstall && tmux source-file ~/.tmux.conf
brew uninstall pman

License

MIT

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •