GliderTrace runs locally as a .NET global tool and stores runtime evidence under the configured workspace artifact root.
Most workflows need only the .NET SDK and an MCP client. Optional diagnostics collectors unlock counters, GC dumps, and extra runtime artifacts.
The server scopes command and test runs to a workspace root.
| Area | Current support | Notes |
|---|---|---|
| .NET SDK | Required | Install .NET 10 SDK before installing or running glider-trace. |
dotnet on PATH | Required | Needed for global-tool execution and default command/test workflows. |
| Workspace root | Required | Defaults to the current directory. Override with --workspace when the MCP client starts elsewhere. |
| Test projects | Supported | trace_run_tests runs dotnet test and stores stdout, stderr, TRX, and normalized evidence when the project emits it. |
| Long-running commands | Supported | trace_start and trace_stop capture evidence across a running interval. |
| Area | Current support | Notes |
|---|---|---|
dotnet-counters | Optional | Enables counter collection and trace_counters summaries. |
dotnet-gcdump | Optional | Enables trace_capture_gcdump for explicit GC dump capture. |
| EventPipe traces | Supported | trace_run, trace_attach, and trace_hotspots work with runtime trace artifacts. |
| Process dumps | Opt-in | trace_capture_dump requires acknowledgeSensitive=true. Dumps can contain application data. |
| Area | Current support | Notes |
|---|---|---|
| Artifact root | Local | Defaults to <workspace>/.glider-trace. Override with --artifact-root. |
| Stdout/stderr | Captured | Stored as session evidence and summarized for agents. |
| Raw dumps | Sensitive | Dump and GC dump capture is explicit and marked sensitive. |
| Exports | Bounded | trace_export returns compact summaries or artifact references. Raw sensitive artifacts are excluded by default. |
| Area | Current support | Notes |
|---|---|---|
| Claude Code | Supported | Use stdio project scope for local runtime evidence; HTTP is available when the server is started separately. |
| Codex | Supported | Use config.toml with stdio or Streamable HTTP. |
| Cursor, Copilot, Gemini CLI, OpenCode, Pi | Supported | Use direct command-based MCP configuration where available. |
| Stdio | Default | The default transport when an MCP client launches glider-trace. |
| Streamable HTTP | Supported | Run glider-trace --transport http. Default port is 5003 so it can run beside Glider on 5001. |
trace_run accepts dotnet commands.