ByteRover Docs

Appearance

Command Line Tools ​

Connect ByteRover to Claude Code, Gemini CLI, and other CLI-based coding agents

This guide covers connecting ByteRover to command-line coding tools. Most CLI tools use Skill as the default connector for comprehensive project-level guidance. All also support MCP and rules.

Quick setup ​

TUI

Run /connectors in the interactive TUI, select your tool, and choose a connector type:

/connectors

CLI

Install the default connector for your tool:

bash
brv connectors install "Claude Code"
brv connectors install "Gemini CLI"
brv connectors install "Auggie CLI"
brv connectors install "OpenClaude"

Install a specific connector type with --type (or -t):

bash
brv connectors install "Claude Code" --type mcp
brv connectors install "Claude Code" --type hook

Claude Code ​

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

Skill (Default)

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Claude Code
  3. Choose Skill connector (recommended)
  4. 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
  5. Restart Claude Code to discover the skill files

CLI

Install via the CLI:

bash
brv connectors install "Claude Code"

TIP

Install additional community agent skills from BRV Hub:

bash
brv hub install byterover-review --agent "Claude Code"

Hook

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Claude Code
  3. Choose Hook connector
  4. Restart Claude Code to apply the new hooks

CLI

Install via the CLI:

bash
brv connectors install "Claude Code" --type hook

NOTE

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

MCP

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Claude Code
  3. Choose MCP connector
  4. ByteRover will configure .mcp.json in your project root
  5. Restart Claude Code to load the MCP server

CLI

Install via the CLI:

bash
brv connectors install "Claude Code" --type mcp

NOTE

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

Rules

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Claude Code
  3. Choose Rules connector
  4. Done — Claude Code will read CLAUDE.md automatically

CLI

Install via the CLI:

bash
brv connectors install "Claude Code" --type rules

Details

PropertyValue
Default connectorSkill
Supported connectorsSkill, Hook, MCP, Rules
Skill directory.claude/skills/byterover/
Rule fileCLAUDE.md
MCP config.mcp.json (auto-setup)
Hook config.claude/settings.local.json
Auto-detectedYes

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

OpenClaude ​

OpenClaude is a multi-provider Claude Code fork that reuses Claude Code's config paths (~/.claude/, .mcp.json, CLAUDE.md, .claude/skills/). It supports Skill (default), MCP, and Rules connectors.

Skill (Default)

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select OpenClaude
  3. Choose Skill connector (recommended)
  4. 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
  5. Restart OpenClaude to discover the skill files

CLI

Install via the CLI:

bash
brv connectors install "OpenClaude"

MCP

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select OpenClaude
  3. Choose MCP connector
  4. ByteRover will configure .mcp.json in your project root
  5. Restart OpenClaude to load the MCP server

CLI

Install via the CLI:

bash
brv connectors install "OpenClaude" --type mcp

NOTE

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

Rules

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select OpenClaude
  3. Choose Rules connector
  4. Done — OpenClaude will read CLAUDE.md automatically

CLI

Install via the CLI:

bash
brv connectors install "OpenClaude" --type rules

Details

PropertyValue
Default connectorSkill
Supported connectorsSkill, MCP, Rules
Skill directory.claude/skills/byterover/
Rule fileCLAUDE.md
MCP config.mcp.json (auto-setup)
Auto-detectedYes

NOTE

OpenClaude shares config paths with Claude Code, so an existing Claude Code connector setup is picked up automatically.

Auggie CLI ​

Auggie CLI uses Skill as the default connector for comprehensive project-level guidance.

Skill (Default)

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Auggie CLI
  3. Choose Skill connector (recommended)
  4. ByteRover creates .augment/skills/byterover/ with:
    • SKILL.md — Quick reference with commands and best practices
    • WORKFLOWS.md — Detailed workflow patterns
    • TROUBLESHOOTING.md — Diagnostics and support info
  5. Restart Auggie CLI to discover the skill files

CLI

Install via the CLI:

bash
brv connectors install "Auggie CLI"

MCP

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Auggie CLI
  3. Choose MCP connector
  4. Follow the manual setup instructions provided

CLI

Install via the CLI:

bash
brv connectors install "Auggie CLI" --type mcp

WARNING

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

Rules

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Auggie CLI
  3. Choose Rules connector
  4. Done — Auggie CLI will read .augment/rules/agent-context.md automatically

CLI

Install via the CLI:

bash
brv connectors install "Auggie CLI" --type rules

Details

PropertyValue
Default connectorSkill
Supported connectorsSkill, MCP, Rules
Skill directory.augment/skills/byterover/
Rule file.augment/rules/agent-context.md
MCP configManual setup
Auto-detectedYes

Gemini CLI ​

Gemini CLI uses Skill as the default connector for comprehensive project-level guidance.

Skill (Default)

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Gemini CLI
  3. Choose Skill connector (recommended)
  4. ByteRover creates .gemini/skills/byterover/ with:
    • SKILL.md — Quick reference with commands and best practices
    • WORKFLOWS.md — Detailed workflow patterns
    • TROUBLESHOOTING.md — Diagnostics and support info
  5. Restart Gemini CLI to discover the skill files

CLI

Install via the CLI:

bash
brv connectors install "Gemini CLI"

MCP

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Gemini CLI
  3. Choose MCP connector
  4. ByteRover will configure .gemini/settings.json automatically
  5. Restart Gemini CLI to load the MCP server

CLI

Install via the CLI:

bash
brv connectors install "Gemini CLI" --type mcp

Rules

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Gemini CLI
  3. Choose Rules connector
  4. Done — Gemini CLI will read GEMINI.md automatically

CLI

Install via the CLI:

bash
brv connectors install "Gemini CLI" --type rules

Details

PropertyValue
Default connectorSkill
Supported connectorsSkill, MCP, Rules
Skill directory.gemini/skills/byterover/
Rule fileGEMINI.md
MCP config.gemini/settings.json (auto-setup)
Auto-detectedYes

Codex ​

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

Skill (Default)

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Codex
  3. Choose Skill connector (recommended)
  4. ByteRover creates .agents/skills/byterover/ with:
    • SKILL.md — Quick reference with commands and best practices
    • WORKFLOWS.md — Detailed workflow patterns
    • TROUBLESHOOTING.md — Diagnostics and support info
  5. Restart Codex to discover the skill files

CLI

Install via the CLI:

bash
brv connectors install Codex

TIP

Install additional community agent skills from BRV Hub:

bash
brv hub install byterover-review --agent Codex

MCP

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Codex
  3. Choose MCP connector
  4. ByteRover will configure ~/.codex/config.toml automatically
  5. Restart Codex to load the MCP server

CLI

Install via the CLI:

bash
brv connectors install Codex --type mcp

Rules

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Codex
  3. Choose Rules connector
  4. Done — Codex will read AGENTS.md automatically

CLI

Install via the CLI:

bash
brv connectors install Codex --type rules

Details

PropertyValue
Default connectorSkill
Supported connectorsSkill, MCP, Rules
Skill directory.agents/skills/byterover/
Rule fileAGENTS.md
MCP config~/.codex/config.toml (auto-setup, global)
Auto-detectedYes

WARNING

Network access required for Codex

Codex runs in a sandboxed mode without internet access by default. To use ByteRover:

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

OpenCode ​

OpenCode uses Skill as the default connector for comprehensive project-level guidance.

Skill (Default)

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select OpenCode
  3. Choose Skill connector (recommended)
  4. ByteRover creates .opencode/skills/byterover/ with:
    • SKILL.md — Quick reference with commands and best practices
    • WORKFLOWS.md — Detailed workflow patterns
    • TROUBLESHOOTING.md — Diagnostics and support info
  5. Restart OpenCode to discover the skill files

CLI

Install via the CLI:

bash
brv connectors install OpenCode

MCP

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select OpenCode
  3. Choose MCP connector
  4. Follow the manual setup instructions provided

CLI

Install via the CLI:

bash
brv connectors install OpenCode --type mcp

WARNING

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

Rules

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select OpenCode
  3. Choose Rules connector
  4. Done — OpenCode will read AGENTS.md automatically

CLI

Install via the CLI:

bash
brv connectors install OpenCode --type rules

Details

PropertyValue
Default connectorSkill
Supported connectorsSkill, MCP, Rules
Skill directory.opencode/skills/byterover/
Rule fileAGENTS.md
MCP configManual setup
Auto-detectedYes

Qwen Code ​

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

MCP (Default)

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Qwen Code
  3. Choose MCP connector
  4. Follow the manual setup instructions provided

CLI

Install via the CLI:

bash
brv connectors install "Qwen Code"

WARNING

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

Rules

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Qwen Code
  3. Choose Rules connector
  4. Done — Qwen Code will read QWEN.md automatically

CLI

Install via the CLI:

bash
brv connectors install "Qwen Code" --type rules

Details

PropertyValue
Default connectorMCP
Supported connectorsMCP, Rules
Rule fileQWEN.md
MCP configManual setup
Auto-detectedYes

Warp ​

Warp uses Skill as the default connector for comprehensive project-level guidance.

Skill (Default)

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Warp
  3. Choose Skill connector (recommended)
  4. ByteRover creates .warp/skills/byterover/ with:
    • SKILL.md — Quick reference with commands and best practices
    • WORKFLOWS.md — Detailed workflow patterns
    • TROUBLESHOOTING.md — Diagnostics and support info
  5. Restart Warp to discover the skill files

CLI

Install via the CLI:

bash
brv connectors install Warp

MCP

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Warp
  3. Choose MCP connector
  4. Follow the manual setup instructions provided

CLI

Install via the CLI:

bash
brv connectors install Warp --type mcp

WARNING

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

Rules

TUI

  1. Run /connectors in the ByteRover REPL
  2. Select Warp
  3. Choose Rules connector
  4. Done — Warp will read WARP.md automatically

CLI

Install via the CLI:

bash
brv connectors install Warp --type rules

Details

PropertyValue
Default connectorSkill
Supported connectorsSkill, MCP, Rules
Skill directory.warp/skills/byterover/
Rule fileWARP.md
MCP configManual setup
Auto-detectedYes

Next Steps ​