Browse documentation

Install GliderTrace

Choose your client and operating system. Follow the three stages below to connect one local workspace.

1. Install

Requires .NET 10 SDK. Run this in your terminal. The command installs the executable on your machine.

dotnet tool install --global glider-trace

Then confirm that the executable starts:

glider-trace --version

Future packages will expire 90 days after release. Existing versions retain their original expiry. Keep the installed product updated. Update instructions →

2. Connect

Use the absolute path to your project directory. The server stays tied to this workspace.

Paths stay in this page. They are not saved or sent to analytics.

Example configuration. Enter your project path before you use it.

Merge this entry into the file below. Keep existing settings and other servers. Replace an existing entry with this name instead of duplicating it.

.gemini/settings.json

{
  "mcpServers": {
    "glider-trace": {
      "command": "glider-trace",
      "args": [
        "--workspace",
        "/path/to/MyApp",
        "--default-timeout",
        "30m"
      ],
      "cwd": "/path/to/MyApp",
      "timeout": 1800000
    }
  }
}

Merge the entry with any existing settings and MCP servers.

3. Verify

Restart Gemini CLI from your project root. Run /mcp and check that the server is connected.

Ask your agent
Use GliderTrace trace_status to show the workspace roots and runner policies. Confirm that my project is the intended workspace. Do not execute a command yet.

The status includes your workspace and the available runner policies. Run a test only when you choose the next task.

Agent instructions →