dolphin

Dolphin

Custom static code analysis powered by Opengrep, integrated with Claude Code.

AI Slop Disclaimer

This repo is a vibe coded side project and therefore full of AI Slop.

Why?

You have a mature codebase with a defined architecture and coding style and you don't want AI agents to ruin it? Dolphin will slap AI agents (and sloppy developers) in the face and force them to follow your rules!

What?

Dolphin helps you generate and enforce Opengrep rules. It comes in two major components:

• Dolphin CLI: Enforces your rules. Intended to be used in CI or for manual checks.
• Claude Code plugin:
  • Provides a skill to help with generating rules.
  • Wraps the CLI check in an MCP tool.

How?

Claude Code

/plugin marketplace add Tim-Pohlmann/Dolphin
/plugin install Dolphin@Dolphin
/generate-rules 

The plugin provides:

• The generate-rules skill for interactive rule generation
• An MCP server that Claude uses to run checks during conversations
• The dolphin CLI binary
• A PostToolUse hook that validates .dolphin/rules.yaml after every Write/Edit and prints diagnostics directly in Claude Code (no additional install required)

CLI

Download the binary from Releases and run it:

dolphin check

It will run all rules and print out a report. If any violation with severity ERROR is found, the tool emits exit code 1, which can be used to block your CI.