Command Line Tools

This guide covers connecting ByteRover to command-line coding tools. Claude Code defaults to the skill connector for comprehensive project-level guidance, while most other CLI tools use MCP as the default connector. All CLI tools also support the rules connector as a fallback.

Quick Setup

For all CLI tools, start with:

brv           # Start REPL mode
/connectors   # Launch connector manager

Select your tool, choose your connector type, and the configuration will be created automatically.

Claude Code

Claude Code supports skill (default), hook, MCP, and rules connectors. Skill provides comprehensive project-level guidance through discoverable markdown files.

Setup (Skill - Default)
Setup (Hook)
Setup (MCP)
Setup (Rules)
Details

Start the ByteRover REPL: brv
Run /connectors
Select Claude Code
Choose Skill connector (recommended)
ByteRover creates .claude/skills/byterover/ with:
- SKILL.md - Quick reference with commands and best practices
- WORKFLOWS.md - Detailed workflow patterns
- TROUBLESHOOTING.md - Diagnostics and support info
Restart Claude Code to discover the skill files

Start the ByteRover REPL: brv
Run /connectors
Select Claude Code
Choose Hook connector
Restart Claude Code to apply the new hooks

When using hooks, ByteRover automatically preserves your existing Claude Code hooks and prevents duplicates.

Start the ByteRover REPL: brv
Run /connectors
Select Claude Code
Choose MCP connector
ByteRover will configure .mcp.json in your project root
Restart Claude Code to load the MCP server

MCP provides direct brv-query and brv-curate tools to Claude Code without requiring hook injection.

Start the ByteRover REPL: brv
Run /connectors
Select Claude Code
Choose Rules connector
Done - Claude Code will read CLAUDE.md automatically

Property	Value
Default connector	Skill
Supported connectors	Skill, Hook, MCP, Rules
Skill directory	`.claude/skills/byterover/`
Rule file	`CLAUDE.md`
MCP config	`.mcp.json` (auto-setup)
Hook config	`.claude/settings.local.json`
Auto-detected	Yes

Connector comparison:

Skill: Comprehensive documentation files that Claude Code discovers automatically
Hook: Instructions injected on every prompt via brv hook-prompt-submit command
MCP: Direct tool integration with brv-query and brv-curate tools
Rules: Instructions loaded from CLAUDE.md file in project root

Qwen Code

Qwen Code uses MCP as the default connector, with rules as a fallback.

Setup (MCP - Default)
Setup (Rules)
Details

Start the ByteRover REPL: brv
Run /connectors
Select Qwen Code
Choose MCP connector
Follow the manual setup instructions provided

Qwen Code requires manual MCP configuration. ByteRover will display the configuration steps to follow.

Start the ByteRover REPL: brv
Run /connectors
Select Qwen Code
Choose Rules connector
Done - Qwen Code will read QWEN.md automatically

Property	Value
Default connector	MCP
Supported connectors	MCP, Rules
Rule file	`QWEN.md`
MCP config	Manual setup
Auto-detected	Yes

Gemini CLI

Gemini CLI uses MCP as the default connector, with rules as a fallback.

Setup (MCP - Default)
Setup (Rules)
Details

Start the ByteRover REPL: brv
Run /connectors
Select Gemini CLI
Choose MCP connector
ByteRover will configure .gemini/settings.json automatically
Restart Gemini CLI to load the MCP server

Start the ByteRover REPL: brv
Run /connectors
Select Gemini CLI
Choose Rules connector
Done - Gemini CLI will read GEMINI.md automatically

Property	Value
Default connector	MCP
Supported connectors	MCP, Rules
Rule file	`GEMINI.md`
MCP config	`.gemini/settings.json` (auto-setup)
Auto-detected	Yes

Codex

Codex uses MCP as the default connector, with skill and rules as alternatives.

Setup (MCP - Default)
Setup (Skill)
Setup (Rules)
Details

Start the ByteRover REPL: brv
Run /connectors
Select Codex
Choose MCP connector
ByteRover will configure ~/.codex/config.toml automatically
Restart Codex to load the MCP server

Start the ByteRover REPL: brv
Run /connectors
Select Codex
Choose Skill connector
ByteRover creates ~/.codex/skills/byterover/ (global) with:
- SKILL.md - Quick reference with commands and best practices
- WORKFLOWS.md - Detailed workflow patterns
- TROUBLESHOOTING.md - Diagnostics and support info
Restart Codex to discover the skill files

Codex uses a global scope for skills, making them available across all projects.

Start the ByteRover REPL: brv
Run /connectors
Select Codex
Choose Rules connector
Done - Codex will read AGENTS.md automatically

Property	Value
Default connector	MCP
Supported connectors	MCP, Skill, Rules
Skill directory	`~/.codex/skills/byterover/` (global)
Rule file	`AGENTS.md`
MCP config	`~/.codex/config.toml` (auto-setup)
Auto-detected	Yes

Network access required for CodexCodex runs in a sandboxed mode without internet access by default. To use ByteRover:

Switch to Agent (full access) mode, OR
Add to your prompt: “You can ask me about network access and I will allow it”
Approve network access when prompted

Warp

Warp uses MCP as the default connector, with rules as a fallback.

Setup (MCP - Default)
Setup (Rules)
Details

Start the ByteRover REPL: brv
Run /connectors
Select Warp
Choose MCP connector
Follow the manual setup instructions provided

Warp requires manual MCP configuration. ByteRover will display the configuration steps to follow.

Start the ByteRover REPL: brv
Run /connectors
Select Warp
Choose Rules connector
Done - Warp will read WARP.md automatically

Property	Value
Default connector	MCP
Supported connectors	MCP, Rules
Rule file	`WARP.md`
MCP config	Manual setup
Auto-detected	Yes

Getting Started

Context Tree

Coding Agent Connectors

Autonomous Agents

LLM Providers

BRV Hub

Daemon-First Architecture

Headless Mode

Reference

FAQs

Security

Command Line Tools

Quick Setup

Claude Code

Qwen Code

Gemini CLI

Codex

Warp

Next Steps

Curate Context

Query Context

Getting Started

Context Tree

Coding Agent Connectors

Autonomous Agents

LLM Providers

BRV Hub

Daemon-First Architecture

Headless Mode

Reference

FAQs

Security

​Quick Setup

​Claude Code

​Qwen Code

​Gemini CLI

​Codex

​Warp

​Next Steps

Curate Context

Query Context

Quick Setup

Claude Code

Qwen Code

Gemini CLI

Codex

Warp

Next Steps