glider-trace 0.1.0

GliderTrace - Runtime Evidence MCP Server

GliderTrace is a runtime evidence MCP server for .NET workspaces. It runs workspace-scoped commands and tests, stores bounded evidence, and summarizes failures, exceptions, counters, and runtime traces.

Install

Prerequisite: .NET 10 SDK.

dotnet tool install --global glider-trace

If install fails, run dotnet --version first. If dotnet is missing or below 10, install .NET 10 from Microsoft .NET 10 download page.

Keep CLI tools on PATH (for example ~/.dotnet/tools on Linux/macOS) before running glider-trace.

To update:

dotnet tool update --global glider-trace

Run Modes

GliderTrace exposes two transports:

Stdio (default)

glider-trace

Run this when an MCP client starts a local MCP stdio process.

HTTP

glider-trace --transport http

HTTP MCP endpoint is http://localhost:5001/mcp (or your chosen --port).

Common CLI arguments

MCP Tools

• trace_status — Server readiness, workspace/artifact state, retention/redaction defaults, and expiration status.
• trace_run — Executes one command in the workspace and stores runtime session evidence.
• trace_start — Starts a long-running workspace command and begins evidence capture.
• trace_stop — Stops an active session started by trace_start and finalizes evidence.
• trace_list_processes — Lists local .NET processes that can be attached for diagnostics.
• trace_attach — Captures a bounded runtime trace artifact from a running .NET process.
• trace_capture_dump — Captures a sensitive process dump artifact for a running process.
• trace_capture_gcdump — Captures a sensitive GC dump artifact for a running process.
• trace_run_tests — Runs tests and stores test evidence, artifacts, and results.
• trace_get_session — Returns stored session metadata, summaries, and artifact references.
• trace_query_events — Returns filtered evidence events for a session.
• trace_export — Exports session summaries, CI summaries, and artifact bundle references.
• trace_correlate_code — Maps runtime evidence stack frames to C# symbols.
• trace_exceptions — Returns grouped exception evidence for a session.
• trace_counters — Returns summarized counters.csv evidence for a session.
• trace_hotspots — Returns summarized CPU hotspot evidence from runtime traces.

Local Dependencies

Required runtime:

• .NET 10 SDK
• dotnet on PATH

Optional features:

• dotnet-counters — enables collectCounters in trace_run.
• dotnet-gcdump — enables trace_capture_gcdump.

Test support depends on the project/test setup (dotnet test + TRX-capable logger configuration).

CI Evidence Summaries

After a failed test or runtime session, export an agent-ready CI summary:

{
  "sessionId": "trc_...",
  "format": "ci-summary-md",
  "includeRawArtifacts": false
}

ci-summary-json and ci-summary-md order critical/error evidence before warnings, include artifact references, and exclude sensitive raw artifact contents.

Version Expiration

Each glider-trace version expires 1 month after release date.

dotnet tool update --global glider-trace

Troubleshooting

• glider-trace command not found: ensure the global tool folder is on PATH (for example ~/.dotnet/tools).
• trace_run rejects command: by default only dotnet is allowed; use a workspace command that matches the allowed command policy.
• trace_list_processes returns no processes: no local .NET process is currently published to diagnostics IPC.
• trace_capture_dump or trace_capture_gcdump blocked: set acknowledgeSensitive=true and confirm optional tools are installed.
• Counter capture fails: install dotnet-counters and rerun with collectCounters=true.
• trace_run_tests misses TRX evidence: verify test project and logger configuration for TRX support.
• Long operations cancel unexpectedly: increase --default-timeout or set 0 to disable.

License

All Rights Reserved