codex-worker

Coordinate parallel Codex CLI agents in isolated tmux worktrees.

11.1k|1.3k|Updated Oct 15, 2025
One-click install
npx skills add https://github.com/MoonshotAI/kimi-cli --skill codex-worker-moonshotai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-worker
Source: https://github.com/MoonshotAI/kimi-cli/tree/main/.agents/skills/codex-worker
Command: npx skills add https://github.com/MoonshotAI/kimi-cli --skill codex-worker-moonshotai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrate and manage multiple Codex CLI agents running in parallel, each in its own tmux session and separate git worktree, enabling teams to tackle tasks by decomposing them into independent subtasks.

Core Features & Use Cases

  • Parallel execution: spawn multiple Codex workers that operate in isolated environments.
  • Task decomposition: automatically assign subtasks like triage, refactors, or lint fixes to individual workers.
  • Controlled orchestration: central management of worker sessions with reproducible worktrees for reliable results.

Quick Start

Spawn a codex worker by naming the task and launching a tmux session to run parallel Codex agents.

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 refactors?

Run parallel Codex CLI agents by spawning multiple workers, each operating in an isolated tmux session and separate git worktree to execute independent refactoring subtasks simultaneously. This orchestration enables scalable, concurrent task execution across multiple modules.

What is the best way to orchestrate isolated Codex workers for batch triage?

Orchestrate isolated Codex workers by applying preflight checks and assigning per-task git worktrees to individual tmux sessions. This approach enables reproducible environments and controlled central management for batch triage operations.

Does parallel Codex execution work with git worktrees and tmux?

Yes, parallel Codex execution works with git worktrees and tmux by spawning each worker in its own isolated session and separate worktree. This configuration enables isolated sessions and reproducible environments for scalable worker orchestration.

When do I need separate git worktrees for parallel lint or test runs?

You need separate git worktrees for parallel lint or test runs when tackling decomposable tasks across multiple modules. Per-task worktrees provide isolated sessions and reproducible environments, preventing file conflicts during concurrent execution.

How do I spawn a codex worker in a tmux session?

Spawn a codex worker by naming the task and launching a tmux session to run the parallel Codex agent. The worker operates within an isolated git worktree, ensuring a reproducible environment for the assigned subtask.