roo-commander

Think of it like having a virtual, specialized software development team right inside your editor, orchestrated by the Roo Commander, powered by Roo Code on

Roo Commander v9.0.0

Bridge your Claude Code skills to Roo Code with intelligent orchestration

Roo Commander is a three-component system that brings Claude Code's 60+ production-tested skills to Roo Code VS Code extension through a CLI tool, custom instructions, and an orchestrator mode.

What It Does

Roo Commander makes your Roo Code AI agent skill-aware:

Automatic Skill Discovery - Before implementing features, checks if relevant skills exist
CLI Integration - List, search, and load skills directly from Roo Code
Orchestrator Mode - Lightweight mode that delegates to Code/Architect/Debug with skill context
Session Management - Track progress through phases with /wrap-session and /continue-session
Project Planning - Generate IMPLEMENTATION_PHASES.md with /plan-project

Why? Skills contain production-tested patterns, known issue prevention, and token-efficient documentation. Using skills saves 60-87% tokens vs web search + trial-and-error.

Quick Start

1. Install CLI

npm install -g roocommander

2. Install Roo Commander Mode

Global Installation (Recommended)

roocommander init

This installs Roo Commander globally - available in ALL your projects:

Writes to ~/.config/Code/.../custom_modes.yaml
Copies rules to ~/.roo/rules-roo-commander/
Crown emoji indicates the mode

Project-Scoped Installation (Optional)

cd your-project
roocommander init --project

This installs only in the current project:

.roo/rules/ - Custom instructions (skills index, CLI usage, patterns)
.roo/rules-roo-commander/ - Mode-specific rules
.roo/commands/ - 9 slash commands
.roomodes - Roo Commander mode entry

⚠️ Important: After running roocommander init, reload VS Code (Command Palette → "Developer: Reload Window") to see Roo Commander in the mode selector.

3. Use Roo Commander

In Roo Code:

/mode roo-commander

"I want to build a chat interface with OpenAI and save conversations to D1"

// Roo Commander will:
// 1. Check skills index for "chat", "openai", "d1"
// 2. Find: ai-sdk-ui, openai-api, cloudflare-d1
// 3. Delegate to Code mode with skill loading instructions

What's Included

CLI Commands

roocommander list              # Show all 60+ skills
roocommander search ai         # Search by keyword
roocommander read "skill-name" # Load skill content
roocommander generate-index    # Create skills index
roocommander init              # Set up Roo Commander

Slash Commands (9 total)

Session Management:

/wrap-session - Save progress, create git checkpoint
/continue-session - Resume from SESSION.md
/list-skills - Browse available skills
/load-skill - Load specific skill

Planning:

/explore-idea - Research and validate project idea
/plan-project - Create IMPLEMENTATION_PHASES.md
/plan-feature - Add feature to existing project

Release:

/github-release - Create GitHub release
/release - Complete release checklist

Roo Commander Mode

Lightweight orchestrator that:

Analyzes user requests
Checks .roo/rules/01-skills-index.md for relevant skills
Delegates to Code/Architect/Debug modes with skill instructions
Tracks completion

When to use:

Starting new features (auto skill discovery)
Complex multi-step workflows
Unsure which skill to use

When to bypass:

Simple edits (use Code mode directly)
Already know which skill (load it manually)

Example Workflows

Workflow 1: New Cloudflare Workers Project

…

Workflow 2: Adding Authentication

/mode code  // Already in Code mode

// Load skill before implementing
/load-skill clerk-auth

"Add Clerk authentication with session storage in D1"

[Code mode uses skill patterns to implement correctly]

Workflow 3: Project Planning

/plan-project

// Guided workflow:
Project name: Task Manager
Tech stack: React, Cloudflare Workers, D1
Features: User auth, task CRUD, filtering

// Creates:
• docs/IMPLEMENTATION_PHASES.md (8 phases, 20-24 hours)
• SESSION.md (session tracking)

// Start Phase 1
[Load relevant skills and begin implementation]

️ Architecture

Three-Component System:

…

See docs/ARCHITECTURE.md for complete system design and data flow diagrams.

Documentation

CLI Reference - Complete command documentation
Architecture - System design and data flow
Marketplace Guide - Packaging and submission
Changelog - Version history

Skills Available

60+ Production-Tested Skills organized by category:

AI & LLM Integration (29 skills)

OpenAI, Claude, Gemini, Vercel AI SDK, ElevenLabs agents, chatbots

☁️ Cloudflare Platform (15 skills)

Workers, D1, R2, KV, Durable Objects, Workflows, AI, Vectorize, Queues

⚛️ Frontend Stack (11 skills)

React, Next.js, Tailwind v4, shadcn/ui, TanStack Query/Router/Table, Zustand

Authentication (3 skills)

Clerk, Better Auth, Auth.js

Forms & Validation (2 skills)

React Hook Form + Zod patterns

Data & Scraping (3 skills)

Drizzle ORM, Firecrawl, WordPress plugins

Content Management (3 skills)

TinaCMS, Sveltia CMS, Content Collections

Project Planning (1 skill)

IMPLEMENTATION_PHASES.md generation

See .roo/rules/01-skills-index.md for complete list with descriptions and keywords.

CLI Reference

list

Show all available skills.

roocommander list              # Compact list
roocommander list --verbose    # With descriptions
roocommander list --source ~/custom/skills  # Custom directory

Output: Table of skill names, descriptions, keywords

search

Find skills by keyword.

roocommander search database
roocommander search cloudflare
roocommander search auth --verbose

Scoring: Name match > keyword match > description match

read

Output skill content.

roocommander read "Cloudflare D1 Database"
roocommander read clerk-auth --raw  # Plain markdown

Fuzzy matching: "cloudflare d1" matches "Cloudflare D1 Database"

generate-index

Create categorized skills index.

roocommander generate-index
roocommander generate-index --output custom/path.md

Output: .roo/rules/01-skills-index.md with 7 categories

init

Initialize Roo Commander in project.

roocommander init              # Interactive setup
roocommander init --force      # Reinstall
roocommander init --source ~/custom/skills  # Custom directory

Creates: Complete .roo/ structure, skills index, .roomodes entry

See docs/CLI_REFERENCE.md for complete documentation.

Testing

Manual Testing Checklist

CLI Commands:

roocommander list shows skills
roocommander search cloudflare finds 15 skills
roocommander read "Cloudflare D1 Database" outputs content
roocommander generate-index creates index file
roocommander init sets up project

Slash Commands (in Roo Code):

/list-skills runs CLI and formats output
/load-skill "clerk-auth" loads skill content
/wrap-session creates git checkpoint
/continue-session resumes from SESSION.md
/plan-project generates IMPLEMENTATION_PHASES.md

Roo Commander Mode:

Mode appears in /mode list
Skill routing works (user mentions "database" → suggests D1/KV/R2)
Delegation includes skill loading commands
Completion tracking works

️ Development

Setup

git clone https://github.com/jezweb/roo-commander.git
cd roo-commander
npm install
npm run build
npm link  # Test globally

Project Structure

…

License

Contributing

Contributions welcome! Please:

Fork the repository
Create a feature branch
Make changes
Add tests if applicable
Submit PR with description

Support

Issues: https://github.com/jezweb/roo-commander/issues
Discussions: https://github.com/jezweb/roo-commander/discussions
Email: [email protected]

Acknowledgments

Anthropic - Claude Code and skills ecosystem
Roo Code Team - VS Code extension
Jezweb Skills - 60+ production-tested skills

Version: 9.2.0 (Workflow orchestration awareness - proactive lifecycle guidance) Last Updated: 2025-11-13