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 as50, andtravsr config set embed.priority low - Pause an in-flight embedding reindex:
travsr daemon stop-embed(resume withtravsr 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.