Skip to main content
ByteRover records a history of every curate and query operation so you can audit past activity, debug failures, and understand how your context tree has evolved over time.

​
Curate History

Use brv curate view to inspect past curate operations. Arguments
ArgumentTypeRequiredDescription
idstringNoLog entry ID to view in detail (e.g. cur-1739700001000)
Flags
FlagDescriptionDefault
--since <time>Show entries after this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)—
--before <time>Show entries before this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)—
--status <status>Filter by status (repeatable): cancelled, completed, error, processingAll
--detailShow operations for each entry in list viewfalse
--limit <n>Maximum number of entries to display10
--format <text|json>Output formattext
Examples 
# List recent curate operations
brv curate view

# View a specific entry in detail
brv curate view cur-1739700001000

# Filter by status and time
brv curate view --status completed --since 1h
brv curate view --status completed --status error --limit 5

# Show per-operation detail for each entry
brv curate view --detail

# JSON output for scripting
brv curate view --format json

​
Query History

Use brv query-log view to inspect past query operations and the knowledge files that were matched. Arguments
ArgumentTypeRequiredDescription
idstringNoLog entry ID to view in detail (e.g. qry-1712345678901)
Flags
FlagDescriptionDefault
--since <time>Show entries after this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)—
--before <time>Show entries before this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)—
--status <status>Filter by status (repeatable): cancelled, completed, error, processingAll
--tier <n>Filter by resolution tier (repeatable): 0–4All
--detailShow matched docs for each entry in list viewfalse
--limit <n>Maximum number of entries to display10
--format <text|json>Output formattext
Each query is resolved at one of five tiers, from fastest to most thorough:
TierLabelDescription
0exact cache hitResult served directly from an exact cache match
1fuzzy cache matchResult served from a semantically similar cached query
2direct searchKnowledge retrieved via direct vector search
3optimized LLMLLM-guided search with optimized retrieval
4full agenticFull agentic search across the context tree
Examples 
# List recent query operations
brv query-log view

# View a specific entry in detail
brv query-log view qry-1712345678901

# Filter by status and time
brv query-log view --status completed --since 1h

# Show only cache-hit queries (tiers 0 and 1)
brv query-log view --tier 0 --tier 1

# Show matched docs for each entry
brv query-log view --detail

# JSON output for scripting
brv query-log view --format json

​
Query Recall Metrics

Use brv query-log summary to view aggregated metrics across recent queries — cache hit rate, coverage, response times, and knowledge gaps. Flags
FlagDescriptionDefault
--last <time>Relative time window (e.g. 1h, 24h, 7d, 30d). Takes precedence over --since24h
--since <time>Entries after this time (ISO date or relative)—
--before <time>Entries before this time (ISO date or relative)—
--format <text|json|narrative>Output formattext
Examples 
# Summary for the last 24 hours (default)
brv query-log summary

# Summary for the last 7 days
brv query-log summary --last 7d

# Narrative format (human-readable prose)
brv query-log summary --format narrative

# Custom date range
brv query-log summary --since 2026-04-01 --before 2026-04-03