name

climux

description

CLI multiplexer for delegating coding tasks to professional AI coding tools (Claude Code, Codex, Gemini CLI, OpenCode). Use this skill when: - Delegating complex coding tasks to specialized AI coding agents - Running parallel coding sessions across multiple git worktrees - Resuming previous coding sessions to maintain context - Orchestrating multi-agent workflows for large features - Initializing project documentation (CLAUDE.md, AGENTS.md) - Tracking costs and token usage across sessions Triggers: "use climux", "delegate to codex/claude/gemini", "parallel coding", "multi-agent", "resume session", "coding worktree"

Climux

Orchestrate AI coding agents through a unified CLI interface.

Quick Start

# Run a task (auto-routes to best provider)
climux run "implement feature X" --mode task

# Use specific provider
climux run "fix bug" --provider codex --mode task

# Resume previous session
climux session resume <session-id>

Multi-Agent Parallel Execution

Create isolated worktrees and run tasks in parallel:

# Create worktrees for parallel work
climux worktree create feature-auth
climux worktree create feature-api
climux worktree create feature-ui

# Run parallel tasks (use & for background)
climux run "implement auth" --worktree feature-auth --mode task &
climux run "build API" --worktree feature-api --mode task &
climux run "create UI" --worktree feature-ui --mode task &

# Monitor all sessions
climux status

Session Memory & Resume

Reuse previous session context:

# List sessions to find previous work
climux session list --status completed

# Resume with full context preserved
climux session resume <session-id>

# View session history
climux session log <session-id>

# Export for documentation
climux session export <session-id> --format md

Project Initialization

Initialize project documentation for AI agents:

# Initialize climux config
climux config init

# Create workspace alias for quick access
climux workspace alias myproject .

Then create these files manually:

CLAUDE.md - Project context for Claude:

# Project: [Name]
## Tech Stack: [frameworks, languages]
## Key Patterns: [architecture decisions]
## Testing: [how to run tests]

AGENTS.md - Multi-agent coordination rules:

# Agent Coordination
## Worktree Naming: feature-*, bugfix-*, refactor-*
## Merge Strategy: squash commits
## Review Required: security changes

Command Reference

Command	Purpose
`climux run "<task>" --mode task`	Execute autonomous task
`climux run "<task>" --provider <name>`	Use specific provider
`climux run "<task>" --worktree <name>`	Run in worktree
`climux session list`	List all sessions
`climux session resume <id>`	Resume session
`climux worktree create <name>`	Create git worktree
`climux worktree list`	List worktrees
`climux status`	Show active sessions
`climux stats`	Show usage statistics

Provider Selection

Pattern	Best Provider	Use Case
`frontend\|react\|vue\|css`	gemini-cli	UI/frontend
`debug\|fix\|bug\|error`	codex	Debugging
General tasks	claude-code	Default

Advanced Patterns

See references/parallel-patterns.md for:

Complex multi-agent orchestration
Worktree lifecycle management
Session chaining strategies

See references/project-templates.md for:

CLAUDE.md templates by project type
AGENTS.md coordination patterns
Config presets

Error Recovery

# If session crashed, resume it
climux session list --status crashed
climux session resume <session-id>

# If provider unavailable, fallback is automatic
# Order: claude-code → gemini-cli → codex → opencode