tmux-sprint

Coordinate two-session tmux sprint grids for round dispatch across runtimes.

1|Updated May 9, 2026
One-click install
npx skills add https://github.com/tonykoop/claude-skills --skill tmux-sprint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux-sprint
Source: https://github.com/tonykoop/claude-skills/tree/main/plugins/coding/skills/tmux-sprint
Command: npx skills add https://github.com/tonykoop/claude-skills --skill tmux-sprint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, tmux, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

tmux-sprint orchestrates a two-session tmux grid (manager and sprint) and the dispatch of rounds to multiple runtimes. It probes pane state, revives dead codex panes, and records round state for recovery and auditing. It provides a validated, portable workflow with rate-limiting and plan-first governance across runtimes.

Core Features & Use Cases

  • Manage a two-session tmux sprint grid (manager + sprint) and per-pane runtimes.
  • Dispatch rounds to Claude/Codex and other runtimes with deterministic sequencing and rate-limiting.
  • Probe liveness, revive dead panes, and persist per-round state for audit and recovery.

Quick Start

Set up the two-session grid with launch-grid.sh, start the manager and sprint sessions, and run preflight.sh to begin a round.

Frequently Asked Questions about tmux-sprint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I orchestrate a tmux sprint grid to manage multiple AI coding runtimes?

A tmux sprint grid automates runtime dispatch by coordinating a two-session layout with manager and sprint sessions. It probes pane state, revives dead runtimes, and records round state to ensure validated, rate-limited execution across multiple AI lanes.

How do I start a round dispatch workflow across tmux panes?

Start a round dispatch workflow by running the launch-grid script to initialize the two-session tmux grid, then execute the preflight script. This begins the validated, plan-first dispatch sequence to your configured runtime lanes.

Does tmux-sprint work with Claude and Gemini lanes for parallel task execution?

Yes, tmux-sprint works with Claude, Codex, and Gemini lanes for parallel task execution. It applies liveness probes to monitor these runtimes and automatically revives dead panes to maintain continuous sprint orchestration.

What dependencies do I need to automate round dispatch across runtimes?

You need tmux and jq installed to automate round dispatch across runtimes. These dependencies support the structured frontmatter validation, pane state probing, and persistent round log generation required for governance.

Why does my tmux pane die during a sprint round and how do I recover it?

Tmux panes die during sprint rounds due to runtime crashes, but tmux-sprint recovers them using built-in liveness probes. The system automatically detects dead panes, revives the codex runtime, and restores state from persistent round logs.

How does tmux sprint orchestration handle rate-limiting and audit logging?

Tmux sprint orchestration handles rate-limiting by applying deterministic sequencing to runtime dispatch, preventing API overload. It generates persistent round logs and artifacts after each execution to support versioning and audit recovery.