CLI reference

npm install -g byterover-cli

brv --version

brv

/status                 # Show auth, config, and context tree state
/curate [context] [@files]  # Curate context to the context tree
/query <query>          # Query information from context tree (alias: /q)
/push [-b branch] [-y]  # Push context tree to ByteRover memory storage
/pull [-b branch]       # Pull context tree from ByteRover memory storage
/space list [-a] [-j]   # List all spaces
/space switch           # Switch to a different space
/connectors             # Manage coding agent connectors (rules, hooks, mcp)
/reset [-y] [directory] # Reset context tree to an empty state
/new [-y]               # Start fresh session (clears conversation)
/init [-f]              # Initialize project (select team/space)
/login                  # Authenticate with ByteRover
/logout [-y]            # Log out

brv status                              # Show CLI and project status
brv query "How is auth implemented?"    # Query context tree
brv curate "JWT tokens expire in 24h"   # Curate context to context tree

# Start interactive REPL mode
brv

# Interactive mode (manually choose domain/topic)
/curate

# Autonomous mode with AI classification
/curate "Authentication uses JWT with 24h expiry"

# Include file references
/curate "Session handling logic" @src/auth/session.ts @src/middleware/auth.ts

/query "How is user authentication implemented?"
/q "What testing strategies are used?"

/push                    # Push to main branch
/push -b feature-auth    # Push to feature-auth branch
/push -y                 # Push without confirmation

/pull                    # Pull from main branch
/pull -b feature-auth    # Pull from feature-auth branch

/reset                       # Reset with confirmation
/reset -y                    # Reset without confirmation
/reset -y /path/to/project   # Reset specific project

/new                         # Start new session with confirmation
/new -y                      # Start new session without confirmation

# Show status for current directory
brv status

# Show status for a specific directory
brv status /path/to/project

# Output status as JSON
brv status --format json

# Query about implementation details
brv query "How is user authentication implemented?"
brv query "What are the API rate limits and where are they enforced?"

# Query about project structure
brv query "What testing strategies are used?"

# Interactive mode (manually choose domain/topic)
brv curate

# Autonomous mode with AI classification
brv curate "User authentication uses JWT tokens with 24h expiry"
brv curate "React components follow atomic design pattern"

# Include file references for context
brv curate "This module handles user sessions" -f src/auth/session.ts
brv curate "JWT authentication implementation" --files src/auth/jwt.ts --files docs/auth.md
brv curate "Auth logic" -f src/auth.ts -f src/middleware/auth.ts

.brv/
├── config.json                # Project configuration (team/space)
└── context-tree/              # Your knowledge base (starts empty)
    └── .snapshot.json         # Latest context tree snapshot

.brv/context-tree/
├── code_style/
│   └── error_handling/
│       └── custom_error_classes.md
├── design/
│   └── components/
│       └── button_variants.md
├── structure/
│   └── api_endpoints/
│       └── rest_api_structure.md
└── testing/
    └── integration_tests/
        └── api_testing_patterns.md