taskmaster
Stop hook for Claude Code that keeps the agent working until all plans and user requests are 100% complete
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/blader--taskmaster)HTML
<a href="/listings/blader--taskmaster"><img src="/api/listings/blader--taskmaster/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
bash ~/.codex/skills/taskmaster/install.sh
Auto-detection behavior: - Installs Codex integration when `codex` or `~/.codex` exists. - Installs Claude integration when `claude` or `~/.claude` exists. - If both are present, installs both. - If neither is detected, defaults to both.
Optional target override:
TASKMASTER_INSTALL_TARGET=codex bash ~/.codex/skills/taskmaster/install.sh TASKMASTER_INSTALL_TARGET=claude bash ~/.codex/skills/taskmaster/install.sh TASKMASTER_INSTALL_TARGET=both bash ~/.codex/skills/taskmaster/install.sh
Installed artifacts: - Codex: - `~/.codex/skills/taskmaster/` - `~/.codex/bin/codex-taskmaster` - `~/.codex/bin/codex` (shim to Taskmaster wrapper) - Claude: - `~/.claude/skills/taskmaster/` - `~/.claude/hooks/taskmaster-check-completion.sh` - Stop-hook entry added to `~/.claude/settings.json`
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 58 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- 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
- ```
README.md · README · 154 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Taskmaster
- Taskmaster is a completion guard for coding agents.
- It addresses a common failure mode: the agent makes partial progress, writes a
- summary, and stops before the user goal is actually finished.
- ## Philosophy
- Taskmaster is built around one idea: progress is not completion.
- - Evidence over narrative:
- The agent should not be allowed to stop based on a convincing summary alone.
- Completion must be explicit and machine-checkable.
- - Same-session recovery:
- When a turn is incomplete, the right move is to continue in the same running
- session, not restart from scratch.
- - Goal re-anchoring:
- Compliance prompts force the model back to the user’s actual request, not its
- own local notion of “good enough”.
- - Automation-safe signaling:
- A deterministic done token makes completion parseable for wrappers and
- CI-style flows.
- ## Core Contract
- A run is complete only when the assistant emits:
- ```text
- TASKMASTER_DONE::<session_id>
- ```
- If that token is missing at stop time, Taskmaster blocks stop and pushes the
- current turn to continue. Codex monitoring stays active for later turns in the
- same long-lived session.
- ### Enforcement Prompt
- Taskmaster uses one shared compliance prompt for both Codex and Claude.
- - Codex: the wrapper/injector path injects this shared prompt back into the
- same running session when stop conditions are not met.
- - Claude: the Stop hook returns this same shared prompt as the block reason.
- The shared prompt source lives in `taskmaster-compliance-prompt.sh`.
- ## How It Works
- - Codex path:
- - Runs through a wrapper (`codex` shim / `codex-taskmaster` launcher).
- - Enables Codex session logs.
- - Watches `task_complete` / `turn_complete` events.
- - If done token is missing, injects a continuation prompt into the same
- running Codex process via expect PTY.
- - A done token suppresses injection for that completed turn only; it does
- not permanently disable Taskmaster for future turns in the same session.
- - Claude path:
- - Registers a `Stop` command hook.
- - Hook runs `check-completion.sh`.
- - If done token is missing, the stop is blocked with corrective feedback.
- ## Install
- ```bash
- bash ~/.codex/skills/taskmaster/install.sh
- ```
- Auto-detection behavior:
- - Installs Codex integration when `codex` or `~/.codex` exists.
- - Installs Claude integration when `claude` or `~/.claude` exists.
- - If both are present, installs both.
- - If neither is detected, defaults to both.
- Optional target override:
- ```bash
- TASKMASTER_INSTALL_TARGET=codex bash ~/.codex/skills/taskmaster/install.sh
- TASKMASTER_INSTALL_TARGET=claude bash ~/.codex/skills/taskmaster/install.sh
- TASKMASTER_INSTALL_TARGET=both bash ~/.codex/skills/taskmaster/install.sh
- ```
- Installed artifacts:
- - Codex:
- - `~/.codex/skills/taskmaster/`
- - `~/.codex/bin/codex-taskmaster`
- - `~/.codex/bin/codex` (shim to Taskmaster wrapper)
- - Claude:
- - `~/.claude/skills/taskmaster/`
- - `~/.claude/hooks/taskmaster-check-completion.sh`
- - Stop-hook entry added to `~/.claude/settings.json`
- ## Usage
- ### Codex
- Run normally:
- ```bash
- codex [args]
- ```
- Explicit alias is also available:
- ```bash
- codex-taskmaster [args]
- ```
- Interactive resume is also supported:
- ```bash
- codex resume [session-or-thread]
- ```
- ### Claude
- Run Claude normally after install. Taskmaster hook enforcement is automatic.
- ## Configuration
- - `TASKMASTER_MAX` (default `0`):
- - Limits stop-block warnings in hook checks.
- - `0` means unlimited warnings.
- ## Uninstall
- ```bash
- bash ~/.codex/skills/taskmaster/uninstall.sh
- ```
- Auto-detection behavior mirrors install and removes Taskmaster from detected
- Codex/Claude environments.
- Optional target override:
- ```bash
- TASKMASTER_UNINSTALL_TARGET=codex bash ~/.codex/skills/taskmaster/uninstall.sh
- TASKMASTER_UNINSTALL_TARGET=claude bash ~/.codex/skills/taskmaster/uninstall.sh
- TASKMASTER_UNINSTALL_TARGET=both bash ~/.codex/skills/taskmaster/uninstall.sh
- ```
- ## Requirements
- - `bash`
- - `jq`
- - Codex integration:
- - Codex CLI
- - `expect`
- - Claude integration:
- - Claude Code with `Stop` hooks enabled
- - `python3` (for install/uninstall settings updates)
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.