Skip to main content
← VS Code Extension

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.

IndicatorMeaning
$(sync~spin) TravsrExtension 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:

ItemAction
HealthOpen the Health panel
Registered reposOpen the Repos panel
Re-index nowRun Travsr: Re-index Now
Restart daemonRestart the daemon and reconnect
Open settingsOpen the travsr settings
Show output channelShow the Travsr output channel
Disable extensionConfirm, then open the extension's page so you can disable it
CloseDismiss

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.

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.

PanelCommandDescription
GraphTravsr: Show GraphVisual Cytoscape.js graph for a symbol
Repo Files(Repo Files view)Hierarchical tree of every indexed file; see Repo Files Panel
Context ExplorerTravsr: Open Context Explorerget_context results as a panel; see Context Explorer
Ask SymbolTravsr: Ask SymbolFTS search across all indexed symbols
SynonymsTravsr: Manage SynonymsAdd and edit query-time synonym pairs
ReposTravsr: Registered ReposAll repos in the Travsr registry
HealthTravsr: HealthVerdict, 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): runs get_context for the symbol under the cursor and copies the result to the clipboard so you can paste it into any chat. Respects travsr.contextTokenBudget.
  • Check Blast Radius Before Edit (travsr.blastBeforeEdit): runs get_blast_radius for 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:

CommandDescription
Travsr: Show GraphOpen the visual code graph panel (Cmd+Shift+G)
Travsr: Open Context ExplorerOpen the Context Explorer panel (Cmd+Shift+K)
Travsr: Ask SymbolSearch for a symbol in the graph (Cmd+Shift+A)
Travsr: Open File GraphOpen the dependency graph for a file
Travsr: Search FilesFuzzy-search all indexed files
Travsr: Manage SynonymsOpen the Synonyms panel
Travsr: Registered ReposOpen the Repos panel
Travsr: HealthOpen the Health panel
Travsr: Show StatusOpen the status bar's actions QuickPick
Travsr: Select RepositoryChoose which open repository Travsr targets
Travsr: Refresh GraphRefresh the Travsr Graph tree view
Travsr: Refresh Repo FilesReload the Repo Files tree
Travsr: Show CallersCallers panel for a symbol; opened from the hover card
Travsr: Show Blast RadiusBlast Radius panel for a file; opened from the code lens or hover card
Travsr: Check Blast Radius Before EditList files affected before you edit the current file
Travsr: Copy Graph Context for ChatCopy get_context for the current symbol to the clipboard
Travsr: Show DependenciesShow dependencies of the current file
Travsr: Show Execution PathTrace execution path between two symbols
Travsr: Register MCP Server in AgentAdd the Travsr MCP server to Claude Desktop, Cursor, or Continue
Travsr: Re-index NowRun travsr init on the current repo, under a cancellable progress notification
Travsr: Download BinaryDownload the travsr binary
Travsr: Show WelcomeRe-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:

  1. Install the Travsr CLI
  2. Run travsr init in 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.