Skip to main content

taskmaster

Codex wrapper plus same-process expect PTY injector that keeps work moving until an explicit parseable done signal is emitted.

Source facts

Repository
blader/taskmaster
Last source activity
March 11, 2026 at 22:44
Detected SKILL.md language
English
Stars
532
Forks
43

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
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 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): ```text 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 bash ~/.codex/skills/taskmaster/install.sh codex-taskmaster ```
View on GitHub