Tool

explore

Find anything. explore searches the index exhaustively — lexical and semantic together — and shows what exists, ranked by how well it answers you. One call reveals the landscape and the vocabulary: the real class names and terms-of-art for every question after it. Start here when you do not know what to read.

explore keywords="gitignore matching" question="where is gitignore pattern matching implemented?" uriGlob="file:///src/L1/engine/**" tokenBudget=700 [620/700 tok | 6.8 s | ready] 100% .../RepoQL.Engine.FileSystem/docs/north-star-gitignore.md What great looks like for gitignore pattern matching in RepoQL — full git fidelity and predictable performance, owned natively rather than borrowed from a regex-translating library. | 91 ln, ~1.5k tok 93% .../RepoQL.Engine.FileSystem/GitIgnoreMatcher.cs GitIgnoreMatcher | Add, IsIgnored, RootState, Advance | 875 ln, ~9.2k tok ── src/L1/engine/RepoQL.Engine.FileSystem.Tests/ (4 results) ── 90% .../GitIgnoreMatcherTests.cs IsIgnored_SingleRule, IsIgnored_CaseInsensitive, IsIgnored_DirectoryOnly, IsIgnored_LastMatchWins_Negation | 181 ln, ~2.2k tok

Four files named, ranked, and summarised for 620 tokens — and none of them opened. The north star document ranked above the implementation because the question asked where, not how.

Run it yourself

rql explore "gitignore matching" --glob "file:///src/**"

Or say it to your agent

“where is gitignore matching implemented in this codebase?”

Parameters

ParameterWhat it does
keywordsrequiredClass names, concepts, or short phrases — the probe. No filler words.
questionoptionalYour intent, as a full sentence. Results are reordered by how well they answer it, not just match it. Skip it only when surveying.
uriGloboptionalWhere to search. file:///** is the right default; unscoped spans every imported repository too.
breadthoptionalMaximum results. 2 for a deep dive, 10 for a survey, 0 to let the server choose.
tokenBudgetoptionalHow much room the answer gets — and therefore how deep it goes.

Budget decides depth

The budget is not a cap on a fixed answer — it chooses the representation. Around 800 tokens maps what exists in headlines; 3,000 adds structure and snippets; 10,000 expands the key symbols in full. A cheap exploratory call that comes back wrong costs almost nothing; the read it saves you costs a great deal.

When results come back weak

Suspect your vocabulary before the repository. Terms borrowed from another codebase rarely land, and keywords exists to map them to the real local names.

This page names what exists. The depth behind every name — the bounds, the failure modes, how they compose — ships inside the binary at help:///, and answers to explore and read exactly like your code does. Install it, and your agent has the manual.