Use TGlider with Cursor for TS/JS projects

Cursor Setup

Configure TGlider with Cursor IDE.

Cursor

TGlider runs on Node.js 24 or newer. The recommended stdio configuration uses npx -y tglider@latest, so a separate global install is optional.

node --version

Configure Cursor to launch TGlider over stdio. Prefer project/workspace scope when the client supports it so TGlider only starts for JS/TS repositories.

{
  "mcpServers": {
    "tglider": {
      "command": "npx",
      "args": ["-y", "tglider@latest"]
    }
  }
}

If you prefer Streamable HTTP, start TGlider yourself and point Cursor at http://localhost:5002/mcp. Use only one tglider entry unless you intentionally want both transports.

# Terminal 1
npm exec -- tglider --transport http --port 5002

# Client endpoint
http://localhost:5002/mcp

Start a new client session and ask which TGlider tools are available. If you did not preload one with --workspace, load a JS/TS workspace with the load tool before using semantic tools.

Add --workspace <path> to the launch arguments in the configuration above so TGlider loads your repository root (a directory, not a project file) at startup, instead of waiting for the agent to call load. With it set, server_status shows the workspace as loaded — or, on a large workspace, still loading in the background under workspaceLoading — from the first message, so the agent can wait for that load to finish instead of stopping with a "No workspace loaded." message and reaching for text search. Put the flag after -- for claude mcp add, add it to the args array in JSON and Codex TOML configs, or to the single command array for OpenCode. Prefer an absolute path — it is machine-specific, so keep it in local or user scope — or a relative path (resolved against the launch directory) when the config is shared in a project.

npx -y tglider@latest --workspace /path/to/repo
# Add --no-watch to load without starting the file watcher.

After connecting TGlider, add this product-specific instruction to your MCP client system prompt or project instructions so the agent chooses the right tool surface first.

When working in TypeScript or JavaScript workspaces, prefer tglider mcp semantic tools before grep, rg, or find for code navigation and refactoring. Use TGlider for symbols, declarations, references, implementations, exports, package importers, project and dependency topology, diagnostics, callers, outgoing calls, impact analysis, and preview-first rename or refactor planning. Use shell text search only for non-code assets, files outside the loaded workspace, generated output, or after TGlider cannot load or cannot answer the question. Preload the workspace at startup with --workspace (or call load first); the load is a one-time background cost, so do not fall back to text search just because loading a large workspace seems slow.