BTR List

⚠️ 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.

Browse and visualize the context tree structure.

Quick Start

# List all domains
btr list

# List topics in a specific domain
btr list <domain>

# Show full details
btr list --verbose

Instructions

Run the appropriate list command based on user request
Present the tree structure in a readable format
Offer to drill down into specific domains
Suggest relevant queries based on what's available

Output Format

BTR Context Tree
=======================
auth (3 topics)
  ├── jwt-validation
  ├── oauth-google
  └── session-management

api (2 topics)
  ├── rate-limiting
  └── error-responses

database (1 topic)
  └── connection-pooling

Total: 6 contexts across 3 domains

Command Variations

List All Domains

btr list

Shows all domains with topic counts.

List Topics in a Domain

btr list auth

Shows all topics within the specified domain with their metadata.

Verbose Listing

btr list --verbose

Shows full details including:

Topic descriptions
Tags
Creation date
Last accessed date
Retrieval count

JSON Output

btr list --format json

Outputs structured JSON for programmatic use.

Example Workflows

Explore Before Querying

List all domains to see what's available:
```
btr list
```
Drill into a relevant domain:
```
btr list auth
```

Query for specific content:

btr query "JWT refresh token flow" --domain auth

Audit Context Coverage

Use verbose listing to identify gaps:

btr list --verbose --format json | jq '.domains | map({name: .name, count: .topics | length})'

Find Recently Added Contexts

btr list --sort created --limit 10

Tips

Use btr list regularly to stay aware of available context
When a domain has many topics, use --filter to narrow down
Combine with btr stats to see which contexts are most valuable