Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/blader--taskmaster/badge.svg)](/listings/blader--taskmaster)

HTML

<a href="/listings/blader--taskmaster"><img src="/api/listings/blader--taskmaster/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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)

  1. ---
  2. name: taskmaster
  3. description: |
  4. Codex wrapper plus same-process expect PTY injector
  5. that keeps work moving until an explicit parseable done signal is emitted.
  6. author: blader
  7. version: 4.2.0
  8. ---
  9. # Taskmaster
  10. Taskmaster for Codex uses session-log polling plus automatic continuation.
  11. Codex TUI does not currently expose arbitrary writable stop hooks, so this
  12. skill implements the same completion contract externally.
  13. ## How It Works
  14. 1. **Run Codex via wrapper**: `run-taskmaster-codex.sh` sets
  15. `CODEX_TUI_RECORD_SESSION=1` and a log path.
  16. 2. **Injector parses log events** and checks completion on each
  17. `task_complete` event.
  18. 3. **Parseable token contract**:
  19. `TASKMASTER_DONE::<session_id>`
  20. 4. **Token missing**:
  21. - inject follow-up user message into the same running process via
  22. expect PTY bridge transport, using the shared compliance prompt.
  23. 5. **Token present**: no further injection.
  24. ## Parseable Done Signal
  25. When the work is genuinely complete, the agent must include this exact line
  26. in its final response (on its own line):
  27. ```text
  28. TASKMASTER_DONE::<session_id>
  29. ```
  30. This gives external automation a deterministic completion marker to parse.
  31. ## Configuration
  32. - `TASKMASTER_MAX` (default `0`): max warning count before suppression in the
  33. stop hook. `0` means unlimited warnings.
  34. Fixed behavior (not configurable):
  35. - Done token prefix: `TASKMASTER_DONE`
  36. - Poll interval: `1` second
  37. - Transport: expect only
  38. - Expect payload mode and submit delay are fixed
  39. ## Setup
  40. Install and run:
  41. ```bash
  42. bash ~/.codex/skills/taskmaster/install.sh
  43. codex-taskmaster
  44. ```
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)

  1. # Taskmaster
  2. Taskmaster is a completion guard for coding agents.
  3. It addresses a common failure mode: the agent makes partial progress, writes a
  4. summary, and stops before the user goal is actually finished.
  5. ## Philosophy
  6. Taskmaster is built around one idea: progress is not completion.
  7. - Evidence over narrative:
  8. The agent should not be allowed to stop based on a convincing summary alone.
  9. Completion must be explicit and machine-checkable.
  10. - Same-session recovery:
  11. When a turn is incomplete, the right move is to continue in the same running
  12. session, not restart from scratch.
  13. - Goal re-anchoring:
  14. Compliance prompts force the model back to the user’s actual request, not its
  15. own local notion of “good enough”.
  16. - Automation-safe signaling:
  17. A deterministic done token makes completion parseable for wrappers and
  18. CI-style flows.
  19. ## Core Contract
  20. A run is complete only when the assistant emits:
  21. ```text
  22. TASKMASTER_DONE::<session_id>
  23. ```
  24. If that token is missing at stop time, Taskmaster blocks stop and pushes the
  25. current turn to continue. Codex monitoring stays active for later turns in the
  26. same long-lived session.
  27. ### Enforcement Prompt
  28. Taskmaster uses one shared compliance prompt for both Codex and Claude.
  29. - Codex: the wrapper/injector path injects this shared prompt back into the
  30. same running session when stop conditions are not met.
  31. - Claude: the Stop hook returns this same shared prompt as the block reason.
  32. The shared prompt source lives in `taskmaster-compliance-prompt.sh`.
  33. ## How It Works
  34. - Codex path:
  35. - Runs through a wrapper (`codex` shim / `codex-taskmaster` launcher).
  36. - Enables Codex session logs.
  37. - Watches `task_complete` / `turn_complete` events.
  38. - If done token is missing, injects a continuation prompt into the same
  39. running Codex process via expect PTY.
  40. - A done token suppresses injection for that completed turn only; it does
  41. not permanently disable Taskmaster for future turns in the same session.
  42. - Claude path:
  43. - Registers a `Stop` command hook.
  44. - Hook runs `check-completion.sh`.
  45. - If done token is missing, the stop is blocked with corrective feedback.
  46. ## Install
  47. ```bash
  48. bash ~/.codex/skills/taskmaster/install.sh
  49. ```
  50. Auto-detection behavior:
  51. - Installs Codex integration when `codex` or `~/.codex` exists.
  52. - Installs Claude integration when `claude` or `~/.claude` exists.
  53. - If both are present, installs both.
  54. - If neither is detected, defaults to both.
  55. Optional target override:
  56. ```bash
  57. TASKMASTER_INSTALL_TARGET=codex bash ~/.codex/skills/taskmaster/install.sh
  58. TASKMASTER_INSTALL_TARGET=claude bash ~/.codex/skills/taskmaster/install.sh
  59. TASKMASTER_INSTALL_TARGET=both bash ~/.codex/skills/taskmaster/install.sh
  60. ```
  61. Installed artifacts:
  62. - Codex:
  63. - `~/.codex/skills/taskmaster/`
  64. - `~/.codex/bin/codex-taskmaster`
  65. - `~/.codex/bin/codex` (shim to Taskmaster wrapper)
  66. - Claude:
  67. - `~/.claude/skills/taskmaster/`
  68. - `~/.claude/hooks/taskmaster-check-completion.sh`
  69. - Stop-hook entry added to `~/.claude/settings.json`
  70. ## Usage
  71. ### Codex
  72. Run normally:
  73. ```bash
  74. codex [args]
  75. ```
  76. Explicit alias is also available:
  77. ```bash
  78. codex-taskmaster [args]
  79. ```
  80. Interactive resume is also supported:
  81. ```bash
  82. codex resume [session-or-thread]
  83. ```
  84. ### Claude
  85. Run Claude normally after install. Taskmaster hook enforcement is automatic.
  86. ## Configuration
  87. - `TASKMASTER_MAX` (default `0`):
  88. - Limits stop-block warnings in hook checks.
  89. - `0` means unlimited warnings.
  90. ## Uninstall
  91. ```bash
  92. bash ~/.codex/skills/taskmaster/uninstall.sh
  93. ```
  94. Auto-detection behavior mirrors install and removes Taskmaster from detected
  95. Codex/Claude environments.
  96. Optional target override:
  97. ```bash
  98. TASKMASTER_UNINSTALL_TARGET=codex bash ~/.codex/skills/taskmaster/uninstall.sh
  99. TASKMASTER_UNINSTALL_TARGET=claude bash ~/.codex/skills/taskmaster/uninstall.sh
  100. TASKMASTER_UNINSTALL_TARGET=both bash ~/.codex/skills/taskmaster/uninstall.sh
  101. ```
  102. ## Requirements
  103. - `bash`
  104. - `jq`
  105. - Codex integration:
  106. - Codex CLI
  107. - `expect`
  108. - Claude integration:
  109. - Claude Code with `Stop` hooks enabled
  110. - `python3` (for install/uninstall settings updates)
  111. ## License
  112. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.