c2roo 1.0.0__tar.gz

c2roo-1.0.0/.github/actions/setup/action.yml

@@ -0,0 +1,18 @@
+name: Setup c2roo
+description: Checkout, install UV, and sync dependencies
+
+runs:
+  using: composite
+  steps:
+    - name: Install UV
+      uses: astral-sh/setup-uv@v3
+      with:
+        enable-cache: true
+
+    - name: Set up Python
+      run: uv python install 3.12
+      shell: bash
+
+    - name: Sync dependencies
+      run: uv sync --all-extras --dev
+      shell: bash

c2roo-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - name: Ruff check
+        run: uv run ruff check .
+      - name: Ruff format check
+        run: uv run ruff format --check .
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - name: Mypy
+        run: uv run mypy src/c2roo
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - name: Pytest
+        run: uv run pytest tests/ -v
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup
+      - name: Build sdist and wheel
+        run: uv build
+      - name: Smoke test installed CLI
+        run: |
+          uv tool install --from "$(ls dist/*.whl)" c2roo
+          c2roo --help
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 7

c2roo-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,73 @@
+name: Release
+
+on:
+  workflow_run:
+    workflows: ["CI"]
+    types: [completed]
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  release:
+    # Only run if the triggering CI workflow succeeded
+    if: ${{ github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      released: ${{ steps.semrel.outputs.released }}
+      version: ${{ steps.semrel.outputs.version }}
+      tag: ${{ steps.semrel.outputs.tag }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: main
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: ./.github/actions/setup
+
+      - name: Run semantic-release
+        id: semrel
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -e
+          # Determine next version without committing
+          CURRENT=$(uv run semantic-release version --print 2>/dev/null || true)
+          PREV=$(grep -E '^version = ' pyproject.toml | head -1 | cut -d'"' -f2)
+          echo "Current version in repo: $PREV"
+          echo "Next version from semantic-release: $CURRENT"
+          if [ -z "$CURRENT" ] || [ "$CURRENT" = "$PREV" ]; then
+            echo "No release needed."
+            echo "released=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          # Perform the release
+          uv run semantic-release version
+          echo "released=true" >> "$GITHUB_OUTPUT"
+          echo "version=$CURRENT" >> "$GITHUB_OUTPUT"
+          echo "tag=v$CURRENT" >> "$GITHUB_OUTPUT"
+
+  publish:
+    needs: release
+    if: ${{ needs.release.outputs.released == 'true' }}
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/c2roo/${{ needs.release.outputs.version }}
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.release.outputs.tag }}
+
+      - uses: ./.github/actions/setup
+
+      - name: Build distribution
+        run: uv build
+
+      - name: Publish to PyPI via Trusted Publishing
+        run: uv publish --trusted-publishing always

c2roo-1.0.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.claude/

c2roo-1.0.0/CHANGELOG.md

@@ -0,0 +1,7 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v1.0.0 (2026-04-12)
+
+- Initial Release

c2roo-1.0.0/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: c2roo
+Version: 1.0.0
+Summary: Convert Claude Code plugins to Roo Code format
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0

c2roo-1.0.0/README.md

@@ -0,0 +1,194 @@
+<p align="center">
+  <img src="logo.svg" alt="c2roo logo" width="100"/>
+</p>
+
+<p align="center">
+  <strong>Convert Claude Code plugins to Roo Code format</strong>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/python-3.12+-3776AB?logo=python&logoColor=white" alt="Python 3.12+"/>
+  <img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"/>
+  <img src="https://img.shields.io/badge/tests-70%20passing-brightgreen" alt="Tests"/>
+  <img src="https://img.shields.io/badge/coverage-80%25-brightgreen" alt="Coverage 80%"/>
+</p>
+
+---
+
+## Overview
+
+**c2roo** is a CLI tool that converts [Claude Code](https://claude.ai/code) plugins into [Roo Code](https://roocode.com) format. It handles all plugin entity types — skills, commands, agents, hooks, and MCP servers — and can source plugins from marketplaces, git repos, or local directories.
+
+Both tools follow the [Agent Skills](https://agentskills.io/) open standard, so skill conversion is near-lossless. Other entities require varying degrees of transformation.
+
+## Entity Mapping
+
+| Claude Code | Roo Code | Fidelity | Notes |
+|---|---|---|---|
+| Skills | Skills | ~100% | Same Agent Skills format. Claude-specific fields stripped. |
+| Commands | Slash Commands | ~90% | `allowed-tools` dropped. Body + dynamic context preserved. |
+| Agents | Custom Modes + Rules | ~70% | Model pref lost. Tool granularity reduced. |
+| Hooks | Guidance Rules | ~30% | Soft guidance only — Roo has no hook enforcement. |
+| MCP Servers | MCP config | ~95% | Near-identical. `${CLAUDE_PLUGIN_ROOT}` resolved. |
+
+## Installation
+
+```bash
+# With uv (recommended)
+uv tool install c2roo
+
+# Or from source
+git clone https://github.com/bitton-yehonatan/c2roo.git
+cd c2roo
+uv sync
+```
+
+## Quick Start
+
+```bash
+# Convert a local Claude Code plugin to your project
+c2roo convert ./path/to/plugin --project
+
+# Install a plugin from the marketplace
+c2roo install superpowers --global
+
+# Browse available plugins
+c2roo marketplace browse
+
+# Dry run — see what would be converted without writing files
+c2roo convert ./path/to/plugin --project --dry-run
+```
+
+## CLI Reference
+
+### `c2roo convert`
+
+Convert a plugin from a local path or git URL.
+
+```
+Usage: c2roo convert [OPTIONS] SOURCE
+
+Options:
+  --global   Install to ~/.roo/ (global)
+  --project  Install to .roo/ (project)
+  --dry-run  Show what would be converted
+  --force    Overwrite existing files
+```
+
+You **must** specify `--global` or `--project`. Omitting both is an error.
+
+```bash
+# From a local directory
+c2roo convert ~/plugins/my-plugin --project --force
+
+# From a git URL
+c2roo convert https://github.com/org/plugin.git --global
+```
+
+### `c2roo install`
+
+Install a plugin from a registered marketplace.
+
+```
+Usage: c2roo install [OPTIONS] PLUGIN_NAME
+
+Options:
+  --global       Install to ~/.roo/ (global)
+  --project      Install to .roo/ (project)
+  --source TEXT  Which marketplace to search
+  --dry-run      Show what would be converted
+  --force        Overwrite existing files
+```
+
+```bash
+# Install from any marketplace
+c2roo install frontend-design --project
+
+# Install from a specific marketplace
+c2roo install react-native-best-practices --global --source callstack
+```
+
+### `c2roo marketplace`
+
+Manage plugin marketplace sources.
+
+```bash
+# List registered marketplaces
+c2roo marketplace list
+
+# Browse plugins from all marketplaces
+c2roo marketplace browse
+
+# Browse a specific marketplace
+c2roo marketplace browse --source official
+
+# Add a new marketplace (GitHub owner/repo format)
+c2roo marketplace add expo/expo-plugins --name expo --description "Expo plugins"
+
+# Remove a marketplace
+c2roo marketplace remove expo
+```
+
+**Default marketplaces** (pre-registered):
+- `official` — `anthropics/claude-plugins-official`
+- `community` — `anthropics/claude-plugins-community`
+
+## How Conversion Works
+
+### Skills (near 1:1)
+
+Both tools follow the [Agent Skills](https://agentskills.io/) spec. c2roo copies the entire skill directory (SKILL.md + scripts/references/assets) and strips Claude-specific frontmatter fields (`disable-model-invocation`, `user-invocable`, `context`, `agent`).
+
+### Commands -> Slash Commands
+
+Markdown files with YAML frontmatter transfer cleanly. The `allowed-tools` field is dropped (Roo doesn't support it). Dynamic context injection (`!`backtick``) works in both.
+
+### Agents -> Custom Modes + Rules
+
+Each Claude Code agent produces two Roo outputs:
+
+1. **Custom Mode** in `.roomodes` — with slug, humanized name, role definition (first paragraph), and tool groups mapped from the agent's tool list
+2. **Rules file** in `.roo/rules-{slug}/` — full agent system prompt, plus a footer noting the original model preference and tool list
+
+Tool mapping: `Read/Grep/Glob` -> `read`, `Write/Edit` -> `edit`, `Bash` -> `command`, `WebFetch/WebSearch` -> `mcp`.
+
+### Hooks -> Guidance Rules
+
+Roo has no hook system. c2roo converts hooks into a descriptive markdown file (`.roo/rules/converted-hooks-guidance.md`) that explains the original behavior and suggests manual equivalents.
+
+### MCP Servers
+
+Near-identical JSON format. `${CLAUDE_PLUGIN_ROOT}` references are resolved to the actual install path. Existing `.roo/mcp.json` is merged, not overwritten.
+
+## Output Locations
+
+| Flag | Skills | Commands | Modes | Rules | MCP |
+|---|---|---|---|---|---|
+| `--project` | `.roo/skills/` | `.roo/commands/` | `.roomodes` | `.roo/rules*/` | `.roo/mcp.json` |
+| `--global` | `~/.roo/skills/` | `~/.roo/commands/` | `~/.roomodes` | `~/.roo/rules*/` | `~/.roo/mcp.json` |
+
+## Development
+
+```bash
+git clone https://github.com/bitton-yehonatan/c2roo.git
+cd c2roo
+uv sync
+
+# Run tests (coverage runs automatically)
+uv run pytest tests/ -v
+
+# Run the CLI
+uv run c2roo --help
+```
+
+## Contributing
+
+1. Fork the repo
+2. Create a feature branch
+3. Write tests for new functionality
+4. Ensure all 70+ tests pass
+5. Submit a PR
+
+## License
+
+MIT