aura query
Embedding-based search across the codebase.
Syntax
aura query [terms...]
Description
Performs embedding-based search across the codebase. The codebase is indexed (or incrementally updated) on each invocation, then searched for the most relevant chunks matching the query terms. Results show file paths, line ranges, and similarity scores.
When a reranker agent is configured, both unsorted and reranked results are displayed.
Running without arguments reindexes the codebase without searching.
Flags
| Flag | Short | Default | Description |
|---|---|---|---|
--top | -k | (from config) | Number of top results to return |
Plus all global flags.
Examples
# Search for token counting
aura query "token counting"
# Return more results
aura query -k 10 "configuration loading"
# Reindex only (no search)
aura query
Note: The search index is stored at
.aura/embeddings/. Indexing uses file-level gitignore filtering configured infeatures/embeddings.yaml. See Embeddings for details.