btr-query

Search LOCAL BTR context tree (NOT ByteRover/brv). Use when the user asks "how did we implement", "what's our pattern for", "find context about", "query BTR", "search BTR", "find in BTR", or needs project-specific knowledge.

BTR Query

⚠️ CRITICAL: BTR ≠ ByteRover

This skill uses btr (local context tree), NOT brv (ByteRover CLI).

| Command | Tool | Syntax | |---------|------|--------| | ✓ CORRECT | btr | btr query "search term" / btr list / btr stats | | ✗ WRONG | brv | Different tool, different syntax, requires auth |

PREFER MCP tools when available:

mcp__btr__query_context - For searching
mcp__btr__list_contexts - For browsing
mcp__btr__get_stats - For statistics

Only use Bash btr commands if MCP tools are unavailable.

Find and retrieve relevant context using intelligent search.

Quick Start

btr query "<natural language query>" [--domain <domain>] [--limit <n>]

Instructions

Understand the user's information need
Formulate a natural language query
Optionally filter by domain for more focused results
Run the CLI command
Present results with relevance context
Offer to retrieve full content if summary shown

Examples

Find authentication patterns

btr query "how do we handle JWT authentication"

Search within a specific domain

btr query "rate limiting implementation" --domain api

Get more results

btr query "error handling" --limit 10

For advanced query patterns, see advanced-queries.md.