Use TGlider with Codex

Codex Setup

Configure TGlider with Codex CLI, Codex IDE extension, and Codex app.

Codex

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 Codex to launch TGlider over stdio. Prefer project/workspace scope when the client supports it so TGlider only starts for JS/TS repositories.

# ~/.codex/config.toml
[mcp_servers.tglider]
command = "npx"
args = ["-y", "tglider@latest"]
startup_timeout_sec = 30
tool_timeout_sec = 1200

If you prefer Streamable HTTP, start TGlider yourself and point Codex 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.

In the Codex app, open Settings > Integrations & MCP to add or manage the same MCP server configuration. Advanced edits still go through config.toml.

The TGlider plugin is published from glidermcp/glidermcp.com and bundles the product skill plus stdio MCP config. After adding the marketplace, install tglider from the Codex app Plugin Directory or from the CLI /plugins browser.

codex plugin marketplace add glidermcp/glidermcp.com

Start npm exec -- tglider --transport http --port 5002, then configure Codex with http://localhost:5002/mcp.

# ~/.codex/config.toml
[mcp_servers.tglider]
url = "http://localhost:5002/mcp"
tool_timeout_sec = 1200

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.