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.
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.
Header
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.
| Verdict | When | Action |
|---|---|---|
| No graph yet | The repository has not been indexed. Indexing also starts the daemon. | Index this repo |
| Not answering | Travsr could not be reached, so the numbers below are read from the graph on disk. | Start daemon |
| Not watching | Queries work from the graph on disk, but the daemon is not running, so commits and saves will not refresh the graph. | Start daemon |
| Stale | The graph describes an earlier commit than your checkout. | Reindex |
| Degraded | The graph is fresh, but one or more errors or warnings affect what it can answer. | See the diagnostics |
| Healthy | Graph 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
| Card | Description |
|---|---|
| Nodes | Symbol nodes in the graph on disk |
| Edges | Call, import and type-reference edges |
| Schema | Graph database schema version. Migrations run forward automatically when the daemon opens a graph built by an older version |
| DB size | Size of .travsr/graph.db |
| Last indexed | Time since the most recent index run. Turns amber and reads "stale" when the graph is behind your checkout |
| Semantic | How 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.
| Column | Description |
|---|---|
| Language | Language 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) |
| Analysis | The CLI's own status for the language. A language that is the subject of a warning on the same page says so here |
| Global installed | Whether the analyzer is installed on this machine |
| This repo | The CLI's per-repository state: always on, enabled, not enabled, or no analyzer |
| Action | The one step that moves the row forward |
Actions:
| Button | What it does |
|---|---|
| Install analyzer | Nothing is on the machine yet. Downloads the analyzer and turns full analysis on for this repository |
| Enable for this repo | Installed on this machine but off here. Turns it on for this repository; nothing is downloaded |
| Allow & enable | On 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 again | Shown 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 semantic | Shown when the page carries a warning for an otherwise active language. Redoes Phase B with a forced re-index |
| Disable | Turns 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