# Taskmaster

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

- Skill: `bertbertov/taskmaster` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bertbertov/taskmaster`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bertbertov/taskmaster/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bertbertov (https://skillmd.com/u/bertbertov)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bertbertov/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):

```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
```