Menu

Individual skill

trace-mcp

1upvote

Use trace-mcp through bb to search indexed code and recall project decisions with compact context.

integrations/bb/skills/trace-mcp/SKILL.md

Read pinned source

Source commit adac3f7d216a1d0f06353597a823cc65f13dc42b

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
Yes
Repository scan complete
No
Skill scan complete
No
Observed behavior
Instructions only
Last checked
Nov 11, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings)
203
Repository last updated
Nov 10, 2026
License
MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt

Use `trace_get_index_health` to check the index, then `trace_search` to find symbols before reading whole files. Use `trace_get_symbol` for an exact definition and `trace_get_outline` for file structure. Use `trace_get_project_memo` at the start of a task when prior decisions matter, `trace_query_decisions` for a focused recall query, and `trace_remember_decision` to record an explicit English-language decision with the current bb thread as its session ID. Automatic decision capture rejects non-English text; for a manually entered decision in another language use the panel or `bb trace remember`. For other capabilities, search the catalog with `trace_tools` and pass the selected tool name and arguments to `trace_call`.

The thread's **Trace context** panel shows index health, saved decisions, and the provider's context-window usage. The same data and explicit writes are available through `bb trace status`, `bb trace decisions`, `bb trace remember`, and `bb trace index`; pass `--thread <id>` outside a bb thread.

The plugin runs trace-mcp in the bb environment's repository on its host machine. A thread needs an environment with a path. On first use, indexing may take time. Tool results are capped; narrow or page a query when a result says it was shortened.
Back to top