Skip to main content
← VS Code Extension

VS Code Extension Troubleshooting

Binary not found​

Symptom: Extension shows a "binary not found" notification on startup.

Option 1: Use the built-in downloader: Click Download in the notification, or run Travsr: Download Binary. The extension downloads the release matching its pin from GitHub Releases, verifies the checksum, installs it into ~/.travsr/bin, and sets travsr.binaryPath.

Option 2: Install manually and point the extension to it:

# macOS (Apple Silicon); asset names carry the version, so there is no "latest" URL
VER=1.4.0
curl -L https://github.com/Travsr-com/travsr/releases/download/v$VER/travsr-v$VER-aarch64-apple-darwin.tar.gz | tar xz
sudo mv travsr travsr-lib /usr/local/bin/

The tarball contains the travsr binary and a travsr-lib/ directory (the bundled TypeScript, JavaScript and Python analyzers). Keep travsr-lib/ beside the binary.

Then set the path in settings:

{ "travsr.binaryPath": "/usr/local/bin/travsr" }

Health panel shows "Stale" or "Not watching" after committing​

Symptom: After a git commit, the Health panel verdict reads Stale (the graph describes an earlier commit) or Not watching (the daemon is stopped).

Cause: The daemon is not running, or the git hooks (post-commit, post-merge, post-checkout) are missing. The Health panel's Index freshness section shows whether the commit hook is installed.

Fix: Use the verdict's action (Start daemon or Reindex), or from a terminal:

# Reinstall the hooks and reindex
travsr init

# Start the daemon so later commits refresh the graph
travsr daemon start

Status bar shows "disconnected"​

Symptom: Status bar shows Travsr · disconnected (red).

Check 1: Restart: Click the status bar item and choose Restart daemon, or from a terminal:

travsr daemon status
travsr daemon restart

Check 2: Daemon logs:

travsr daemon logs --follow
# or open VS Code Output panel → "Travsr"

MCP not available in Claude Desktop​

Symptom: Claude Desktop doesn't list Travsr as an MCP tool.

Check 1: Config file path. Make sure you edited the correct config for your OS (see Quickstart).

Check 2: JSON syntax. Invalid JSON silently prevents all MCP servers from loading. Validate with:

node -e "JSON.parse(require('fs').readFileSync(process.env.HOME + '/Library/Application Support/Claude/claude_desktop_config.json','utf8')); console.log('valid')"

Check 3: Restart Claude Desktop. After editing the config, fully quit and relaunch (not just close the window).


High CPU / memory from the daemon​

Symptom: Fan spins up after commits.

Cause: Large repos with many changed files per commit trigger expensive semantic (Phase B) re-runs and embedding reindexes.

Mitigation:

  • Throttle embedding work: travsr config set embed.capacity auto (load-adaptive) or a percentage such as 50, and travsr config set embed.priority low
  • Pause an in-flight embedding reindex: travsr daemon stop-embed (resume with travsr daemon resume-embed)
  • Reduce log volume: travsr config set log.level warn (takes effect when the daemon next starts)

Extension not activating on SSH / Codespaces​

The extension activates when a workspace folder is open and travsr is available on the remote machine's PATH. Install the binary on the remote:

# Linux x86_64 on the remote
VER=1.4.0
curl -L https://github.com/Travsr-com/travsr/releases/download/v$VER/travsr-v$VER-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv travsr travsr-lib /usr/local/bin/

Then set travsr.binaryPath to the remote path if needed.