everything-ros2-claude-code

everything-ros2-claude-code

The comprehensive sub-agentic harness for ROS 2 development with AI coding assistants.

Dedicated specialist agents for every ROS 2 domain — URDF validation, topic naming, distro compatibility, TF2, Nav2, MoveIt2, QoS, lifecycle nodes, ros2_control, safety systems, real-time performance, and more. Built so AI assistants stop hallucinating ROS APIs and start shipping real robots.

---

Why This Exists

AI coding assistants fail at ROS 2 for a predictable set of reasons:

• They mix ROS 1 and ROS 2 APIs (e.g., rospy instead of rclpy)
• They invent topic names that violate ROS naming conventions
• They generate URDF with invalid joint/link references
• They ignore QoS compatibility between publishers and subscribers
• They write code for Humble that only works on Jazzy
• They skip lifecycle node management entirely
• They hard-code frame IDs instead of using TF2 properly
• They miss package.xml dependencies for the packages they actually import

This repo gives AI coding assistants (Claude Code, Cursor, Copilot, Windsurf, Cline, Gemini, Codex) a fleet of 27 specialist sub-agents, each deeply trained in one ROS 2 domain. The orchestrator routes tasks to the right agent, collects results, and guards against the most common failure modes.

---

Quick Start Guide

Prerequisites

• ROS 2 (Humble, Iron, Jazzy, Kilted, or Rolling)
• Python 3.8+
• Your AI coding assistant (Claude Code, Cursor, Copilot, or any tool supporting .md agent files)
• Git

Installation

Method 1: Claude Code Plugin (Recommended for Claude Code)

In Claude Code, run these as two separate commands:

/plugin marketplace add RiddheshMore/everything-ros2-claude-code

/plugin install everything-ros2-claude-code

Method 2: Install Script (Recommended for all other agents)

# Clone this repository
git clone https://github.com/RiddheshMore/everything-ros2-claude-code.git
cd everything-ros2-claude-code

# Install for your AI coding agent
./install.sh --target claude      # Claude Code
./install.sh --target cursor      # Cursor IDE
./install.sh --target copilot     # GitHub Copilot
./install.sh --target windsurf    # Windsurf / Cascade
./install.sh --target cline       # Cline
./install.sh --target gemini      # Gemini Code Assist
./install.sh --target codex       # OpenAI Codex
./install.sh --target all         # Install for ALL agents

# Preview what will be installed without writing files
./install.sh --target cursor --dry-run

Method 3: Manual Installation

# Clone the repository
git clone https://github.com/RiddheshMore/everything-ros2-claude-code.git
cd everything-ros2-claude-code

# For Claude Code users
cp -r agents ~/.claude/agents/
cp -r skills ~/.claude/skills/
cp -r commands ~/.claude/commands/
cp -r rules/common ~/.claude/rules/common
cp -r rules/cpp ~/.claude/rules/cpp
cp -r rules/python ~/.claude/rules/python

# For Cursor users — copy .mdc rules to your project
cp -r .cursor/rules/*.mdc /path/to/your/project/.cursor/rules/
cp AGENTS.md /path/to/your/project/

# For GitHub Copilot users
cp .github/copilot-instructions.md /path/to/your/project/.github/
cp AGENTS.md /path/to/your/project/

# For Windsurf users
cp -r .windsurf/rules/ /path/to/your/project/.windsurf/rules/
cp AGENTS.md /path/to/your/project/

# For Cline users
cp -r .clinerules/ /path/to/your/project/.clinerules/
cp AGENTS.md /path/to/your/project/

# For Gemini Code Assist users
cp GEMINI.md /path/to/your/project/
cp AGENTS.md /path/to/your/project/

# For OpenAI Codex users
cp AGENTS.md /path/to/your/project/

---

Usage

Supported AI Coding Assistants