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/invertebrateHow 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
--marketplaceis an unknown option — the shell form needs Claude Code 2.1.292 or later (the README says 2.1.275, which is the minimum for the in-session form); runclaude update, or use/plugin install invertebrate --marketplace sedricedwards/invertebrateinside a session on 2.1.275 or later — https://code.claude.com/docs/en/plugins/cli-reference- Nothing happens on a normal "review this PR" request — the skill only starts when the word invertebrate is in your message — https://github.com/sedricedwards/invertebrate
- PR review fails without gh — install and sign in to the GitHub CLI, then retry — https://github.com/sedricedwards/invertebrate/blob/c178d32f15ec081aaee6a8d8f8e606b7e34d94ac/INSTALL.md
htmlorinvertebrate dashboarddoes nothing — both were removed in 1.5.1; the review report stays in the chat — https://github.com/sedricedwards/invertebrate/releases/tag/v1.5.1- Every finding marked Unproven — the agent needs permission to run shell commands to run its proof tests — https://github.com/sedricedwards/invertebrate/blob/c178d32f15ec081aaee6a8d8f8e606b7e34d94ac/INSTALL.md
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").
- Codex:
codex plugin marketplace add sedricedwards/invertebratethencodex plugin add invertebrate@sedricedwards; start a new thread — https://github.com/sedricedwards/invertebrate/blob/c178d32f15ec081aaee6a8d8f8e606b7e34d94ac/INSTALL.md - Gemini CLI:
gemini extensions install https://github.com/sedricedwards/invertebrate— https://github.com/sedricedwards/invertebrate/blob/c178d32f15ec081aaee6a8d8f8e606b7e34d94ac/INSTALL.md
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.
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 P0orfix #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