taskmaster

name: taskmaster description: | Codex wrapper plus same-process expect PTY injector that keeps work moving until an explicit parseable done signal is emitted. author: blader version: 4.2.0

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

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