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 Binary in the notification. The extension downloads the correct platform binary from GitHub Releases automatically.

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

# macOS (Apple Silicon)
curl -L https://github.com/Travsr-com/travsr/releases/latest/download/travsr-aarch64-apple-darwin.tar.gz | tar xz
sudo mv travsr /usr/local/bin/

Then set the path in settings:

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

Status bar shows "stale" after committing​

Symptom: Status bar shows Travsr · stale · Xm ago after a git commit.

Cause: The git post-commit hook is missing or not executable.

Fix:

# Reinstall the hook
travsr init

# Make sure it is executable
chmod +x .git/hooks/post-commit

Status bar shows "disconnected"​

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

Check 1: Socket path conflict: Another process may be using /tmp/travsr.sock. Kill it and restart:

rm -f /tmp/travsr.sock
travsr daemon start

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; travsr daemon status shows high RSS.

Cause: Large repos with many changed files per commit trigger expensive full SCIP re-runs.

Mitigation:

  • Set --log-level warn to reduce I/O
  • Increase the incremental index threshold: travsr daemon start --delta-threshold 50

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:

# macOS / Linux x86_64 on the remote
curl -L https://github.com/Travsr-com/travsr/releases/latest/download/travsr-x86_64-unknown-linux-musl.tar.gz | tar xz
sudo mv travsr /usr/local/bin/

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