codex-worker

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

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/hvrryh-web/RadiantX --skill codex-worker-hvrryh-web
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-worker
Source: https://github.com/hvrryh-web/RadiantX/tree/main/.agents/skills/codex-worker
Command: npx skills add https://github.com/hvrryh-web/RadiantX --skill codex-worker-hvrryh-web

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codex workers enable running multiple Codex CLI agents in parallel, each in its own isolated worktree and tmux session, to accelerate tasks that can be decomposed into independent subtasks.

Core Features & Use Cases

  • Parallel task execution: spawn and manage several Codex agents across separate worktrees and tmux sessions.
  • Subtask distribution: automatically assign one worker per issue/module/task to maximize throughput.
  • Replaces Task tool: when codex and tmux are available, use codex workers for more capable parallelism.
  • Reproducibility and safety: ensures tasks run in isolated environments with clear naming and lifecycle management.

Quick Start

Spawn a codex worker for a sample task and attach to its tmux session to begin interactive prompts.

Frequently Asked Questions about codex-worker

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

FAQPage Schema
How do I run multiple Codex agents in parallel for code refactoring?▼

Run multiple Codex agents in parallel by dividing refactoring work into independent subtasks, assigning each worker to its own isolated git worktree and tmux session to accelerate multi-file fixes.

Do I need tmux and git worktrees to orchestrate parallel Codex workers?▼

Yes, orchestrating parallel Codex workers requires both tmux and codex installed, as it runs each worker in its own isolated git worktree with a separate tmux session for safety.

What is the best way to distribute batch triage tasks across multiple agents?▼

Distribute batch triage tasks by automatically assigning one Codex worker per issue or module, running them concurrently across separate worktrees to handle large-scale repository triage.

Can I use parallel Codex workers instead of the Task tool for linting and multi-file fixes?▼

Yes, you can replace the Task tool with parallel Codex workers when codex and tmux are available, providing more capable parallelism for linting and multi-file fixes across components.

How does parallel agent orchestration ensure reproducibility and safety across isolated sessions?▼

Parallel agent orchestration ensures reproducibility and safety by running each worker in an isolated git worktree with clear naming and lifecycle management within separate tmux environments.