Logo
Agent Skills Guide

tmux-workflow

published 2026/03/13

Portable tmux-based workflow to drive one or multiple long-running Codex CLI “workers” from another process (e.g. Claude CLI) by (1) starting/reusing a tmux session running `codex`, (2) injecting prompts into the Codex pane via `tmux send-keys`/buffer paste, and (3) polling the worker’s Codex JSONL session logs to extract the next assistant reply. Each worker runs with an isolated `CODEX_HOME` (default `~/.codex-workers/<worker_id>`) to prevent log cross-talk when multiple Codex workers run concurrently. Use when you need to submit/wait/read Codex replies in tmux, manage multiple Codex workers, or troubleshoot the tmux worker and log binding.

📦 Install Skill

Command line install

Install directly with the `skills` CLI.

npx skills add kunhuang12345/team-skill/.codex/skills/tmux-workflow

Local download

Download only this skill directory.

Download tmux-workflow only
File Explorer
0 files
No file selected
readonly

Select a file to view its content