bash-quoting-rescue

🧩 claude-mods

Small TypeScript mods that live inside Claude Code: a pane that knows your next step, one-click replies, a rate-limit countdown that resumes for you, your repo's pull requests and issues beside the conversation, a shelf of paths you use every day, presets that switch the model and the effort with one press, a chime when a long turn ends, a guard for the Office file you left open, a question before a commit or push on the default branch, a question before Claude reads a .env or key file, a list of the files this session made, a list of the ones it read, a check that keeps banned claims out of a pull request, a gate that runs your checks and hands back only the failures, a nudge to fetch fresh tab IDs when a browser tab is gone, a name for the session from its first prompt, and one dialog for every mod's settings.

claude-mods is one developer's personal toolbox of Claude Code mods, shared as a plugin marketplace so anyone can install them. The mods are built for the author's own workflow first, and you are a welcome guest: install one, install all twenty, or read the source and write your own.

What is a mod?

A mod is a plugin of function hooks: TypeScript that runs inside Claude Code and changes what it shows (a pane in the side panel, a band of buttons above the prompt, the status line) or what it does between turns. The mod's own code decides when to act, even when what it does is send the model a prompt.

	Runs as	Who decides when it acts
Mod	TypeScript function hooks inside Claude Code	The mod's own code
Skill	Instructions the model reads	The model
Plain plugin	Commands, agents or shell hooks	You, or a shell script

The mods

Mod	Where it shows	What it does
🧭 whats-next	Pane in the side panel	Lists the next steps of your workflow, each with a prompt ready to paste
⚡ quick-reply	Band above the prompt	One-click replies, including the options Claude just offered, Pass, Fail and Skip for a verdict, and the next wayfinder ticket
⏳ auto-resume	Band and status line	Counts down to a rate limit's reset, then sends "continue"
🐙 github-panel	Pane in the side panel	The repo's open pull requests and issues, one click from the browser or from /implement and /wayfinder in the prompt; the issue a /wayfinder run works on, pinned with its next ticket; a toast when your branch's checks turn green or red
📚 shelf	Band above the prompt	Named folders and files; one click drops a path into what you are typing
🔔 turn-chime	Sound and toast	Tells you when a long turn ends or Claude stops to ask you something
🔒 open-file-guard	Question dialog	Asks you to close a Word, Excel or PowerPoint file before Claude uses it
🌿 branch-guard	Question dialog	Asks you before Claude commits or pushes on the default branch
🔑 env-guard	Question dialog	Asks you before Claude reads a .env or key file, and refuses when no one is there to answer
🩹 bash-quoting-rescue	Refused tool call	Stops a shell command that does not parse, such as an unclosed quote, before any of it runs
📂 outputs	Pane in the side panel	The files this session made or changed, newest first; click one to open it
🔎 sources	Pane in the side panel	The files Claude read, grouped by where they came from, with a lock to the project folder
📊 hud	Two lines under the prompt	Model, effort, context window, rate limits, turn timer, tool calls, agents, git state, worktree, cost, session length and folder, each named and in colour
🧹 post-merge-cleanup	Question dialog and toast	After a PR merges, /cleanup switches to the default branch, pulls and deletes the branch
🧾 pre-pr-claims-check	Refusal Claude reads	Refuses gh pr create and gh pr edit while the pull request cites a file and line, holds a placeholder, or spells out a count
🚦 lint-test-gate	Band above the prompt	Runs your checks on a press and before Claude's git commit, and hands back only the failures
🔄 chrome-tab-self-heal	Note after a browser tool's error	When a Claude in Chrome tab is gone, tells Claude to fetch the current tab IDs before it tries again
🏷 session-auto-namer	Band above the prompt	Suggests a name for the session from its first prompt; one press renames it
🧠 model-effort-presets	Band above the prompt	Plan and execute presets: one press switches the model and the effort together
⚙ mod-settings	Gear on each pane; a dialog	Change and save any mod's settings without leaving the session

When more than one mod has a pane open, Claude Code shows them as tabs in the side panel.

🧭 whats-next

A pane listing the next steps of your workflow for the project folder, kept between sessions. A skill of your choosing answers "what's next" in a headless run beside your session, and the mod turns the answer into steps.

What's next                        refresh
updated 3 min ago

Fix the failing parse test
working on it  done
The check is red, so nothing else can merge.

Open a pull request for the fix
Review comes before the next feature starts.

Triage the two new issues
They arrived while you were heads-down.

flowchart LR
    A[Skill answers<br/>what's next] --> B[Steps in the pane]
    B --> C[You read a step's prompt<br/>and send it yourself]
    C --> D[Step glows:<br/>working on it]
    D --> E{Laya, Jev or Haiku:<br/>is the step finished?}
    E -- not yet --> D
    E -- yes --> F[Step leaves the list]

• You stay in charge. A step's prompt reaches the model only when you read it and send it yourself. Click a step to see its prompt, then paste it, paste it into a fresh session (after your prime command, if you name one), or copy it.
• It notices when you are done. After each answered turn, a System One model is asked whether the step is finished, as your System One models setting allows, and Haiku when none answers surely enough. A finished step leaves the list. Press d to drop it yourself.
• The run that asks is read-only. By default it gets only read commands of git and gh plus Read, Glob and Grep. git push, git config, git -c, gh api and --output are always denied.

Command or key	What it does
/whats-next	Bring the pane to the front
/whats-next refresh	Ask the skill again
r	Refresh
1 to 9	Show that step's prompt in the pane
p, n, c	Paste the shown prompt, paste it after /clear (and the prime command, once its turn ends), or copy it
b	Back to the list
d	Mark the active step done

Setting	Key	Default	Meaning
Skill	skill	/ask-sean	The skill that answers "what's next", written as you would run it: / followed by letters, digits, _, :, . or -
Most steps	maxSteps	5	How many steps to ask for (1-9)
Refresh on start	refreshOnStart	on	Ask for a fresh list when a session starts in a git repository
Tools the headless run may use	allowedTools	empty: the read-only set	Comma-separated permission rules for the headless run
Model	model	empty: your default	Model for the headless run, as an alias (haiku) or a full id
Prime command	primeCommand	empty: none	A slash command, with any arguments, run after /clear and before the paste (/lril:prime); the prompt is filled once the turn it starts ends, finished or not. A value that is not one slash command on one line is never run, and the step view says so
System One models	modelChoice	local only	Which System One model judges whether a turn finished the active step: local only (Laya on this machine, or Haiku as before), local first (Laya, and TypeSafe's hosted Jev while Laya is unavailable) or hosted first (Jev, and Laya while Jev is unavailable)
Jev API key	jevApiKey	empty	Your key for Jev, from console.typesafe.ai, kept in secure storage. Sent only to https://api.typesafe.ai, and only while System One models allows Jev
Laya port	layaPort	8000	The port your laya-serve listens on at 127.0.0.1 (1-65535)

/ask-sean is the author's own skill, so point the Skill setting at a skill of yours that answers "what should I do next?" (how to set it):

echo '{"skill": "/next-steps", "maxSteps": "3", "model": "haiku"}' | claude plugin configure whats-next@claude-mods --values-stdin

The read-only set, used while Tools is empty, is Bash(git status:*), Bash(git log:*), Bash(git diff:*), Bash(git show:*), Bash(git rev-parse:*), Bash(git branch --show-current), Bash(git branch -vv), Bash(git remote -v), Bash(gh issue list:*), Bash(gh issue view:*), Bash(gh pr list:*), Bash(gh pr view:*), Bash(gh pr checks:*), Bash(gh run list:*), Read, Glob and Grep.

• A list you write replaces that set; it does not add to it. To widen the set, write all of it plus your additions.
• Each rule is a tool name, optionally followed by (...). One rule that is not, such as one starting with -, discards your whole list and the read-only set is used.
• The run can always call Skill, so a skill that calls another still works. MCP servers load only when a rule names an mcp__ tool.

What the judge sends to a System One model, once after each answered turn while a step is active:

• To Jev, only while System One models allows it and the folder is not marked local-only: the active step's title, reason and prompt and the last 8,000 characters of Claude's answer. Never the contents of a file the mod read itself.
• To Laya, which keeps it on this machine: the same, fitted to Laya's small window. The step's prompt is dropped first, then the start of the answer, so the end of the answer, where Claude says whether the work is done, is kept.
• Sure answers only. "Done" counts at a probability of 0.9 or more and "not done" at 0.1 or less. Anything between, a model that is busy or fails, or no answer within 5 s leaves the step to Haiku, as before.
• A key it cannot use is named. While System One models allows Jev, a missing key, one that is not a key, or one TypeSafe rejects is named on a line in the pane, and the list stays. A rejected key stays off until the mod reloads.
• A changed key takes effect once the mod reloads. Saving it in the settings dialog reloads the mod; a key changed any other way waits for the next start of Claude Code.

Needs: the claude CLI on the PATH, and the skill named in the Skill setting. Laya and a Jev key are optional: with neither, the judge is Haiku, as before.

⚡ quick-reply

One row of buttons above the prompt after each answer. When Claude ends on a question, the band offers the choices Claude asked you to pick from, then your replies to a question. After any other answer it offers your other replies. You set both lists in the settings below.

Reply:  [a: Keep the copies]  [b: Add a sync script]  [Yes]  [Go with your recommendation]  [No]

• A choice's button sends its marker with its label, so the model cannot misread it.
• A numbered report before a yes-or-no question ("Shall I commit?") is not offered as choices.
• When the answer recommends something, the "recommend" reply is the highlighted one. Advice against something does not count.
• The band stays out of the way while Claude is working, and after a subagent's turn.
• A model can read the ending too. After each answered turn, a System One model is asked how the answer ends, as your System One models setting allows: whether it asks you something, whether its numbered items are choices, and which one it recommends. The band shows its own reading at once, and a sure answer that arrives within 2 s takes its place, so a numbered report closed by "push now or wait?" is not offered as choices.

Verdicts. When Claude asks for a pass/fail verdict on a test or a check, as a UAT or /gsd:verify-work step does ("Pass or fail?", "Did it pass?", "Type pass or describe what's wrong"), the band offers a verdict in place of your replies:

Reply:  [Pass]  [Fail…]  [Skip]

Pass sends "pass" and Skip sends "skip", as your own message. Fail… sends nothing: it puts "Fail: " in the prompt, where you say what went wrong and can paste a screenshot. A test's numbered steps are not offered as choices, and a question that only mentions passing ("Shall I make the tests pass?") gets your usual replies.

Next ticket. When you work a map with the wayfinder skill, the band leads with the next ticket after each turn that closes one or charts the map:

Reply:  [Next ticket: /wayfinder 135]  [Continue]  [Commit and push]

One press runs /clear and then /wayfinder 135, the loop you would otherwise type. It is offered only in a session that ran the wayfinder skill, after a turn whose gh issue close worked; after charting it names the map the turn created. A close made some other way (gh api, the web) is not seen, so no button shows, and once a turn closes the map itself the loop ends.

Setting	Key	Default	Meaning
Replies to a question	questionReplies	`Yes\	Go with your recommendation\	No`	Shown after Claude asks something, separated by `\	`; empty shows only the choices Claude offered
Replies otherwise	idleReplies	`Continue\	Commit and push`	Shown after any other answer; empty hides the band then, except for Next ticket
Offer the next wayfinder ticket	wayfinderNext	true	After a wayfinder turn closes a ticket or charts a map, offer Next ticket
System One models	modelChoice	local only	Which System One model reads how each answer ends: local only (Laya on this machine, or the band's own reading as before), local first (Laya, and TypeSafe's hosted Jev while Laya is unavailable) or hosted first (Jev, and Laya while Jev is unavailable)
Jev API key	jevApiKey	empty	Your key for Jev, from console.typesafe.ai, kept in secure storage. Sent only to https://api.typesafe.ai, and only while System One models allows Jev
Laya port	layaPort	8000	The port your laya-serve listens on at 127.0.0.1 (1-65535)

Each list holds up to six replies. A reply longer than 120 characters is cut short, and a repeat is dropped. For example, to answer questions with your own three replies and hide the band after other answers (how to set it):

echo '{"questionReplies": "Yes|No|Explain that first", "idleReplies": ""}' | claude plugin configure quick-reply@claude-mods --values-stdin

What the band sends to a System One model, once after each answered turn:

• To Jev, only while System One models allows it and the folder is not marked local-only: the last 8,000 characters of Claude's answer and the labels of the choices found in it. Never the contents of a file the mod read itself.
• To Laya, which keeps it on this machine: the answer's closing lines that fit Laya's small window, where the question is, and at most 9 labels of at most 40 characters.
• Sure answers only. Each part of the reading counts only when the model is sure of it, at 0.9 or more (0.1 or less for "these are not choices"). Anything less, a model that is busy or fails, a reading Laya reports as cut, or no answer within 2 s leaves the band's own reading. So does a reading that arrives after your next prompt.
• A key it cannot use is named. While System One models allows Jev, a missing key, one that is not a key, or one TypeSafe rejects is named on a dim line under the replies, until your next prompt. A rejected key stays off until the mod reloads.

Laya and a Jev key are optional: with neither, the band reads each answer as before.

⏳ auto-resume

When a turn dies on a rate limit or an overloaded API, auto-resume counts down to the reset and sends "continue" for you. Go to lunch, and come back to finished work.

⏳ rate limited:  sending "continue" in 1 h 12 min  [Resume now]  [Cancel]

• The countdown shows above the prompt and in the status line.
• Send a prompt of your own and it steps aside: you took over.
• It gives up after too many resumes in a row without a successful answer.

Command	What it does
/auto-resume	Say what is waiting, if anything
/auto-resume now	Send the resume now
/auto-resume cancel	Cancel the wait
/auto-resume in <minutes>	Schedule a resume yourself (1 to 1440)

Setting	Key	Default	Meaning
Resume prompt	text	continue	What is sent when the wait is over; empty sends continue
Grace after reset (s)	graceSeconds	60	Extra seconds to wait past the limit's reset time (0-900)
Retry overloaded/server errors	retryOverloaded	on	Also resume after an overloaded or server error, backing off from one minute
Most retries in a row	maxRetries	5	Give up after this many resumes without a successful answer (1-20)

For example, to send a longer prompt and wait two minutes past the reset (how to set it):

echo '{"text": "continue where you left off", "graceSeconds": "120"}' | claude plugin configure auto-resume@claude-mods --values-stdin

🐙 github-panel

A GitHub pane beside What's next listing the repo's open pull requests and issues. Click one to open it in the browser. Under each issue, implement and wayfinder put /implement or /wayfinder and the issue's URL in the prompt. Nothing is sent. While a /wayfinder effort is under way, its issue is pinned at the top, with the next ticket to take.

octocat/hello-world                refresh
updated just now

Decide how shared code is copied unpin
3 done · 1 takeable · 1 claimed · 2 blocked
next: Pick the drift check decision
work next

Pull requests 2                        all
#41 Add a drift check for copied guards
  draft · @octocat
#40 Bring the asked pane to the front
  ✗ checks failing · @hubot           fix

Issues 2                               all
#39 Share the headless-session check
  blocked by #12 · ready… implement wayfinder
#12 Decide how shared code is copied
  needs-triage · @hubot implement wayfinder

• An issue blocked by an open issue has a red line under it. Hover it to see what blocks it.
• In a narrow pane the implement and wayfinder buttons take a line of their own.
• The lists refresh on a timer, after a turn once they are a minute old, and on r.
• The pull request of the branch you are on is watched: when its checks turn green or red, a toast says "Checks passed on #40" or "Checks failed on #40". The first refresh, and the first after you switch branch, only notes where the checks stand.
• While that pull request's checks fail, its row has a fix button. It fills the prompt box with the failed checks' names, the last 40 lines of the failed run's log, and "Fix it." Nothing is sent: you read it and send it yourself. The log is fetched only when you press fix; when gh cannot fetch it, such as while the run is still going, the prompt holds the names alone.
• Running /wayfinder on an issue of this repo (/wayfinder 12, /wayfinder #12 or the issue's URL) pins that issue and brings the pane to the front. Anything else, such as prose or another repo's issue, pins nothing. The pin is kept for the repo across sessions, one at a time: a run on another issue replaces it. It goes when you press unpin, or once the issue is closed.
• The pinned issue's sub-issues are its tickets, each counted once: closed ones are done, open ones with an open blocker are blocked, assigned ones are claimed, and the rest are takeable. next is the first takeable ticket in the order the issue lists its sub-issues, with its wayfinder: type label; click it to open it on GitHub. With nothing takeable it says so; an issue with no sub-issues yet says no tickets yet.
• work next fills /wayfinder and the pinned issue's URL into the prompt, without sending it, so the skill takes the frontier ticket fresh when it runs.
• The pinned issue is read in the same refresh as the lists. When a refresh fails, the last section stays and the error shows.

Command or key	What it does
/github	Bring the pane to the front and refresh it
r	Refresh
all	Open the whole list on GitHub
implement, wayfinder	Fill the command and the issue's URL into the prompt, without sending it
fix	Fill a request to fix the current branch's failing checks into the prompt box
unpin	Drop the pinned issue
work next	Fill /wayfinder and the pinned issue's URL into the prompt, without sending it

Setting	Key	Default	Meaning
Most items per list	limit	30	How many open pull requests and issues to list each (1-100)
Refresh every (minutes)	refreshMinutes	5	How often to refresh (0-120); 0 refreshes only on open, after turns and on r
Implement button fills	implementCommand	/implement	The slash command the implement button fills before the issue's URL; empty hides the button
Wayfinder button fills	wayfinderCommand	/wayfinder	The slash command the wayfinder and work next buttons fill before the issue's URL, and the skill whose runs pin an issue; empty hides the button and turns pinning off

A command must start with / and hold no spaces. Any other value falls back to the default, and a message says so when the session starts. A button is labelled with its command, without the /.

For example, to list fifty of each and stop the timer (how to set it):

echo '{"limit": "50", "refreshMinutes": "0"}' | claude plugin configure github-panel@claude-mods --values-stdin

Needs: the GitHub CLI, logged in, and a folder with a GitHub remote.

📚 shelf

A row of named folders and files above the prompt, for the paths you type again and again. Click a name and its path lands at the cursor in what you are typing. Nothing is sent.

Shelf:  [brand]  [records]  [kb]

• A path with a space arrives in double quotes, ready to use.
• The shelf is the same in every project folder and every session.
• When the names do not fit one row, the band shows those that do and counts the rest; /shelf always lists them all.

Command	What it does
/shelf	List the shelf with each path
/shelf add <name> [path]	Put a path on the shelf; with no path, the project folder
/shelf remove <name>	Take one off

The shelf has no settings: you fill it with /shelf add.

/shelf add brand "N:/Marketing/Brand Kit"
/shelf add records N:/RECORDS
/shelf add kb
/shelf remove brand

• A name is one word of up to 24 characters. Adding a name already on the shelf, whatever its capitals, replaces that entry where it stands.
• The path is k