Skip to main content
← CLI Reference

travsr ask

Search the indexed graph for symbols matching a query string. Results are ranked and packed into a token budget for use in prompts or scripts.

travsr ask output

Synopsis​

travsr ask "<query>" [--format table|json]
travsr ask --examples
travsr ask --cmds

The query is a natural-language question or a bare symbol name. It runs against the repository you are standing in.

Flags​

FlagDefaultDescription
--format <fmt>tabletable or json
--examples(none)List the kinds of question Travsr can answer, with runnable examples. Usable on its own, without a query
--cmds(none)List every command Travsr supports, grouped by what it is for. Usable on its own, without a query

Questions about Travsr itself​

Not every question is a graph question. "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, or about the repository as a whole, are now recognised before retrieval and answered in place:

travsr ask "what is travsr?"
travsr ask "how is this different from vector search?"
travsr ask "what is this repo written in?" # runs lang list
travsr ask "is my index up to date?" # runs status
travsr ask "travsr: where does the data live?" # explicit route

The travsr: prefix resolves before the repository is even located, so it works with no index at all.

This is deliberately strict in one direction. A question the catalogue cannot fully account for goes to retrieval instead of being answered from it, because a confident wrong answer to a code search is worse than a missed meta question. what calls install_hook and how does the parser work still go to the graph.

How it works​

travsr ask runs a three-stage retrieval pipeline:

  1. FTS5 full-text search: matches the query against symbol names, signatures, and docstrings using SQLite FTS5 trigram tokenisation.
  2. PPR (Personalized PageRank): re-ranks candidates by their graph centrality relative to the query symbols.
  3. Knapsack packing: selects the highest-scoring results that fit the token budget.

This is the same pipeline that backs the get_context MCP tool.

Output format​

Results are printed as a borderless table, grouped into sections (exact matches, related results ranked by relevance, then tests and fixtures). Trimmed example:

$ travsr ask "install_hook"
── exact matches, literal symbol / text ──
Signature Path Score
import: use:hook::install_hook crates/travsr-daemon/src/lib.rs 0.999
fn:install_hook crates/travsr-daemon/src/hook.rs:185 0.999
── related, ranked by relevance ──
Signature Path Score
fn:install_one crates/travsr-daemon/src/hook.rs:203 0.996
fn:inject_embed_hook crates/travsr-mcp/src/lib.rs:209 0.251
filemod:hook crates/travsr-daemon/src/lib.rs:9 0.222
...

200 nodes · ~3235 tokens · confidence: strong

Warnings about index freshness or a missing daemon are printed on stderr, ahead of the table.

The footer shows the number of nodes returned, the approximate token count, and the confidence of the answer.

Examples​

# Symbol search
travsr ask "PaymentService"

# Broader concept search, synonym expansion applies
travsr ask "billing"

# Narrow to a specific file area
travsr ask "auth middleware"

# Machine-readable output for a script
travsr ask "UserRepository" --format json

# Find out what kinds of question are worth asking
travsr ask --examples

Synonym expansion​

If you have synonyms configured (e.g. payment → billing, invoice), travsr ask "billing" will also match nodes tagged with payment and invoice. See travsr synonym.

VS Code​

The Ask Symbol panel (Cmd+Shift+A) runs the same query interactively in the sidebar.