---
name: nikolai-vysotskyi-trace-mcp
description: "Use trace-mcp through bb to search indexed code and recall project decisions with compact context."
license: "MIT"
metadata:
  decimalai-skill-id: "c428f577-da17-4781-88c4-f3707b65d8fa"
  decimalai-version-id: "b15efebc-e33d-466f-816a-51baa36d2123"
  decimalai-version: "2"
  decimalai-body-sha256: "221514e640e13facaa13163b48e24e9302b1c00fcc4e79dd9f0100f7dfb66d55"
  decimalai-name: "nikolai-vysotskyi/trace-mcp"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "agent-tooling"
  decimalai-source: "https://app.decimal.ai/s/nikolai-vysotskyi-trace-mcp@2/SKILL.md"
---
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.