Home Original page

GitHub - Jayphen/coders: Orchestrate multiple AI coding agents in parallel. Spawn isolated sessions, coordinate via pub/sub messaging, delegate subtasks to child agents, and track completion with promises. Supports Claude, Gemini, Codex, OpenCode.

Spawn AI coding assistants (Claude, Gemini, Codex, OpenCode) in isolated tmux sessions with optional git worktrees.

Packages

This is a monorepo containing:

Package Description
@jayphen/coders Claude Code plugin for spawning AI sessions Install via Claude
coders-tui Go-based CLI and TUI for managing sessions Built from source

Quick Start

Claude Code Plugin (Recommended)

# Install from marketplace
claude plugin marketplace add https://github.com/Jayphen/coders.git
claude plugin install coders@coders

Available commands:

/coders:spawn claude --task "Build auth" --worktree feature/auth
/coders:list
/coders:attach my-session
/coders:kill my-session
/coders:prune --force
/coders:dashboard
/coders:snapshot
/coders:restore

Go CLI & TUI (Optional)

The coders binary provides a terminal UI and CLI tools for managing sessions.

Install via Homebrew (macOS)

brew tap Jayphen/coders
brew install coders

Install via Script (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/Jayphen/coders/go-rewrite/packages/go/install.sh | bash

This script:

  • Detects your OS (macOS/Linux) and architecture (amd64/arm64)
  • Downloads the latest release from GitHub
  • Installs to /usr/local/bin/coders (customize with INSTALL_DIR)

Download from GitHub Releases

  1. Visit GitHub Releases
  2. Download the binary for your platform:
    • coders-darwin-amd64 (macOS Intel)
    • coders-darwin-arm64 (macOS Apple Silicon)
    • coders-linux-amd64 (Linux x86_64)
    • coders-linux-arm64 (Linux ARM64)
  3. Make it executable and move to your PATH: 
    chmod +x coders-*
sudo mv coders-* /usr/local/bin/coders

Build from Source

Requires Go 1.21+

cd packages/go
make build    # Creates ./coders-tui
make install  # Installs to /usr/local/bin

Usage

coders --help         # View available commands
coders tui            # Launch the TUI
coders spawn <tool>   # Spawn a new session
coders list           # List all sessions
┌─ Coders Session Manager ─────────────────────────────┐
│                                                       │
│   SESSION                    TOOL      TASK    STATUS │
│ ❯ 🎯 orchestrator            claude    -         ●    │
│   ├─ claude-fix-auth         claude    fix-auth  ●    │
│   └─ gemini-write-tests      gemini    tests     ●    │
│                                                       │
│ 3 sessions    ↑↓/jk navigate  a/↵ attach  K kill  q  │
└───────────────────────────────────────────────────────┘

Prerequisites

  • tmux - Required for session management
  • Redis - Required for coordination and heartbeat monitoring

Features

  • Multi-Tool Support: Claude, Gemini, Codex, OpenCode
  • Interactive Sessions: All spawned AIs stay in interactive mode
  • Git Worktrees: Creates isolated branches for each task
  • PRD Priming: Feeds context to the AI before it starts
  • Redis Heartbeat: Session monitoring and inter-agent pub/sub
  • Web Dashboard: Real-time monitoring at localhost:3030
  • Tmux Resurrect: Snapshot/restore entire swarm
Dashboard

Project Structure

coders/
├── packages/
│   ├── plugin/                 # Claude Code plugin (distributed)
│   │   ├── .claude-plugin/
│   │   ├── commands/           # Slash commands
│   │   ├── skills/             # Core functionality
│   │   ├── bin/                # CLI wrapper
│   │   └── package.json
│   │
│   └── go/                     # Go implementation (TUI, CLI, orchestrator)
│       ├── cmd/coders/         # Main entry point
│       ├── internal/           # Internal packages
│       │   ├── config/         # Configuration management
│       │   ├── logging/        # Structured logging
│       │   ├── tmux/           # Tmux integration
│       │   └── tui/            # Terminal UI (Bubble Tea)
│       ├── Makefile
│       └── go.mod
│
├── package.json                # Workspace root (plugin dependencies)
└── pnpm-workspace.yaml

Development

# Install plugin dependencies
pnpm install

# Test the plugin locally
pnpm plugin:test

# Build and test the Go TUI/CLI
cd packages/go
make build
./coders-tui --help

# Run the TUI
./coders-tui tui

# Run tests
make test

Documentation

License

MIT