# TraceWeave

Connects simulation logs, waveforms and RTL source to your AI assistant so you can get from a failed run to the right time, signals and driving logic.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 121
- Author: gokeshenzhen
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gokeshenzhen/TraceWeave
- Updated: 2026-10-13
- HTML: https://affpapa.org/en/nevibecode/mcp/traceweave

## What it does

TraceWeave links compile records, simulation logs, VCD/FSDB/FST waveforms and RTL source to your assistant. You describe the problem in plain language; the server investigates, traces and verifies, returning evidence you can review.

It reads logs from VCS, Xcelium and Verilator, and waveforms in VCD, FSDB and FST. Exported formal waveforms can be queried too, and automatic artifact discovery currently covers JasperGold. Signal tracing follows Verdi NPI → Source Graph → basic static analysis: it queries the elaborated KDB first, tries Source Graph without a commercial license when NPI is unavailable, then falls back to static analysis.

\`explain_signal_driver` now defaults to the compact `traceweave.driver.compact.v1` format. Legacy scripts that read the original JSON shape should request `output_format="full"` or expand the response with `expand_compact_result`. A static mode scans source for constant connections, open inputs and constant comparisons, no simulation run or waveform needed.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add traceweave -- uvx traceweave-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from traceweave-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add traceweave -- uvx traceweave-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from traceweave-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "traceweave": {
            "command": "uvx",
            "args": [
                "traceweave-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from traceweave-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "traceweave": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "traceweave-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from traceweave-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add traceweave uvx traceweave-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from traceweave-mcp <command>

## When to use it
- find why a simulation hangs or times out
- locate differences between two runs from records and waveforms
- trace where a signal picked up an X or Z value
- read packed bus fields and check whether TL-UL requests complete
- scan source for constant ties and unconnected inputs without simulating

## Example prompts
- The simulation timed out — narrow down the affected interfaces and time window
- This signal went X; trace the drivers and show the waveform history
- Check whether the TL-UL request completes and show latency and handshake

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md