skills.rest
kunhuang12345
kunhuang12345COMMUNITY
Explore all skills by this author →
GitHub

tmux-workflow

Coordinate Codex workers in tmux sessions with isolated CODEX_HOME directories.

1|1|Updated Jan 9, 2026
Search Tags:#automation#codex#CLI#tmux#workers#log-polling
One-click install
npx skills add https://github.com/kunhuang12345/team-skill --skill tmux-workflow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tmux-workflow
Source: https://github.com/kunhuang12345/team-skill/tree/main/.codex/skills/tmux-workflow
Command: npx skills add https://github.com/kunhuang12345/team-skill --skill tmux-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, codex, python3, and includes Scripts (resource) components.

What problem does it solve?

This Skill provides a self-contained toolkit to drive one or multiple Codex CLI workers inside tmux sessions, enabling prompt submission, log polling, and per-worker isolation of CODEX_HOME.

Core Features & Use Cases

  • Start or reuse a tmux session running codex to host workers.
  • Inject prompts via tmux send-keys or buffer paste and poll Codex JSONL logs for replies.
  • Manage multiple workers with isolated CODEX_HOME (<home>/.codex-workers/<worker_id>) to prevent cross-talk; suitable for debugging, load testing, or parallel experimentation.

Quick Start

  • Start a worker: bash .codex/skills/tmux-workflow/scripts/twf codex-a
  • Ask a worker: bash .codex/skills/tmux-workflow/scripts/twf codex-a "你好"
  • Inspect latest reply: bash .codex/skills/tmux-workflow/scripts/twf pend codex-a

Frequently Asked Questions about tmux-workflow

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

FAQPage Schema
How do I run multiple Codex CLI workers in isolated tmux sessions?▼

To run multiple Codex CLI workers in tmux sessions, you can orchestrate them by assigning each worker an isolated CODEX_HOME directory, preventing cross-talk during parallel prompt submission and log polling.

What is the best way to automate prompt submission to Codex workers via tmux?▼

Automating prompt submission to Codex workers is handled by injecting inputs via tmux send-keys or buffer paste, then polling the Codex JSONL logs to parse the next assistant reply.

Do I need Python and tmux to manage Codex workers from the command line?▼

Yes, you need Python3, tmux, and the Codex CLI installed to manage Codex workers, as these dependencies handle session orchestration and script execution for log polling.

Why does my Codex worker output cross-talk when running multiple instances in tmux?▼

Codex worker cross-talk occurs when sharing a CODEX_HOME; isolating each worker with a per-user CODEX_HOME directory like <home>/.codex-workers/<worker_id> prevents shared terminal environment conflicts.

Can I retrieve specific Codex replies from JSONL logs after sending a prompt?▼

Yes, you can retrieve Codex replies from JSONL logs by polling the session logs after injecting a prompt, allowing you to inspect the latest parsed assistant response from the worker.

How does tmux-workflow coordinate Codex workers for parallel experimentation?▼

tmux-workflow coordinates Codex workers by starting or reusing tmux sessions to host workers, managing multiple isolated instances suitable for debugging, load testing, or parallel experimentation.

Related Skills

Explore More Software Engineering Skills→
MoonshotAIMoonshotAI
11.1k

codex-worker

Coordinate parallel Codex CLI agents in isolated tmux worktrees.

Official
Advanced
thisisryanswiftthisisryanswift
2

ce-session-extract

Extract filtered conversation skeletons and error signals from JSONL session logs.

Community
Intermediate
bruno-garciabruno-garcia
1

tmux

Manage interactive and long-running commands in isolated tmux sessions.

Community
Intermediate
RobinNorbergRobinNorberg
5

omc-teams

Orchestrate multi-agent CLI workers in tmux panes for parallel task execution.

Community
Intermediate