tmuxc

Manage tmux sessions for Claude Code, Codex CLI, and OMX agents.

3|2|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/yoonhwan/ai-feature-pack --skill tmuxc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmuxc
Source: https://github.com/yoonhwan/ai-feature-pack/tree/main/feature-pack/tmuxc/claude-code/skills/tmuxc
Command: npx skills add https://github.com/yoonhwan/ai-feature-pack --skill tmuxc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Managing multiple AI coding agent sessions across Claude Code, Codex CLI, and OMX within tmux is error-prone and lacks standardized communication protocols, leading to silent message loss and context fragmentation during multi-agent orchestration.

Core Features & Use Cases

  • Verified Inter-Session Messaging: Send messages between orchestrator and worker sessions using a 4-step verification protocol that guarantees delivery, preventing the common failure mode where tmux send-keys reports success but the message never reaches its target.
  • Session Lifecycle Management: Create, list, rename, and kill tmux sessions with automatic agent execution, intelligent model routing (Sonnet for analysis tasks, Opus for orchestration), and context-aware distillation that transfers state to fresh sessions when context usage exceeds 70%.
  • Disaster Recovery: Automatically recover from cmux disconnections and tmux server crashes by reconstructing sessions from Claude's session index and resuming conversations with full context restoration via baton handoff.

Quick Start

Use the tmuxc skill to create a new tmux session in your current project directory with Claude Code by saying 'tmuxc open . --name my-session --agent claude'.

Frequently Asked Questions about tmuxc

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

FAQPage Schema
How do I manage multiple AI coding agent sessions in tmux without losing messages?

Multi-agent tmux session management requires a verified inter-session messaging protocol to prevent silent message loss. Using a 4-step verification protocol with delivery confirmation guarantees that orchestrator-to-worker messages reach their target Claude Code, Codex CLI, or OMX sessions.

Why does tmux send-keys report success but my AI agent never receives the message?

Tmux send-keys can report success even when the message never reaches its target AI coding agent session. A verified send protocol with hard-gated session validation and delivery confirmation solves this by checking that the target agent actually processed the input.

How do I automatically distill context and transfer state to a fresh Claude Code session?

Context-aware distillation automatically transfers state to a fresh tmux session when context usage exceeds a 70% threshold. This multi-agent workflow preserves conversation continuity by using baton handoff integration to resume with full context restoration.

Can I recover AI coding agent sessions after a tmux server crash or cmux disconnection?

Disaster recovery for tmux server crashes and cmux disconnections reconstructs AI coding agent sessions from Claude's session index. It resumes conversations with full context restoration using baton handoff and automatically cleans up zombie sessions.

How do I create a new tmux session running Claude Code with intelligent model routing?

Creating a tmux session with Claude Code supports intelligent model routing, automatically selecting Sonnet for analysis tasks and Opus for orchestration. Use the command 'tmuxc open . --name my-session --agent claude' to start an agent in your project directory.

What is the best way to orchestrate multi-agent development workflows across Codex CLI and OMX?

Multi-agent development workflows across Codex CLI and OMX require standardized tmux session orchestration with hard-gated validation and automatic cleanup of zombie sessions. This approach prevents context fragmentation and ensures verified inter-session messaging.