CLICommands
ox code
Search this repo's git history and current code with natural-language queries. ox code reads CodeDB -- the local index built by ox index -- and surfaces planning signals like hotspots, stalled PRs, and index status.
Usage
terminal
$
Every subcommand reads the local CodeDB index. Build or refresh it first with ox index.
Subcommands
| Command | Description |
|---|---|
ox code search <query> | Search indexed code using queries |
ox code insights | Show planning-relevant code insights (hotspots, contention, recent activity) |
ox code prs | List pull requests with triage signals |
ox code status | Show code index status |
ox code activity | Assemble GitHub activity clusters for the fact extractor |
ox code index [url] | Index a git repository -- alias for ox index code |
Search code
terminal
$
Ranks matches across commits, symbols, and diffs by relevance.
| Flag | Description |
|---|---|
--limit | Max results to return |
--decisions | Only results from this repo's decision records (ADRs/DDRs) |
--full-json | Full uncompacted JSON output (~6x more context tokens) |
terminal
# Search only Decision Records
$
Planning insights
terminal
$
Reports change hotspots, file contention, and recent activity -- the signals worth reading before planning a change.
| Flag | Description |
|---|---|
--days | Time window in days |
--limit | Max rows per section |
--json | Structured JSON output for agents |
Triage pull requests
terminal
$
Ranks indexed PRs by triage signal -- most-stalled open PRs first by default. Ranking is deterministic and computed from indexed GitHub data (no LLM, no external API).
| Flag | Description |
|---|---|
--sort | Ranking: stalled | age | activity |
--state | PR state: open | closed | merged | all |
--limit | Max number of PRs to return |
--pretty | Pretty-print JSON output |
Index status
terminal
$
Shows what CodeDB has indexed and how current it is. Add --json for machine-readable output.
What's next
- ox index - Build the CodeDB index that
ox codesearches - ox query - Search recorded team knowledge beyond code
- ox decision - Enrich Decision Records with team context