codex-worker

Orchestrate parallel Codex CLI agents in isolated tmux sessions and git worktrees.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/chen-001/kimi-cli-plus --skill codex-worker-chen-001
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-worker
Source: https://github.com/chen-001/kimi-cli-plus/tree/main/.agents/skills/codex-worker
Command: npx skills add https://github.com/chen-001/kimi-cli-plus --skill codex-worker-chen-001

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spawn and manage multiple Codex CLI agents via tmux to work on tasks in parallel. Use whenever a task can be decomposed into independent subtasks (e.g. batch triage, parallel fixes, multi-file refactors). When codex and tmux are available, prefer this over the built-in Task tool for parallelism.

Core Features & Use Cases

  • Orchestrates multiple Codex CLI agents in separate tmux sessions, each with its own git worktree for isolated task execution.
  • Enables automatic parallelization of disjoint subtasks, improving throughput and turnaround times.
  • Replaces the built-in Task tool when codex and tmux are available for efficient parallel problem solving.

Quick Start

Create a codex worker by naming the task and launching a tmux session with a separate worktree, then guide each worker to perform an independent subtask in parallel.

Frequently Asked Questions about codex-worker

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

FAQPage Schema
How do I run parallel Codex CLI agents for multi-file refactoring?

You can run parallel Codex CLI agents by spawning each worker in its own tmux session and git worktree. This isolates disjoint subtasks like multi-file refactors or batch triage, enabling concurrent execution and faster turnaround.

Can I use tmux and git worktrees to isolate parallel coding agents?

Yes, using tmux and git worktrees isolates parallel coding agents effectively. Each Codex worker operates in a separate tmux session and worktree, ensuring independent task execution without file conflicts across multiple agents.

Do I need tmux and codex installed to orchestrate parallel agents?

Yes, you need both tmux and codex installed to orchestrate parallel agents. The tool requires these dependencies to manage multiple agent sessions and coordinate worktrees for isolated execution of independent subtasks.

What is the best way to parallelize independent coding subtasks?

The best way to parallelize independent coding subtasks is orchestrating multiple Codex CLI agents via tmux. This approach replaces the built-in Task tool when tmux and codex are available, managing separate worktrees for each disjoint subtask.

When should I use parallel Codex agents instead of the built-in Task tool?

Use parallel Codex agents instead of the built-in Task tool when your task can be decomposed into independent subtasks and both codex and tmux are available. This enables automatic parallelization for batch triage or parallel fixes.

Why use separate git worktrees for parallel tmux coding sessions?

Separate git worktrees provide isolated execution environments for parallel tmux coding sessions. Each Codex agent works in its own worktree, preventing file conflicts and enabling multiple agents to tackle complex tasks simultaneously.