Custom static code analysis powered by Opengrep, integrated with Claude Code.
This repo is a vibe coded side project and therefore full of AI Slop.
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!
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.
/plugin marketplace add Tim-Pohlmann/Dolphin
/plugin install Dolphin@Dolphin
/generate-rules
The plugin provides:
- The
generate-rulesskill for interactive rule generation - An MCP server that Claude uses to run checks during conversations
- The
dolphinCLI binary - A PostToolUse hook that validates
.dolphin/rules.yamlafter every Write/Edit and prints diagnostics directly in Claude Code (no additional install required)
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.