VS Code Extension
The Travsr VS Code extension brings the code graph directly into your editor, status bar, code lenses, hover cards, and a full sidebar of panels.
Install
ext install travsr.travsr-vscode
Or search "Travsr" in the Extensions panel.
Also available on Open VSX for VSCodium and compatible editors.
Binary auto-install
The extension looks for the travsr binary in travsr.binaryPath, then ~/.travsr/bin, then your PATH. If none resolves, it shows a notification ("Travsr binary not found, Download v1.4.0?") with a Download button. Clicking it downloads the matching release tarball from GitHub Releases, verifies its SHA-256 checksum, extracts the binary and its bundled travsr-lib/ analyzers into ~/.travsr/bin, and sets travsr.binaryPath to it. It does not modify your PATH. No npm required.
To use a binary you already have at a custom path, set travsr.binaryPath in settings.
The same pages in a browser
The Health, Graph, Callers, Dependencies, Blast radius, Execution path, Architecture and Repos pages are also available without an editor: run travsr ui and open the address it prints.
Tool errors
When a Travsr MCP tool rejects a call or fails, the extension shows the server's message once as a warning and treats the result as empty, so a panel never tries to read an error sentence as rows or graph JSON.
Status bar
The status bar item shows the current graph state. It polls get_graph_stats every 30 seconds. $(...) below stands for the VS Code icon shown in that spot.
| Indicator | Meaning |
|---|---|
$(sync~spin) Travsr | Extension is connecting to the daemon |
$(graph) Travsr · fresh · 18,400 nodes (green) | Graph answered the last poll |
$(sync~spin) Travsr · indexing… | A file was just saved (or .travsr/ was recreated); re-polls after 2 seconds |
$(error) Travsr · disconnected (red) | The MCP server process is unreachable |
The status bar is a quick liveness signal. For whether the graph is actually current with your checkout, open the Health panel, whose verdict banner reports Stale, Not watching and the other states.
Clicking the item opens a Travsr actions QuickPick:
| Item | Action |
|---|---|
| Health | Open the Health panel |
| Registered repos | Open the Repos panel |
| Re-index now | Run Travsr: Re-index Now |
| Restart daemon | Restart the daemon and reconnect |
| Open settings | Open the travsr settings |
| Show output channel | Show the Travsr output channel |
| Disable extension | Confirm, then open the extension's page so you can disable it |
| Close | Dismiss |
The colours come from the travsr.freshForeground, travsr.staleForeground and travsr.errorForeground theme colours; see Settings: Theme colors.
Active repository
When more than one git repository is open in the window (several workspace folders, or several repos inside one folder), a second status bar item shows the repository Travsr targets, for example $(repo) Travsr: my-service $(chevron-down). Language installs, language detection and init from the extension run in that repository. Click it, or run Travsr: Select Repository, to choose a different one; the choice is saved per workspace. With a single repository open the item is hidden.
Sidebar panels
The Travsr activity bar icon opens the sidebar, which has two tree views, Travsr Graph and Repo Files. Every panel below is also reachable from the command palette.
| Panel | Command | Description |
|---|---|---|
| Graph | Travsr: Show Graph | Visual Cytoscape.js graph for a symbol |
| Repo Files | (Repo Files view) | Hierarchical tree of every indexed file; see Repo Files Panel |
| Context Explorer | Travsr: Open Context Explorer | get_context results as a panel; see Context Explorer |
| Ask Symbol | Travsr: Ask Symbol | FTS search across all indexed symbols |
| Synonyms | Travsr: Manage Synonyms | Add and edit query-time synonym pairs |
| Repos | Travsr: Registered Repos | All repos in the Travsr registry |
| Health | Travsr: Health | Verdict, daemon, index freshness, languages, diagnostics, registry and daemon log; see Health Panel |
Code lens
Each supported file shows one blast radius code lens at the top, the number of files that would be affected if that file changed. Click the lens to open the Blast Radius panel.
🩻 blast: 12 files
import { Receipt } from "./receipt";
See Code Lens for full details.
Hover cards
Hover over any symbol to see its callers inline, with a one-click link to the full Callers panel and Blast Radius panel.
See Hover for full details.
Context Explorer
Travsr: Open Context Explorer (Cmd+Shift+K / Ctrl+Shift+K) opens a panel that runs the full get_context pipeline (PPR, knapsack, KNN, and trust signals) for the symbol under your cursor. It shows one of three states (strong, abstain, or degraded), per-node expandable snippets, a provenance legend, a token-saved bar, and a copy button. See Context Explorer.
Repo Files panel
The Repo Files view in the sidebar is a hierarchical tree of every indexed file, grouped package by package. Click a file to open its file graph. Travsr: Search Files opens a fuzzy QuickPick over all indexed files. See Repo Files Panel.
Editor code actions
The editor right-click menu has three Travsr actions: Check Blast Radius Before Edit, Open Context Explorer, and Copy Graph Context for Chat. The lightbulb offers the copy action on a symbol as Travsr: copy graph context for "<symbol>".
- Copy Graph Context for Chat (
travsr.copyContextForChat): runsget_contextfor the symbol under the cursor and copies the result to the clipboard so you can paste it into any chat. Respectstravsr.contextTokenBudget. - Check Blast Radius Before Edit (
travsr.blastBeforeEdit): runsget_blast_radiusfor the current file and tells you how many files depend on it, with Show Details to open the list.
Register the MCP server in an agent
Travsr: Register MCP Server in Agent writes the travsr mcp --stdio server entry into an external agent's config file. It supports Claude Desktop, Cursor (workspace .cursor/mcp.json), and Continue, and always shows a diff and asks for confirmation before writing.
Command palette
All Travsr commands are available via Ctrl+Shift+P / Cmd+Shift+P:
| Command | Description |
|---|---|
Travsr: Show Graph | Open the visual code graph panel (Cmd+Shift+G) |
Travsr: Open Context Explorer | Open the Context Explorer panel (Cmd+Shift+K) |
Travsr: Ask Symbol | Search for a symbol in the graph (Cmd+Shift+A) |
Travsr: Open File Graph | Open the dependency graph for a file |
Travsr: Search Files | Fuzzy-search all indexed files |
Travsr: Manage Synonyms | Open the Synonyms panel |
Travsr: Registered Repos | Open the Repos panel |
Travsr: Health | Open the Health panel |
Travsr: Show Status | Open the status bar's actions QuickPick |
Travsr: Select Repository | Choose which open repository Travsr targets |
Travsr: Refresh Graph | Refresh the Travsr Graph tree view |
Travsr: Refresh Repo Files | Reload the Repo Files tree |
Travsr: Show Callers | Callers panel for a symbol; opened from the hover card |
Travsr: Show Blast Radius | Blast Radius panel for a file; opened from the code lens or hover card |
Travsr: Check Blast Radius Before Edit | List files affected before you edit the current file |
Travsr: Copy Graph Context for Chat | Copy get_context for the current symbol to the clipboard |
Travsr: Show Dependencies | Show dependencies of the current file |
Travsr: Show Execution Path | Trace execution path between two symbols |
Travsr: Register MCP Server in Agent | Add the Travsr MCP server to Claude Desktop, Cursor, or Continue |
Travsr: Re-index Now | Run travsr init on the current repo, under a cancellable progress notification |
Travsr: Download Binary | Download the travsr binary |
Travsr: Show Welcome | Re-open the first-run welcome panel |
First-run welcome panel
On first install, a welcome panel lists the extension's features and two getting-started steps:
- Install the Travsr CLI
- Run
travsr initin your repository
The status bar turns green when the graph is ready. Reopen the panel any time with Travsr: Show Welcome. To add Travsr to an agent's MCP config, use Travsr: Register MCP Server in Agent.
Save-time live resolution
Between commits, the graph knows that user.save() is a call but not always which save. When you save a file, the extension asks the daemon which references in it the graph cannot settle on its own, resolves those positions through the language extension you already have installed (VS Code's definition and implementation providers), and reports the answers back. The daemon maps them to graph nodes itself. No language server is spawned or bundled, it runs in the background, and failures are silent: the next commit repairs anything it missed (RFC-027).
The daemon's live lane ships for TypeScript/JavaScript, Rust, Python, Go, Dart, Swift, C++, Java, C#, Kotlin, PHP, C and Objective-C. Ruby and Scala are deliberately not included. A language only resolves anything when you have an extension installed that provides go-to-definition for it.