ClaudeCodeMod

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.

In Claude Code
/plugin marketplace add ToRvaLDz/trailhead
/plugin install trailhead@trailhead
Open the repo

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

Claude Code with trailhead: the transcript and the pipeline band for ticket 208 at execute on the left, the status line trailhead map 198 under the prompt, and the map pane on the right with Maps, Frontier work buttons, In progress, Blocked, refresh, and close
From the author's repo.

What it hooks into

  • session.startWhen a session starts
  • prompt.composeWhile you write a prompt
  • prompt.submitWhen you send a prompt
  • session.compactWhen the context is compacted
  • turn.startWhen Claude starts a turn
  • turn.completeWhen a turn ends
  • tool.callAround a tool call, where it can hold oneBash
  • session.endWhen a session ends
  • classic.SessionStartA Claude Code event
  • ui.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
Repo
ToRvaLDz/trailhead
Folder
plugins/trailhead
Version
0.15.0
License
MIT
Repo stars
26
Last change
2026-10-16
Language
JavaScript
Files
159

Other mods in Workflow

notice-boardHolyGrailDraws a band of notices for the other sessions in this repo, or for every session on the machine.muslim-modsashafizullahDraws the next prayer under the prompt, with adhkar and a verse, and keeps a prompt typed during the salah break until it ends.superclaude-plusplusexcattToasts when a session loads, and checks each edit for conventions and console.log, in a framework of 44 skills and 9 agents.agent-raceOneWave-AIDraws a live race pane for the sessions you put on one track, with tools, files, and tests.inbox-alertsOneWave-AIDraws Gmail, Slack, and Calendar alerts as toasts, a status count, and a pane.cc-mod-parkGGGODLINParks a session with /park, then draws a button in a new session in that folder so you can resume it.vimeskanehiraTurns romaji in the prompt into Japanese, with a candidate band above the prompt, using anthy on this machine.credoMarcel-BichA framework of work items, roles, and modes for running sessions, with an optional band above the prompt for the mode and the item counts.handoff-compacttrytofly94Replaces compaction with a structured handoff that a fork of the session writes, and saves that handoff as a file.agentpanexuanji86Draws a side pane of every subagent, with its current tool, tokens, model, and effort, and its conversation one click away.repoqlRepoQLIndexes a repo through the RepoQL host so Claude can search its structure, and draws whether that host is ready or working.nomoreideRorogogogoDraws an optional side pane for NoMoreIDE, a local workbench for Git, services, and agents, by reading its daemon.
All 396 in Workflow