rbw-claude-code

A Claude Code plugin marketplace with parallel Codex marketplace metadata for the plugins that already map cleanly onto Codex's current plugin model.

This project started as a fork of EveryInc/compound-engineering-plugin.

Installation

Claude Code

Add this marketplace to Claude Code:

/plugin marketplace add RBozydar/rbw-claude-code

Then browse and install plugins:

/plugin menu

Codex

Codex currently reads local marketplaces rather than remote GitHub marketplace references. This repo now ships a repo-local Codex marketplace at .agents/plugins/marketplace.json.

To use it:

git clone https://github.com/RBozydar/rbw-claude-code.git
cd rbw-claude-code
codex
/plugins

The current Codex marketplace exposes:

• core
• python-backend
• deep-research-plus

The guard plugins remain Claude-only for now because current Codex plugin docs describe skills, apps, and MCP configuration, but not hook plugins.

Poetry Users

If you use Poetry instead of uv for package management, install from the poetry-variant branch:

/plugin marketplace add RBozydar/rbw-claude-code#poetry-variant

This variant includes enforce-poetry instead of enforce-uv, suggesting poetry run and poetry add commands.

Hook Setup (Required Workaround)

Due to a known Claude Code bug, plugin hooks are matched but not executed. Until this is fixed upstream, you need to manually configure hooks in your settings.

Navigate to the marketplace directory:

cd ~/.claude/plugins/RBozydar/rbw-claude-code

Run the setup script:

# Global hooks (apply to all projects) - default
./scripts/setup-hooks.sh

# Or project-specific hooks (run from within your project)
./scripts/setup-hooks.sh --project

To verify hooks are active:

/hooks

You should see the configured hooks listed (enforce-uv, conventional-commits, etc.).

Auto-Sync Detection

Once hooks are installed, a SessionStart hook automatically checks if your configured hooks are in sync with available plugin hooks. If hooks change (e.g., after updating the marketplace), you'll see a warning at session start:

====================================================
  rbw-claude-code: Hooks are out of sync!
====================================================

  Plugin hooks have changed. Run to update:

    ./scripts/setup-hooks.sh --project

====================================================

You can also manually check sync status:

./scripts/setup-hooks.sh --check           # Check global hooks
./scripts/setup-hooks.sh --check --project # Check project hooks

Available Plugins

AI-Powered Development

Plugin	Description
core	Universal AI development tools: 29 agents, 18 commands, 16 skills
python-backend	Python-specific tools: 5 reviewers, 2 commands
deep-research-plus	Deep research workflows with optional GDELT MCP support

Automation Hooks

Plugin	Description
enforce-uv	Block bare python/pip/pytest commands, enforce uv
conventional-commits	Validate conventional commit format
python-format	Auto-format Python files with ruff after edits
python-typecheck	Run type checking after Python file edits
test-reminder	Remind to add tests when creating new Python files

Security Hooks

Plugin	Description
protect-env	Block reading .env files to protect secrets
git-safety-guard	Block destructive git commands
safety-guard	Block destructive file ops and supply chain attacks

Codex Support

Codex-compatible plugins in this repo currently are:

• core
• python-backend
• deep-research-plus

Each now ships a .codex-plugin/plugin.json, and the repo marketplace lives at .agents/plugins/marketplace.json.

Hook-only plugins remain Claude-specific for now. Details: docs/codex-compatibility.md

For Codex-only local generation without hand-maintaining duplicate markdown, the repo now generates Codex custom agents directly from the Claude agent markdown and keeps them under .codex/agents/.

Regenerate them from source:

uv run python scripts/generate_codex_agents.py

Install them into your Codex home:

./scripts/install-codex-agents.sh

By default the installer creates symlinks into ~/.codex/agents/ so updates in this repo propagate without copy drift. Use --copy if you prefer materialized files.

Core Plugin

The core plugin provides language-agnostic AI-powered development tools:

Workflow Commands

• /workflows:plan - Transform features into structured plans
• /workflows:work - Execute work plans efficiently
• /workflows:review - Multi-agent code reviews with parallel analysis
• /workflows:compound - Document solved problems for knowledge compounding

Code Review Agents

• code-simplicity-reviewer - Reviews for unnecessary complexity
• security-sentinel - Security vulnerability analysis
• performance-oracle - Performance analysis
• architecture-strategist - System design review
• pattern-recognition-specialist - Pattern/anti-pattern detection
• agent-native-reviewer - Ensures features are agent-accessible
• data-migration-expert - Database migration validation

Research Agents

• framework-docs-researcher - Framework documentation lookup
• git-history-analyzer - Git history analysis
• repo-research-analyst - Repository analysis
• best-practices-researcher - Industry best practices

Skills

Skill Name	Description
core:agent-native-architecture	Build AI agents using prompt-native architecture
core:compound-docs	Capture solved problems as categorized documentation
core:create-agent-skills	Expert guidance for creating Claude Code skills
core:file-todos	File-based todo tracking in todos/ directory
core:git-ship	Complete git workflow: commit, push, PR, CI, merge
core:git-worktree	Manage Git worktrees for parallel development
core:instruction-hygiene	Audit and trim bloated CLAUDE.md/skill/context setups with recurring hygiene checks
core:skill-creator	Guide for creating effective skills

Python Backend Plugin

The python-backend plugin extends core with Python-specific capabilities:

Python Review Agents

• kieran-python-reviewer - High-quality Python code review
• skeptical-simplicity-reviewer - Anti-overengineering critique
• ml-expert-reviewer - ML/DS/LLM specialized review
• gemini-brainstorm - Second opinion from Gemini
• gemini-reviewer - Alternative code review from Gemini

Commands

• /pytest-runner - Smart pytest execution with failure analysis
• /type-check - Intelligent type checking with mypy/pyright

Hook Plugins

enforce-uv

Ensures Claude Code uses uv for all Python operations. Blocks bare python, pip, pytest commands.

conventional-commits

Validates commit messages follow Conventional Commits specification.

python-format

Runs uvx ruff format automatically after any Python file edit.

python-typecheck

Runs uvx pyright automatically after any Python file edit.

test-reminder

Reminds you to add tests when creating new Python modules.

protect-env

Blocks reading .env files to prevent exposing secrets to AI.

git-safety-guard

Blocks destructive git commands that could cause data loss:

• git reset --hard, git reset --merge
• git push --force, git push -f
• git checkout -- <files>, git restore <files>
• git clean -f, git branch -D
• git stash drop, git stash clear
• git reflog expire, git filter-branch

Allows safe alternatives: git checkout -b, git push --force-with-lease, git clean -n.

safety-guard

Blocks destructive file operations and supply chain attacks:

• rm -rf outside temp directories
• find -delete, shred, truncate
• curl | bash, wget | sh (supply chain attacks)
• bash -c with destructive commands (bypass detection)
• Reading .env files (allows .env.example, .env.sample, .env.template)

Requirements

• Claude Code with plugin support
• uv installed for Python-related plugins
• GitHub CLI (gh) for PR operations
• Gemini CLI for Gemini agents (optional)

License

MIT