Skill

cmux-codex-autoapprove

Runs and maintains cmux approval worker: scans terminal surfaces for dialogs, classifies with codex exec, sends keys. For testing launchd auto-approver, debugging missed prompts, tuning heuristics.

Python

Bash

automation

cli-tools

Install

npx claudepluginhub jleechanorg/claude-commands

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Canonical files:

SKILL.md

Similar Skills

kotlin-ktor-patterns

Provides Ktor server patterns for routing DSL, plugins (auth, CORS, serialization), Koin DI, WebSockets, services, and testApplication testing.

everything-claude-code

163.2k

deep-research

Conducts multi-source web research with firecrawl and exa MCPs: searches, scrapes pages, synthesizes cited reports. For deep dives, competitive analysis, tech evaluations, or due diligence.

everything-claude-code

163.2k

inventory-demand-planning

Provides demand forecasting, safety stock optimization, replenishment planning, and promotional lift estimation for multi-location retailers managing 300-800 SKUs.

everything-claude-code

163.2k

Stats

Stars26

Forks4

Last CommitApr 5, 2026

Actions

View Source View Plugin View on GitHub View README

cmux Codex Autoapprove

Canonical files:

Skill root: $HOME/.claude/skills/cmux-codex-autoapprove
Worker script: $HOME/.claude/skills/cmux-codex-autoapprove/scripts/cmux_codex_approve_launchd.py
LaunchAgent: $HOME/Library/LaunchAgents/com.$USER.cmux-codex-approve.plist
Logs: $HOME/.claude/supervisor/cmux-codex-launchd.log
State: $HOME/.claude/supervisor/cmux-codex-launchd-state.json

Compatibility paths:

Wrapper path used by older flows: $HOME/.claude/bin/cmux_codex_approve_launchd.py
Codex skill symlink: $HOME/.codex/skills/cmux-codex-autoapprove

Purpose

Use this skill for a custom cmux auto-approver that:

enumerates terminal surfaces with cmux --json tree --all
reads visible terminal content with cmux read-screen
filters for approval-like prompts near the bottom of the live screen
asks codex exec for a one-token decision: ENTER, 1, y, SKIP, or DENY
sends the chosen key back with cmux send or cmux send-key

This is the non-snap-agent-supervisor path.

Normal Workflow

Verify the target surface with:

cmux --json tree --all
cmux read-screen --workspace <workspace> --surface <surface> --lines 24

If you need a one-shot run, execute:

/opt/homebrew/bin/python3 $HOME/.claude/skills/cmux-codex-autoapprove/scripts/cmux_codex_approve_launchd.py

For the scheduled agent, use:

launchctl kickstart -k gui/501/com.$USER.cmux-codex-approve
launchctl print gui/501/com.$USER.cmux-codex-approve

Behavior Notes

The worker intentionally focuses on the bottom active region of the screen so stale scrollback does not retrigger approvals forever.
Approved prompt digests are cleared once the surface returns to a normal shell or idle prompt.
Idle runs are cheap. codex exec is only called when the screen looks like a real approval dialog.

When To Edit

Edit the worker script when:

a real approval dialog is missed
a non-approval surface is being auto-approved
launchd can detect candidates but hangs or times out during classification
prompt wording changes and the regexes need to expand

Check these first when debugging:

$HOME/.claude/supervisor/cmux-codex-launchd.log
$HOME/.claude/supervisor/cmux-codex-launchd.stderr.log
$HOME/.claude/supervisor/cmux-codex-launchd-state.json