What's New
Recent additions to Travsr. For the longer-term plan, see the Roadmap.
travsr ui, enum members in the graph, and tighter MCP answers (v1.4.0)
-
Upgrading from 1.3.0: run
travsr initonce in each repository. The index format changed (v3 to v4) because enum members are now graph nodes. An older index is not updated in place: the commit hook skips it until you rebuild, andtravsr statuswarns you:warning: this index was built with an older version of travsr (format v3, current v4); run `travsr init` to rebuild it -
travsr uiopens the graph in a browser. One command serves the VS Code extension's pages (Health, Graph, Callers, Dependencies, Blast radius, Execution path, Architecture, Context, Terminal and Repos) from the binary, on loopback by default. Browsing is read-only; the action buttons rundaemon,reindex,fsckandconnectonly after a confirmation. Seetravsr ui. -
travsr connectconfigures OpenCode and Kilo Code. It edits the project'sopencode.json(c)orkilo.json(c)in place, keeps your comments, and writes the absolute path of the running binary. Seetravsr connect. -
Enum members are graph nodes.
Color.Redis now avariant:Color.Rednode, sofind_referenceson a member finds its use sites. -
get_blast_radiustakesmax_files. The default is 500, and a cut list keeps the files nearest the change and ends with a note. A loose path or name says which files it resolved to, and a Rustmod x;names its child modules. The VS Code panel showsN+when the list was cut. -
find_patterntakescontext. It shows up to 10 lines after each match (travsr pattern -A), and marks matches inside test code with[test]. -
Identifier lookups match by prefix.
search_symbolandget_callersno longer returndispatch_tool_callfortool_callwhen a name that starts with it exists, so a real definition is not buried under loose matches. -
get_snippetstakes apathhint and names what it could not find. Each unresolved name gets its own note, and a repeated name renders once. -
get_architecture_briefcounts manifest-declared dependencies. Edges are taggedcode,manifestorcode+manifest. -
get_graph_jsonhonourstoken_budgetin overview and drill-down modes, and the budget is charged for the JSON it returns. -
MCP calls are checked against each tool's schema. A misspelled, missing or mistyped argument is rejected with a sentence naming it, instead of running the tool on an empty value. Responses are no longer cut off at 4 KB. A long-lived
mcp --stdioserver appends a note when thetravsrbinary on disk is a different build. See MCP tools. -
Daemon replacement is safer. A client replaces a skewed daemon only from the binary path it runs, and any client may replace one whose binary was deleted. See
travsr daemon. -
Security. Dependencies were bumped for RUSTSEC-2026-0367, -0368, -0369, -0385 and -0386, and
block-bufferto 0.12.1.
One-command setup, self-restarting daemon, and honest empty answers (v1.3.0)
- Upgrading from 1.2.1. The index format is unchanged. In a TypeScript or Python repository, run
travsr init --forceonce to pick up the Next.js, path-alias, JSX and Python attribute-type fixes below; any repository that uses inheritance picks up the new inherited-method call edges the same way. If Kotlin is already installed, reruntravsr lang install kotlin. travsr initsets up everything in one command. It detects the repository's languages, installs their language tools, indexes, traces calls before returning, connects Claude Code and Cursor, and starts the daemon to keep the index fresh.--semanticis now a hidden no-op, sinceinitalways traces calls. Every surface that reports a language's readiness (init,status,lang list, MCP notes, the VS Code extension) shares one check with five states,ready,needs_toolchain,unsupported_os,setting_upandfailed, and each non-ready line carries one concrete next step. Seetravsr initandtravsr status.travsr status --verboseadds the counts line, each language's diagnostics and tool versions, and the Phase B warnings.travsr connect --print --jsonlists the AI tools found and whether each connects by itself or needs one step from you.- The daemon restarts itself after a binary upgrade. The CLI compares the daemon's reported version with its own on every terminal query,
travsr mcpstart-up andinit, and restarts a mismatched daemon (an older one that reports no version counts as mismatched).travsr mcpalso starts a daemon when none is running. Seetravsr daemon. repostells "index deleted" from "never indexed".travsr repos,repos_listand the VS Code Repos panel reportindexed,index deletedornever indexed(orunknownfor an entry an older binary wrote) instead of a singleexistsflag.--jsonrows gain astatusfield. Seetravsr repos.- Empty MCP answers say which kind of empty they are.
get_callersandfind_referencestell an unresolved name apart from a known symbol with nothing calling it, andfind_patternanswers[note: no matches]for a search that ran and found nothing, distinct from input it rejected. Theget_contextabstain message now says no symbol name matched, rather than that the query is not in the repo. get_execution_pathno longer guesses between ambiguous endpoints. A bare name with several definitions returns the candidate list and says which side is ambiguous, instead of reporting "no path found" about the wrong pair.- No more phantom references. Each Phase B run now retracts a file's earlier reference lines and
scipcaller edges before recording new ones, so a stale line no longer survives later runs,fsckand even a freshinit. - Resolution fixes. A Next.js
tsconfig.jsonwithcompilerOptions.pluginsno longer breaks TypeScript analysis;@/*and otherpathsaliases now resolve; a JSX element (<Foo/>) counts as a reference to the component; Python resolves a call through a type-annotated instance attribute (self.app.add_url_rule(...)withapp: App); and a method inherited from a base class now produces a call edge. - Smaller fixes. A tool unpacked from a zip keeps its execute bit, which fixes Kotlin reporting "produced no symbols". The warm
askcache no longer returns a stale answer after the embedding sidecar restarts. The docs retrieval lane now respects the caller's RBAC scope. The VS Code extension no longer over-counts results when the index is behind, Show Execution Path draws only the route, and Objective-C.m/.mmfiles get code lens and hover. - Security.
embed gccan no longer be made to delete a file outside.travsr/; a symlink at.travsr/embed.lock.infocan no longer redirect a lock-status write; and the share tarball installer now verifies a sha256 sidecar before extracting anything.
The live lane reaches C, Objective-C, PHP, and Kotlin
- Live resolution between commits now covers four more languages. An edit in C, Objective-C, PHP, or Kotlin resolves through the live editor server (clangd, Intelephense, kotlin-language-server) the moment you save, instead of waiting for the next commit to re-run the batch analyzer. They join TypeScript, JavaScript, Python, Rust, Go, Dart, Swift, C++, Java, and C#, which already had it. Ruby and Scala are deliberately left out: ruby-lsp cannot resolve an untyped receiver, and Scala's language server needs an
sbt compilefirst, so edits in those two still wait for the next commit. - A round of cross-language edge-resolution fixes landed alongside it: several languages were dropping a whole file's edges on save when a real definition had no structural counterpart to unify onto (affecting Dart, Scala, Objective-C, Go, TypeScript, and Swift), and a few analyzers (C, C++, Go, Scala) emitted definitions with no counterpart at all, which are now handled the same way. A C or PHP project below the repository root is no longer skipped, and a save with no live lane attached no longer loses more edges than the edit itself removed.
travsr guard, travsr invariants, and two architecture-level MCP tools
travsr guard, a Claude CodePreToolUsehandler. It runs at the moment an agent reaches forGrep,Glob,Read, or a shell text search, and either attaches the Travsr call that answers the same question (advisory) or refuses the read and names the replacement (strict). Fail-open by construction: a missing index, an unreadable payload, or a missed deadline all let the original call through. Turn it on withtravsr init --guardortravsr connect --guard. Seetravsr guard.travsr invariants, an architecture-rule CI gate. It readsarchitecture-invariants.jsonfrom the repository root and checks dependency and cycle rules against the graph, exiting non-zero on a violation. A rule naming a component the graph no longer has is reported as violated rather than silently skipped. Seetravsr invariants.get_architecture_briefandget_subsystem_brief, two new MCP tools. The first returns a whole repository's components, weighted dependency edges, layering, and cycles; the second walks the call graph from one entry point and returns the call spine by depth, who calls in, and every call that crosses the component boundary. Both share the same definition of "component"get_repo_mapuses, so the three tools cannot disagree with each other. Seeget_architecture_briefandget_subsystem_brief.- The Android SDK is granted automatically to Java and Kotlin analyzers, but only for repositories that build with the Android Gradle Plugin, so a Gradle or Maven build that never touches Android pays nothing for it. The SDK location comes from
ANDROID_HOME,ANDROID_SDK_ROOT, or the IDE's default install location, never from repository content such aslocal.properties. A degraded analyzer run now says why intravsr initandtravsr status. See Installation.
Bundled TypeScript, JavaScript, and Python analyzers, and honest partial status (v1.1.1)
- TypeScript, JavaScript, and Python cross-file analysis works in an installed binary. Their analyzers had never shipped in a release: outside a source checkout those three languages got structural edges only, while
travsr lang listreported them active. The release now carries atravsr-lib/directory beside the binary with both analyzers bundled, and every installer extracts it. After upgrading, runtravsr init --semantic --forceonce in each TypeScript, JavaScript, or Python repository to pick up the new cross-file edges. See Installation. - A failed analyzer is reported instead of reading as complete. An analyzer that ran and failed now downgrades
travsr statusandtravsr inittosemantic: partial (incomplete: <lang>)and names the analyzer, instead of printingsemantic: complete. travsr lang installonly claims what it has checked. Its success line now comes from actually resolving the analyzer; when the bundled one is missing it says so and gives the reinstall remedy, andlang listandlang detectreportpartialfor it. Seetravsr lang.travsr lang status <language>works.statusis an alias oflist, which now takes an optional language filter and refuses an unknown language by name.- The Phase A pyright pass is gone. It never produced an edge and cost a subprocess per Python file. Python's cross-file analysis is unaffected.
Live resolution between commits, and log.level (v1.1.0)
-
Upgrading from 1.0.0: run
travsr initonce in each repository. The index format changed, and an older index is not updated in place: the watcher and commit hook skip it and queries keep answering from the old graph until you rebuild.travsr statuswarns you:warning: this index was built with an older version of travsr (format v2, current v3); run `travsr init` to rebuild it -
Live semantic resolution between commits (RFC-027). A save used to drop the file's committed semantic edges and rebuild only the lexically unambiguous subset. Definitions an edit leaves byte-identical now keep their committed edges, and only the changed region is re-resolved. See Architecture.
-
The daemon's log level is a setting.
log.level(error,warn,info,debug,trace; defaultinfo; envTRAVSR_LOG_LEVEL) is managed withtravsr config get/set/unset/list.RUST_LOGstill wins when set. Seetravsr config. -
JavaScript cross-file analysis without a tsconfig. A CommonJS or plain JavaScript repository with no
tsconfig.jsonused to produce zero semantic edges; Travsr now synthesizes one. -
Jest and Vitest tests are indexed as tests.
describe,it, andtestcallbacks become test and suite nodes, soget_contextandaskfile them under tests instead of letting them take the top slot. -
find_referencesandget_callersagree. Both read the same recorded occurrences,get_callersno longer truncates at 4 KiB, and two definitions sharing a name are disambiguated instead of collapsed. Seefind_referencesandget_callers. -
travsr --versionreports the bare version. The+<shortsha>build suffix is gone from both the CLI and MCPserverInfo.version.
travsr ask answers questions about Travsr, and elevated languages stop asking permission
travsr askhandles questions the graph cannot answer. "What is this repo written in?" used to match "repo" against symbol names and return a screen of hits that looked like an answer. Questions about Travsr itself, or about the repository as a whole, are now recognised before retrieval and answered in place; a repository-composition question runslang listand an index question runsstatus. It is strict in one direction on purpose: anything the catalogue cannot fully account for still goes to retrieval, because a confident wrong answer to a code search is worse than a missed meta question. Seetravsr ask.travsr ask --examplesand--cmds. The first lists the question shapes Travsr can answer, filled in with the most depended-upon real symbols from your own index, so every line runs as printed. The second prints the whole command surface, subcommands included, grouped by what each is for. Both are checked against the CLI definition at test time, so neither can advertise a command that does not exist.- Elevated languages no longer ask for approval. Java, Kotlin, Scala, and C# required a per-user approval, an approver handle, a justification, and a host allowlist, before they could be installed. That gate is gone for local use and
travsr lang approveis removed with it. The runtime isolation policy is byte-for-byte what it was; only the human approval moment went away. See Installation. travsr connectwrites MCP wiring only; the rules file is opt-in. The always-on rules block is re-read on every turn of every conversation, and it had grown to roughly 567 tokens per turn, competing with your own rules for attention. Most of it named which tool answers which kind of question, which the MCP client already sends:tools/listhands the model all 28 tool names and descriptions before the conversation starts. What remains ships behindtravsr connect --rules. Seetravsr connect.travsr lang listshows what you can act on. The PACKAGE column (npm names that no longer install anything) and the SANDBOX column (an internal tier) are replaced by a THIS REPO column that mirrors the per-repo gate exactly, so a language can no longer read "active" while full analysis is off for the repo in front of you. Installing a language inside a repo is itself the consent signal for that repo. Seetravsr lang.- Consent-gated unsandboxed analysis on Windows. Java (Gradle) and Scala (sbt) fork workers that cannot run inside the Windows isolation layer.
travsr lang allow-unsandboxed <language>records a one-time, per-language, machine-local permission to run them with your own privileges instead; without it they are skipped honestly rather than producing a silent zero-node run. The child starts from a cleared environment, soGITHUB_TOKEN,AWS_*,SSH_*, andNPM_TOKENnever reach the build tool. - Live per-language progress during cross-file analysis.
travsr initused to printFinalizingand then block with nothing on screen, so a JVM cold start looked like a hang. Each language now reports as it starts and finishes, with the timeout quoted only when something currently running is actually bounded. - Struct and class fields are addressable. Fields are now graph nodes in twelve languages, and a field read surfaces in
find_referencesas a realpath:linesite on its ownref/fieldedge kind, so field use sites are visible without polluting the call graph thatget_callersandget_blast_radiustraverse. travsr embed reindex --rebuild. Re-embeds the whole index from scratch, for use after switching models when older vectors may be inconsistent with newer ones.
Observability tools and a sidecar version contract
- Three read-only observability MCP tools. The MCP surface could answer questions about your code but not about the index those answers came from, so an agent could not tell "there are no callers" from "the graph cannot see them yet".
get_index_statusreports freshness, counts, per-language Phase B state and semantic readiness;get_daemon_logsreturns recent daemon entries, severity-filtered and redacted;get_graph_healthreports ghost paths, orphan edges and lexical parity without ever mutating anything. - Sidecar version floors. Travsr spawns external binaries that version independently, and install correctness used to be judged by file presence alone, which never flips false when a better release ships. A cached sidecar three releases behind ran anyway and failed with a cryptic downstream error. There is now a hard, offline compatibility floor: a below-floor sidecar is refused at spawn with the reinstall command named, and
travsr status,travsr embed statusandtravsr lang listall end with asidecars:block showing what is installed. See Sidecar health. - Exact search mode for
search_symbol. Narrow a noisy name to its exact matches instead of wading through fuzzy ones.
16-language coverage and get_snippets
get_snippetsMCP tool. Kind-aware code retrieval that returns the source of matched symbols directly, so an agent can read implementations without a second round trip. This brings the core MCP query surface to 12 tools (21 in single-repo stdio, counting thesynonym_*andrepos_*management tools).- Swift, Objective-C, and Dart. Phase B semantic indexers shipped for Swift (
travsr-swift-index-emitter), Objective-C (travsr-lang-objectivec, macOS only), and Dart (travsr-dart-index-emitter), bringing structural coverage to 16 languages. - Phase B plugin host. Every non-built-in language now runs through a sandboxed plugin host with a two-transport architecture (in-process native or external sidecar) and a per-language trust model. Install any of them with
travsr lang install <lang>.
Dynamic synonyms and new sidebar panels
travsr synonymCLI. Add, remove, and list query-time synonym pairs from the terminal. Synonyms expand search terms at query time, searchingbillingalso hits nodes taggedpaymentandinvoice. Seetravsr synonym.- Synonyms panel. Manage synonym pairs visually in VS Code without touching the CLI. See Synonyms Panel.
- Languages panel. Shows which languages are indexed in the current repo and lets you install language tools with one click. See Languages Panel.
- Repos panel. Lists all repos in the Travsr registry with live active/stale badges and a one-click prune button. See Repos Panel.
- Graph Stats panel. Shows node count, edge count, schema version, DB size, and last-indexed time at a glance. See Graph Stats.
Visual graph panel and get_graph_json
- Visual graph panel. Open the Cytoscape.js graph panel from the command palette with
Travsr: Show Graph(Cmd+Shift+G). It renders the live code graph for a symbol and lets you click through dependencies and callers. See VS Code features. get_graph_jsonMCP tool. Returns a subgraph as raw node and edge JSON rather than token-budget-trimmed prose. It backs the graph panel and is useful for custom integrations and CI tooling. See the tool reference.