Skip to main content
← VS Code Extension

Health Panel

The Health panel answers one question: is Travsr working for this repository, and if not, what fixes it. It reports the daemon, index freshness, sidecars, storage, languages, agent connections and the repository registry on one page, and every problem it reports carries its fix.

Open it with Travsr: Health from the command palette, from the ⋯ menu of the Travsr Graph view, or by clicking the status bar item and choosing Health.

Travsr Health panel
Graph Stats and Languages were folded in here

Extension 0.12.0 merged the old Graph Stats and Languages panels into this page. The command id is still travsr.showGraphStats, and the old travsr.showLanguages id is kept as an alias that opens Health, so existing keybindings keep working. See Languages.

The header names the repository and its path, says when the page was last checked, and has two controls:

  • Refresh re-reads everything without reindexing.
  • Auto refreshes the whole page on a timer: Off (the default), 5s, 15s, 30s or 60s. Every tick is a full redraw, so filters and scroll position reset.

Verdict banner​

The page opens with one verdict, most serious first. Each carries a word as well as a colour, and most carry the one action that fixes them.

VerdictWhenAction
No graph yetThe repository has not been indexed. Indexing also starts the daemon.Index this repo
Not answeringTravsr could not be reached, so the numbers below are read from the graph on disk.Start daemon
Not watchingQueries work from the graph on disk, but the daemon is not running, so commits and saves will not refresh the graph.Start daemon
StaleThe graph describes an earlier commit than your checkout.Reindex
DegradedThe graph is fresh, but one or more errors or warnings affect what it can answer.See the diagnostics
HealthyGraph fresh at the indexed commit, with no analyzer or index problems reported.None

A stopped daemon outranks staleness: Start daemon catches the graph up and keeps it up, while a one-off reindex leaves nothing watching.

Metric cards​

CardDescription
NodesSymbol nodes in the graph on disk
EdgesCall, import and type-reference edges
SchemaGraph database schema version. Migrations run forward automatically when the daemon opens a graph built by an older version
DB sizeSize of .travsr/graph.db
Last indexedTime since the most recent index run. Turns amber and reads "stale" when the graph is behind your checkout
SemanticHow many of the repository's languages have full (Phase B) analysis, for example 5 of 6

Daemon​

Reports the daemon's own status sentence verbatim (as travsr daemon status prints it), whether queries are answering, whether anything is watching the repository, the process id, when it last stopped, the binary version, and the log file with a View log button that scrolls to the daemon log.

  • While the daemon runs, the section offers Restart and Stop. Stop asks first: queries keep working from the graph on disk, but commits and saves stop refreshing it.
  • While it is stopped, the section offers Start.

Index freshness​

Reads get_index_status from the daemon: the indexed commit, the checkout HEAD and how many commits it is ahead, whether the working tree has modified files that are not indexed yet, the Phase A state, and whether the git commit hook is installed (with an Install button when it is not). Header actions: Reindex and Full rebuild (travsr init --force).

A binary too old to serve get_index_status shows "Index status is not reported by this binary" rather than guessing.

Sidecars​

Lists the optional sidecars (for example the embedding backend) with their state, and Install or Reinstall where one is missing. When more than one embedding backend is available, the embed row offers Change model, which lists the backends and runs travsr embed switch for an installed model or travsr embed init --backend for one that still needs downloading. Both confirm first.

Storage and integrity​

The graph.db size, log size and file count, ghost paths (nodes that point at files that no longer exist), and whether the text index is consistent with the node table. Header actions: Run fsck (travsr fsck) and Compact (travsr fsck --fix).

Languages​

One row per language the repository contains. The Detect button runs travsr lang detect.

ColumnDescription
LanguageLanguage name. When the project needs external tools for full analysis, a needs: line under the name lists the prerequisites (for example a JDK and Maven or Gradle)
AnalysisThe CLI's own status for the language. A language that is the subject of a warning on the same page says so here
Global installedWhether the analyzer is installed on this machine
This repoThe CLI's per-repository state: always on, enabled, not enabled, or no analyzer
ActionThe one step that moves the row forward

Actions:

ButtonWhat it does
Install analyzerNothing is on the machine yet. Downloads the analyzer and turns full analysis on for this repository
Enable for this repoInstalled on this machine but off here. Turns it on for this repository; nothing is downloaded
Allow & enableOn Windows, full analysis for some languages needs your one-time permission to run with your own privileges, using your project's own build tools. Records the grant (travsr lang allow-unsandboxed), then enables the language
Set up againShown for a language that is setting_up, needs_toolchain or failed in travsr status. Runs travsr init to finish its setup; the tooltip carries the one next step the CLI gave for it
Re-run semanticShown when the page carries a warning for an otherwise active language. Redoes Phase B with a forced re-index
DisableTurns full analysis off for the language (travsr lang remove <language>)

If the resolved travsr binary is too old to report the fields this table reads, the section names the binary and offers a download or the travsr.binaryPath setting instead of rendering wrong rows.

Diagnostics​

Warnings from travsr status appear as cards. When a warning names a fix command, the card shows it with two buttons:

  • Run opens a terminal named "Travsr" and runs the command. Only a plain travsr ... invocation is run; anything containing shell syntax is copy-only.
  • Copy copies the command.

Agent connections​

Which agents (Claude Desktop, Cursor, Continue) have the Travsr MCP server registered, with Register per agent and Register all in the header. See Register the MCP server.

Repositories​

The global registry, with the repository you have open sorted first and entries whose database is gone sorted last. Header actions:

  • Prune stale (N) removes entries whose graph database no longer exists.
  • Remove test repos (N) removes registry entries left by test runs (names of the form .tmpXXXXXX). They are counted in one line rather than listed. The open repository is never treated as one.

Rows have no remove button of their own; per-row removal is in the Repos panel.

Recent activity​

Lifecycle events from the daemon, newest first.

Daemon log​

Reads the daemon's log file directly, so it works even when the daemon has crashed.

  • A filter box and severity chips: All, Info+, Warn+, Error.
  • File: a picker over the rotated log files, one per UTC day.
  • Lines (100 to all), Since (5m, 1h, 24h), and UTC and JSON toggles.
  • Write: sets the daemon's log level (travsr config set log.level). It takes effect when the daemon next starts; the panel says so and offers Restart daemon when the running daemon is still writing at the old level.

The page-level Auto control refreshes the log along with everything else.

CLI equivalents​

travsr status # index status and the warnings shown as diagnostics
travsr daemon status # the Daemon section's status line
travsr lang list # the Languages table
travsr repos # the Repositories section
travsr daemon logs # the Daemon log section