Taskmaster

Taskmaster

Taskmaster for Codex uses session-log polling plus automatic continuation. Codex TUI does not currently expose arbitrary writable stop hooks, so this skill implements the same completion contract externally.

How It Works

1. Run Codex via wrapper: run-taskmaster-codex.sh sets CODEX_TUI_RECORD_SESSION=1 and a log path.
2. Injector parses log events and checks completion on each task_complete event.
3. Parseable token contract: TASKMASTER_DONE::<session_id>
4. Token missing:
   • inject follow-up user message into the same running process via expect PTY bridge transport, using the shared compliance prompt.
5. Token present: no further injection.

Parseable Done Signal

When the work is genuinely complete, the agent must include this exact line in its final response (on its own line):

TASKMASTER_DONE::<session_id>

This gives external automation a deterministic completion marker to parse.

Configuration

• TASKMASTER_MAX (default 0): max warning count before suppression in the stop hook. 0 means unlimited warnings.

Fixed behavior (not configurable):

• Done token prefix: TASKMASTER_DONE
• Poll interval: 1 second
• Transport: expect only
• Expect payload mode and submit delay are fixed

Setup

Install and run:

bash ~/.codex/skills/taskmaster/install.sh
codex-taskmaster