PR analysis, on your terminal
13 commands. 5 output formats. Offline rule packs. CI auto-detection for 5 platforms. A built-in LSP server for editor diagnostics. And a --agent flag that turns any coding agent into a self-correcting reviewer.
curl -fsSL https://pullminder.com/install.sh | sh Also on Homebrew and npx · Full docs
Offline-capable
pullminder check runs rule packs locally against your branch diff. No account required for community packs.
CI auto-detection
pullminder ci resolves the base branch from CI env vars and picks a matching output format for 5 platforms.
Agent-native
A persistent --agent flag emits structured JSON tuned for AI coding agents (Cursor, Copilot, Claude Code).
Command Reference
All 13 commands
Grouped by what you'll use them for. Every command accepts --agent for agent-optimized JSON.
Setup
pullminder init Scaffold a .pullminder.yml project configuration.
pullminder auth login / logout / status / switch-org against the platform.
Analysis
pullminder check Run rule packs against the current branch diff — offline.
pullminder ci Diff-aware analysis optimized for CI pipelines with auto-detection.
pullminder diff <pr-url> Run rule packs against a remote GitHub PR.
pullminder score <pr-url> Fetch the Pullminder risk score for a PR.
pullminder brief <pr-url> Fetch the AI reviewer brief for a PR.
Integration
pullminder hooks Install / uninstall / status for pre-push and pre-commit git hooks.
pullminder packs Browse, enable, and disable rule packs.
pullminder registry Manage custom rule registries (init, pack add/list/remove, validate, upgrade).
pullminder rules Test rule packs against fixture diffs and publish to registries.
pullminder config View, set, export, import, diff, and tune telemetry.
Editor integration
pullminder lsp Start a stdio LSP server so VS Code, Neovim, Helix, Zed, and other LSP-capable editors surface findings as inline diagnostics — with rule descriptions on hover and a "disable rule for this line" quick fix.
Output Formats
One run. Five formats.
Pick the format that matches the consumer — CI reporter, GitHub Code Scanning, a coding agent, or a human.
Terminal
Human-readable, color-coded findings (default).
JSON
Machine-readable output via --json for pipelines.
SARIF v2.1.0
GitHub Code Scanning integration via --sarif.
JUnit XML
Test reporter compatibility via --junit.
GitHub annotations
Native ::warning and ::error workflow commands via --github-annotations.
CI/CD
Auto-detects your CI
Run pullminder ci in any of these pipelines and the CLI reads the CI environment to resolve the base branch and diff range. No --base gymnastics.
Combine with --fail-on <severity> to block merges at your chosen threshold, or --strict to exit non-zero on any finding.
Supported Platforms
- GitHub Actions
- GitLab CI
- CircleCI
- Jenkins
- Bitbucket Pipelines
Git hooks
Catch issues before they leave your laptop
pullminder hooks install wires a pre-push or pre-commit hook that runs pullminder check on your current diff. Fail fast, before a PR is ever opened.
Uninstall and status subcommands keep the hook lifecycle reversible and visible.
Agent-Native
Built for the AI coding loop
The persistent --agent flag returns a versioned JSON envelope — risk_score, risk_level, findings[], score_breakdown, a human-readable summary, and an action_required boolean your agent can branch on.
--agent is mutually exclusive with --sarif, --junit, and --github-annotations — it emits agent-tuned JSON instead.
Custom registries
Bring your own rule packs
pullminder registry scaffolds a custom rule registry, manages packs with a versioned schema, and validates before publish. Point .pullminder.yml at it and the CLI loads your org's rules alongside community ones.
pullminder rules test runs your rule packs against fixture diffs. TDD for detection rules.
Install the CLI and keep your context
Works alongside the GitHub App or standalone. Community rule packs run without an account.