English • Català • Deutsch • Español • Français • हिन्दी • Italiano

日本語 • 한국어 • Polski • Português (BR) • Türkçe • Tiếng Việt • 简体中文 • 繁體中文

Roo Code With CLI

A fork of Roo Code with CLI control capabilities

Roo Code With CLI

This repository is a fork of Roo Code that adds a powerful CLI interface to control and configure the Roo Code VS Code extension programmatically. This enables automation, scripting, and remote management of Roo Code configurations.

What's New in This Fork

This fork implements the Roo Configuration Bridge, which allows you to:

• Manage provider configurations via command line
• Save, load, list, and delete configuration profiles
• Assign configurations to specific Roo modes
• Automate Roo Code setup in CI/CD pipelines or team environments
• Script configuration changes for different projects or tasks

Architecture

The bridge uses inter-process communication (IPC) sockets to establish a secure connection between the CLI tool and the VS Code extension:

sequenceDiagram
    participant CLI Tool (`roo-config`)
    participant Roo Extension (IPC Server)
    participant ProviderSettingsManager

    CLI Tool (`roo-config`)->>Roo Extension (IPC Server): Send command (e.g., "list", "save", etc.)
    Roo Extension (IPC Server)->>ProviderSettingsManager: Call appropriate method
    ProviderSettingsManager-->>Roo Extension (IPC Server): Return result
    Roo Extension (IPC Server)-->>CLI Tool (`roo-config`): Send response

Loading

Setup

VS Code Extension

1. Enable the bridge in VS Code settings:

   "roo.bridge.enabled": true

2. Restart VS Code or reload the window to apply the settings.

CLI Tool

1. Install the CLI tool:

   cd roo-cli
   npm install
   npm run build
   npm link

2. Verify the installation:

   roo-config --help

Usage

List Configurations

roo-config list

Example output:

Available configuration profiles:
- default (ID: default-id, Provider: openai)
- gpt4 (ID: gpt4-1234567890, Provider: openai)
- claude (ID: claude-1234567890, Provider: anthropic)

Save Configuration

roo-config save <profile-name> --provider <provider-name> --apiKey <api-key>

Example:

roo-config save my-openai --provider openai --apiKey "sk-..."

You can also save a configuration from a JSON file:

roo-config save my-config --from-file config.json

Load Configuration

roo-config load <profile-name>

Delete Configuration

roo-config delete <profile-name>

Assign Configuration to Mode

roo-config assign-mode <mode-slug> <profile-name>

Example:

roo-config assign-mode code my-openai

Get Configuration for Mode

roo-config get-mode <mode-slug>

Security

• The bridge is disabled by default (roo.bridge.enabled: false).
• IPC socket is only accessible from the local machine.
• Socket is created in a secure temporary directory.

Documentation

For more detailed documentation, see:

• Roo Configuration Bridge Documentation
• CLI Bridge Plan

Original Roo Code Features

This fork maintains all the original features of Roo Code:

• 🚀 Generate Code from natural language descriptions
• 🔧 Refactor & Debug existing code
• 📝 Write & Update documentation
• 🤔 Answer Questions about your codebase
• 🔄 Automate repetitive tasks
• 🏗️ Create new files and projects

Local Setup & Development

1. Clone the repo:

git clone https://github.com/yourusername/Roo-Code-CLI-Bridge.git

2. Install dependencies:

npm run install:all

3. Start the webview (Vite/React app with HMR):

npm run dev

4. Debug: Press F5 (or Run → Start Debugging) in VSCode to open a new session with Roo Code loaded.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Disclaimer

This is an unofficial fork of Roo Code. All original disclaimers from Roo Code apply:

Please note that Roo Code, Inc does not make any representations or warranties regarding any code, models, or other tools provided or made available in connection with Roo Code, any associated third-party tools, or any resulting outputs. You assume all risks associated with the use of any such tools or outputs; such tools are provided on an "AS IS" and "AS AVAILABLE" basis.

License

Apache 2.0 © 2025 Roo Code, Inc.

---

Note: This fork is maintained independently from the original Roo Code project. For the official version, please visit the original Roo Code repository.