Cmux Codex — Development skill for Claude Code

codex-cmux

real-time cmux sidebar integration for OpenAI Codex CLI. status pills, progress bars, bash command logs, focus-aware desktop notifications, git integration — all wired through codex's 5 hook events and cmux's unix socket.

sibling project to [cmux-claude-pro](https://github.com/yigitkonur/cmux-claude-pro) (16 hooks for Claude Code). same architecture, adapted for codex's simpler hook system.

    

the sidebar, explained

status pill (top of sidebar)

state	icon	color	when it appears
Ready	checkmark.circle	green	session started, waiting for input
Thinking...	brain	gold	you submitted a prompt, codex is processing
Working: Bash: npm test	hammer.fill	blue	codex is running a command
Done	checkmark.seal	green	response complete
Error	xmark.circle	red	response failed

progress bar

adaptive estimation using `n/(n+K)` where K learns from your session history:

1 tool  → ████░░░░░░░░░░░░░░░░  0.09
3 tools → ██████████░░░░░░░░░░  0.23
5 tools → ████████████░░░░░░░░  0.33
done    → ████████████████████  1.00 Complete

caps at 0.95 during work. never hits 100% until codex actually finishes.

sidebar log entries

every bash command gets a formatted log entry:

[codex] [info] Bash: `npm test -- --coverage` → exit 0
[codex] [info] Bash: `git diff --stat` → exit 0
[codex] [info] Bash: `ls -la src/` → exit 0

when codex adds Edit/Read/Grep tool hooks, those will log automatically too (future-proofed with a default passthrough).

desktop notifications

focus-aware — only fires when you're NOT looking at the codex tab:

| trigger | not