codex-worker

Spawn and orchestrate multiple Codex CLI agents in tmux sessions for parallel subtasks.

12|2|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/haomingz/kimi-skills --skill codex-worker-haomingz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-worker
Source: https://github.com/haomingz/kimi-skills/tree/main/skills/codex-worker
Command: npx skills add https://github.com/haomingz/kimi-skills --skill codex-worker-haomingz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spawn and manage multiple Codex CLI agents via tmux to run tasks in parallel, reducing wait times and improving throughput.

Core Features & Use Cases

  • Orchestrate multiple Codex agents, each in its own tmux session and optional git worktree, to execute subtasks concurrently.
  • Distribute work automatically across workers to tackle tasks like batch triage, parallel fixes, and multi-file refactors.
  • Provide isolated environments and traceable progress for reliable, scalable automation.

Quick Start

Launch a codex-worker to spawn and manage parallel Codex agents inside tmux sessions.

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 agents in tmux for concurrent task execution?

To run parallel Codex agents in tmux, this Skill spawns and orchestrates multiple Codex CLI agents, each in its own tmux session and optional git worktree, to execute decomposed subtasks concurrently with isolated environments and traceable progress.

What is the best way to orchestrate multi-agent Codex workers for batch refactors?

The best way to orchestrate multi-agent Codex workers for batch refactors is distributing work automatically across isolated tmux sessions and git worktrees, enabling concurrent multi-file refactors with reproducible results and reduced wait times.

Can I use git worktrees to isolate parallel Codex CLI agents during task execution?

Yes, you can use git worktrees to isolate parallel Codex CLI agents. This Skill implements per-task worktrees and isolated environments within tmux sessions, ensuring reproducible results when handling decomposed subtasks like batch triage and parallel fixes.

Does tmux support running multiple Codex agents for independent workstreams?

Yes, tmux supports running multiple Codex agents by spawning each agent in its own tmux session. This approach handles independent workstreams in parallel, applying isolated environments and traceable progress for scalable automation of decomposed tasks.

When should I use parallel Codex agents instead of a single agent for task automation?

You should use parallel Codex agents instead of a single agent when your tasks can be split into independent workstreams such as batch triage, parallel fixes, and multi-file refactors. This reduces wait times and improves throughput via concurrent execution.

Why does spawning multiple Codex workers in tmux improve automation throughput?

Spawning multiple Codex workers in tmux improves automation throughput by executing decomposed subtasks concurrently rather than sequentially. Each worker operates in an isolated tmux session and git worktree, reducing overall wait times for batch triage and refactors.