ragforgit

August 15, 2026 · View on GitHub

See CLAUDE.md for the full architecture, commands, and invariants.

Install or update rag-reviewer for Codex

uvx --from rag-reviewer@latest reviewer install codex
uvx --from rag-reviewer@latest reviewer install codex --dry-run
uvx --from rag-reviewer@latest reviewer install codex --no-skills
uvx --from rag-reviewer@latest reviewer install-skills codex

The first command manages one global reviewer MCP server and the namespaced rag-reviewer plugin. Re-running it upgrades the marketplace/plugin. Dry-run is read-only and offline; install-skills codex leaves MCP untouched.

Verify the result:

codex plugin list --json
codex mcp list

Success means rag-reviewer is installed and enabled and codex mcp list contains exactly one reviewer. Identified legacy skills are moved to $CODEX_HOME/reviewer-legacy-backups/<timestamp>; modified or ambiguous copies stay untouched. Failures print the config backup path. Open a New Chat/new CLI session after installation; in an IDE, also use Reload Window.

Companion global install for Claude Code

uvx --from rag-reviewer@latest reviewer install claude-code
uvx --from rag-reviewer@latest reviewer install claude-code --no-skills
claude plugin list --json
claude plugin marketplace list --json

The default command manages the enabled user-scope rag-reviewer plugin from https://github.com/mimfort/rag_for_git.git, so it works from every project and current directory. --no-skills installs only the global MCP server. Verify that plugin list contains the enabled rag-reviewer@rag-reviewer-marketplace entry with user scope; the optional marketplace listing should show the exact HTTPS source. Open a New Chat/new CLI session after installation; in an IDE, also use Reload Window.

Skills

Every directory under plugin/skills/ containing SKILL.md is registered in the rag-reviewer namespace. _common and nested references are delivered as support files, not registered skills.

The reviewer MCP server exposes 42 tools; skills provide the guarded user-facing workflows over those generic operations.

Available skills include:

  • rag-reviewer:review-pr
  • rag-reviewer:solve-task
  • rag-reviewer:sync-codebase
  • rag-reviewer:sync-tasks
  • rag-reviewer:performance-review
  • rag-reviewer:maintainability-review
  • rag-reviewer:ask
  • rag-reviewer:pr-walkthrough
  • rag-reviewer:configure-review
  • rag-reviewer:summarize-subsystems
  • rag-reviewer:create-task
  • rag-reviewer:decompose-task
  • rag-reviewer:finish-task