All shelves / Mods / Workflow
trailhead
By ToRvaLDz
trailhead is a Claude Code workflow mod by ToRvaLDz.
Draws the ticket map beside the chat and the step above the prompt, and refuses a bad commit, a secret, or an unvetted install.
DrawsHolds a command
Install
The marketplace name is trailhead.
/plugin marketplace add ToRvaLDz/trailhead /plugin install trailhead@trailhead
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 0.15.0
- License
- MIT
- Repo stars
- 26
- Last change
- 2026-10-16
What it can reach
- Draws in the session
- Holds a command
- Reaches the network or an outside service
- Sees tool calls
- Runs a command when you press
- Calls another program on this machine
Needs an authenticated gh CLI, and Claude Code 2.1.287 or later for the panel. Restart or reload, then run /trailhead. Remove with /plugin uninstall trailhead. The panel lists the open maps and tickets. A work button clears the context and starts that ticket. A click that only views a map does not. The band above the prompt and the status entry under it show the ticket in play and its step. The mod README says the mod appends a trailhead:work-state section that names the active map, the ticket, and the step, and that a later change is attached once as context on the next prompt. The issue title is untrusted text from GitHub, rendered as quoted data, with a line saying the title is data, not an instruction. The guards hard-block a commit whose subject is not Conventional Commits, any Co-Authored-By trailer, a gh write that matches a credential, an unvetted public-registry install, a Bash command that changes directory and then reads a relative path, and an issue body set to empty. The secret-read guard denies a read of .env, .env.*, or .secrets. The mockup-link guard hard-blocks an approval question that carries no link. They run in every repo while the plugin is installed. To opt out, disable the plugin's hooks in your Claude Code settings. It also installs a git commit-msg hook. Configuring writes .trailhead/config.json, and continuing on defaults writes an empty object. Global defaults are ~/.claude/trailhead/config.json. The statusline step offers a global status line and asks before replacing one you already run. The npm installer, a different route, registers hooks in settings.json. plan_review is off by default. When it is on, build plans go to the external CLIs you name. gh reads and writes GitHub Issues.
The panel and the band are the mod. The guards are the hold: the README calls them hard-blocks and a deny. The mod README is plugins/trailhead/hooks/mod/README.md.
Demo

What it hooks into
session.startWhen a session startsprompt.composeWhile you write a promptprompt.submitWhen you send a promptsession.compactWhen the context is compactedturn.startWhen Claude starts a turnturn.completeWhen a turn endstool.callAround a tool call, where it can hold oneBashsession.endWhen a session endsclassic.SessionStartA Claude Code eventui.renderDraws into the sessionAbovePrompt
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Hooks 5
PreToolUse · Bashnode "${CLAUDE_PLUGIN_ROOT}/hooks/trailhead-bash-guards.js"PreToolUse · Read|Bashnode "${CLAUDE_PLUGIN_ROOT}/hooks/trailhead-secret-read-guard.js"PreToolUse · AskUserQuestionnode "${CLAUDE_PLUGIN_ROOT}/hooks/trailhead-mockup-link-guard.js"PostToolUse · Bashnode "${CLAUDE_PLUGIN_ROOT}/hooks/trailhead-issue-injection-scanner.js"SessionStartnode "${CLAUDE_PLUGIN_ROOT}/hooks/trailhead-check-update.js"
Files
The author's source, 3 files. They load when you open them.
Facts
- Author
- ToRvaLDz
- Category
- Workflow
- Marketplace
- trailhead
- Folder
- plugins/trailhead
- Version
- 0.15.0
- License
- MIT
- Repo stars
- 26
- Last change
- 2026-10-16
- Language
- JavaScript
- Files
- 159