Repolode
Submit
mattzcarey

mattzcarey/shippie

Extendable AI code-review agent that reads your diff, explores the codebase, and posts focused review comments on pull requests.

View on GitHubWebsite
Stars
2,519
Forks
241
Open issues
30
Last commit
16 days ago

What is it?

Shippie is an AI code-review agent that reads a diff, explores the surrounding codebase with developer tools, and posts review comments aimed at issues a human reviewer would catch, such as exposed secrets, slow or inefficient code, and potential bugs or unhandled edge cases.

It runs as a GitHub Action, locally against staged changes via `npx shippie review`, or on demand when a `/shippie review` comment is posted on a pull request. It runs on Node, Cloudflare, GitHub Actions and GitLab CI, and works with Anthropic, OpenAI, OpenRouter and Cloudflare Workers AI models.

Shippie can act as a Model Context Protocol (MCP) client to reach external tools such as browser automation, observability and documentation services. It also reads project context from AGENTS.md or CLAUDE.md files and supports Agent Skills.

Key features

  • 01Reviews diffs for exposed secrets, performance problems and potential bugs.
  • 02Runs as a GitHub Action, locally on staged changes, or on demand via `/shippie review`.
  • 03Supports Anthropic, OpenAI, OpenRouter and Cloudflare Workers AI models.
  • 04Acts as an MCP client to connect external tools.
  • 05Injects project context from AGENTS.md, CLAUDE.md and Agent Skills.
  • 06Lets the agent delegate work to subagents through a task tool.

Use cases

  • Adding automated first-pass review comments to every pull request in a GitHub repository.
  • Checking staged changes for secrets or obvious bugs before committing locally.
  • Triggering a review on demand by commenting on a pull request.
  • Connecting a review agent to browser or observability tools through MCP.

Quick start

  1. 1

    Get an API key from a supported provider such as Anthropic, OpenAI, OpenRouter, or Cloudflare Workers AI

  2. 2

    Scaffold the GitHub Action workflow

    npx shippie init
  3. 3

    Add your provider API key as a repository secret, such as ANTHROPIC_API_KEY

  4. 4

    Or review your staged changes locally

    npx shippie review

Things to know

  • Requires an API key from a paid model provider.
  • The GitHub Action needs a full checkout (fetch-depth: 0) and PR write permissions.
  • Local mode only reviews staged changes (git diff --cached).

In collections

AI code review toolsOpen-source AI agent frameworks & appsAI coding assistants & agentsMCP servers

Topics

#code-review#ai-agent#llm#github-actions#mcp#qa-automation#typescript#pull-requests#agent#agents

FAQ

What is shippie?
Extendable AI code-review agent that reads your diff, explores the codebase, and posts focused review comments on pull requests. Shippie is an AI code-review agent that reads a diff, explores the surrounding codebase with developer tools, and posts review comments aimed at issues a human reviewer would catch, such as exposed secrets, slow or inefficient code, and potential bugs or unhandled edge cases.
Is shippie free to use? What license does it have?
shippie is open source under the MIT license. Check the license terms before using it in commercial products.
Is shippie still maintained?
Actively maintained. The last commit to shippie was on Oct 21, 2026.
What can I use shippie for?
Adding automated first-pass review comments to every pull request in a GitHub repository. Checking staged changes for secrets or obvious bugs before committing locally. Triggering a review on demand by commenting on a pull request. Connecting a review agent to browser or observability tools through MCP.
How do I install shippie?
Get an API key from a supported provider such as Anthropic, OpenAI, OpenRouter, or Cloudflare Workers AI Scaffold the GitHub Action workflow: npx shippie init Add your provider API key as a repository secret, such as ANTHROPIC_API_KEY Or review your staged changes locally: npx shippie review
Where can I get shippie?
The source code and installation instructions are on GitHub: https://github.com/mattzcarey/shippie

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects