What is breadcrumbs?
breadcrumbs is a Claude Code mod by crockalet that a pane beside the session that Claude talks to you through: the task, what it is doing, the notes it files, the questions it went on without, and manual tests you run when you get to them. It is listed under Interface and has 1 GitHub stars.
| Type | Claude code mod |
|---|---|
| Author | crockalet |
| Repository | crockalet/claude-mods |
| Popularity | 1 GitHub stars |
| Category | Interface |
| Security | High risk (44/100) |
| Rank | #1,733 of 5,272 Claude Code mods; #700 in Interface |
| Last commit | 2026-10-12 |
| Hooks | 11 events |
| Sees | ? calls, classic hooks, every prompt, every tool call, mcp__breadcrumbs__edit_note calls, mcp__breadcrumbs__save_note calls, subagent spawns |
| Draws on | ToolUse, ToolResult, Pane |
Is breadcrumbs safe to install?
breadcrumbs scores 44/100 on the MCPMods security check: High risk. Things to review: starts processes outside the sandbox; writes files or config; reads environment variables; watches every prompt or event. It passed 2 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| No network access | Pass |
| Starts processes outside the sandbox | Review |
| Writes files or config | Review |
| Reads environment variables | Review |
| Watches every prompt or event | Review |
| Drives Claude (model calls, prompts) | Note |
| Passes claude plugin validate | Pass |
| No license detected | Note |
API calls in its code
| Call | What it means |
|---|---|
$.agent.register | |
$.clock.after | |
$.clock.every | |
$.clock.now | |
$.command.register | |
$.env.get | reads env vars |
$.fs.exists | reads files |
$.fs.list | reads files |
$.fs.read | reads files |
$.fs.stat | reads files |
$.fs.write | writes files |
$.model.complete | drives Claude |
$.process.run | runs processes |
$.prompt.fill | writes the prompt box |
$.prompt.submit | drives Claude |
$.session.cwd | |
$.session.id | |
$.session.messages | reads the transcript |
$.session.repo | |
$.session.send | |
$.state.get | |
$.state.set | |
$.store.get | keeps its own state |
$.store.set | keeps its own state |
$.tool.register | drives Claude |
$.ui.ask | draws interface |
$.ui.close | draws interface |
$.ui.copy | draws interface |
$.ui.invalidate | draws interface |
$.ui.log | draws interface |
$.ui.open | draws interface |
$.ui.panes | draws interface |
$.ui.resolve | draws interface |
$.ui.status | draws interface |
$.ui.toast | draws interface |
How do I install breadcrumbs?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/crockalet/claude-mods claude plugin validate ./claude-mods/plugins/breadcrumbs
- Install it. Run this in your terminal, then /reload-plugins in an open session.
claude plugin marketplace add crockalet/claude-mods && claude plugin install breadcrumbs@claude-mods
Or ask Claude to set it up
Paste this into Claude Code and it installs breadcrumbs for you:
Install the "breadcrumbs" Claude Code mod from https://github.com/crockalet/claude-mods/tree/main/plugins/breadcrumbs. Run claude plugin validate on it first and show me what it can access before you enable it.
More from crockalet/claude-mods
This repository has 3 Claude Code mods on MCPMods.
- breadcrumbs-launcher: Starts breadcrumbs' manual-test testers the moment you press Start, without going through the main agent. (High risk)
- secrets: Hand Claude an API token without it reading the value: you type it into a field above the prompt, Claude uses it in Bash (Review before installing)