PluginInstalls cleanly

Whole-repo PR code review

invertebrate

Reviews a PR or diff like Greptile: traces every changed symbol through the whole repo, proves findings with tests, and writes a plain-language report.

Works with
Claude Code, Codex CLI, Gemini CLI
Good for
Build an app, Security testing

What it does

Invertebrate is a code-review skill for your coding assistant. Instead of only reading the lines that changed, it builds a picture of every function, type and route the change touches across the whole repository. That is how it catches renames that leave callers broken, new endpoints that skip an auth check every sibling has, or a "cleanup" that undoes an earlier bug fix.

For each serious finding it tries to prove the bug: it may run a small failing test or a compiler check. Findings it cannot reproduce are dropped, and unproven serious findings drop one severity level. The report uses plain language, a safe-to-merge verdict, a 0–5 confidence score, a findings table and a diagram. Say invertebrate learn to get proposed team rules from past PR comments. Since 1.4.1 a missing auth, permission or ownership check that lets one user read or change another user's data is always rated P0 (must fix). 1.4.2 changes no skill text. Since 1.5.1 (9 November 2026) the html visual report and the dashboard are gone, and the reference search is a single git grep that the agent runs from the skill text. To update, run claude plugin marketplace update sedricedwards, then claude plugin update invertebrate.

It is one skill folder with one SKILL.md file and no scripts. There are no servers, no hooks and no analytics. It only talks to GitHub through the GitHub CLI under your own account: to read a PR you name, and to post a review when you ask.

Example prompts

  • "invertebrate review PR #12"
  • "invertebrate review my uncommitted changes"
  • "run invertebrate on my branch"
  • "invertebrate re-review PR #12"
  • "invertebrate learn"

How to install

claude plugin install invertebrate --marketplace sedricedwards/invertebrate

How to use it

Say a sentence that includes the word invertebrate, for example "invertebrate review PR #12" or "invertebrate review my uncommitted changes".

Check it works

Run claude plugin list: it should show invertebrate@sedricedwards, version 1.5.1 or later, enabled. Start a new session in a git project and ask: "invertebrate review my uncommitted changes". The assistant should load the invertebrate skill and either review the working tree or say there is nothing to review.

Common problems

Other assistants

The author lists these routes as untested (only Claude Code is tested; Antigravity CLI, which is not Gemini CLI, is marked "Install checked").

What to watch out for

  • Install adds the sedricedwards marketplace and enables the plugin in ~/.claude/settings.json, clones the repo to ~/.claude/plugins/marketplaces/sedricedwards and copies the current version (1.5.1 on 9 November 2026) to ~/.claude/plugins/cache/
  • Since 1.5.1 the plugin is one SKILL.md with no scripts (the Python helpers, the html report and the dashboard were removed). No scripts is not runs nothing: the skill tells the agent to run git grep, git log or git blame, gh and your build and tests. No hooks, no MCP server, nothing runs at session start
  • To prove findings it may run your project's build or typecheck and short invertebrate_repro_<n> test files it writes next to your tests, then deletes them; it does not install dependencies
  • For a PR target it fetches the PR into a local branch invertebrate-pr-<n> and a git worktree, and removes both after; it asks first when someone else opened the PR
  • Needs git for most targets and the GitHub CLI (gh) signed in for PR targets, posting and learn mode; it posts a COMMENT review under your account only when you ask
  • Edits your code only when you say fix all, fix P0 or fix #n; learn mode writes rules into .invertebrate/ only after you say save them; to post a review it writes the review JSON to a temp file first
  • The skill runs only when your message contains the word invertebrate (skill instructions; Claude Code does not enforce that word filter)

Licence and author

Licence
MIT
Author
Sedric Edwards
Source code
github.com/sedricedwards/invertebrate

How we tested it

We installed it on an empty test computer on 6 Nov 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

The intake sandbox cannot run plugin install lines, so this test was done by hand. We did not run a review, and the Codex and Gemini CLI routes were not tested. Not yet used on real work.

Technical details of the test
Date
6 Nov 2026
Method
Manual sandbox run on 2026-11-06 in a clean container (oexp-sandbox image, Claude Code 2.1.296) with no account and no API key: ran the README install line claude plugin install invertebrate --marketplace sedricedwards/invertebrate. It added the sedricedwards marketplace, installed invertebrate@sedricedwards 1.4.0 (commit c178d32), and claude plugin list showed it enabled; skills/invertebrate/SKILL.md with its name and description is in place.

Checked again on 9 Nov 2026

Alternatives

  • PR Review Toolkit (Anthropic) — Anthropic's reviewer agents for a code change
  • CodeRabbit Skills and Plugins — asks the CodeRabbit service to review your changes
  • OpenQodex — scanners plus a second reviewer on your unpushed changes
  • Trail of Bits Skills — security-focused review skills for your own, authorised code

FAQ

  • Q: Does it send my code to the plugin author? A: The project's PRIVACY.md says no; review text goes to your assistant's model provider as with any other task, and to GitHub only if you ask it to post.
  • Q: Will it run untrusted PR code on its own? A: The skill says to ask before it runs code from a pull request opened by someone else, and never to install dependencies or use the network for proof runs.
  • Q: Will it change my code? A: Only when you ask, with fix all, fix P0 or fix #2. It then reruns each proof test to confirm the fix.
  • Q: Do I need Greptile? A: No. It can read an existing .greptile/ config for compatibility, but it is a separate MIT project and is not affiliated with Greptile.

Sources

  • github.com/sedricedwards/invertebrate
  • github.com/sedricedwards/invertebrate/blob/c178d32f15ec081aaee6a8d8f8e606b7e34d94ac/.claude-plugin/plugin.json
  • github.com/sedricedwards/invertebrate/blob/c178d32f15ec081aaee6a8d8f8e606b7e34d94ac/.claude-plugin/marketplace.json
  • github.com/sedricedwards/invertebrate/blob/c178d32f15ec081aaee6a8d8f8e606b7e34d94ac/skills/invertebrate/SKILL.md
  • github.com/sedricedwards/invertebrate/blob/c178d32f15ec081aaee6a8d8f8e606b7e34d94ac/PRIVACY.md
  • github.com/sedricedwards/invertebrate/blob/c178d32f15ec081aaee6a8d8f8e606b7e34d94ac/INSTALL.md
  • code.claude.com/docs/en/plugins/cli-reference
  • github.com/sedricedwards/invertebrate/releases/tag/v1.4.1
  • github.com/sedricedwards/invertebrate/releases/tag/v1.4.2
  • github.com/sedricedwards/invertebrate/blob/3aa1ba4da00a703aa3ce9e4e7d933b058025fda2/skills/invertebrate/SKILL.md
  • github.com/sedricedwards/invertebrate/releases/tag/v1.5.1
  • github.com/sedricedwards/invertebrate/blob/e9caebb203b86cdcc71a70a88a612b6b90274103/skills/invertebrate/SKILL.md
  • github.com/sedricedwards/invertebrate/blob/e9caebb203b86cdcc71a70a88a612b6b90274103/INSTALL.md