Skip to content

compass

โญ 18 ยท โœ… active ยท plugin

Type plugin Category Developer tools
Stars โญ 18 Status โœ… active
Author dshakes Updated 2026-08-17

One-liner

๐Ÿงญ Let your coding agent off the leash โ€” not off the rails. Guardrails, a hard budget cap & a self-fixing PR loop for Claude Code / Codex / Gemini. Eval-gated 100/100, you always merge.

About

Guardrails, a hard budget cap, and a self-fixing PR loop for your AI coding agent. eval-gated guardrails 100/100 ยท a budget cap that actually halts ยท you always merge

๐Ÿ“ฆ Install

# no curl|sh, fully reversible โ€” then just open any repo in your agent
git clone https://github.com/dshakes/compass ~/compass && cd ~/compass && ./quickstart.sh
# or, inside Claude Code:   /plugin marketplace add dshakes/compass

๐Ÿš€ Quick Start

compass bench     # โ†’ guardrail 100% precision/recall (61-case bench corpus; a separate 147-case bypass corpus gates CI), router 96.9%
# then ask the agent to `rm -rf /` or write a .env โ†’ denied; `rm -rf ./build` โ†’ allowed

๐Ÿ“š Learn more

โญ The part people screenshot: it fixes its own PRs.

Open a PR and compass **reviews it, security-checks it, runs the tests, cross-audits it with two more models โ€” three cross-model gates (Claude review ยท Codex audit ยท Gemini audit) โ€” then pushes its own

Install

Pick the door that fits โ€” all reversible, version-pinnable, no curl | sh. You need an AI assistant (Claude Code; Codex/Gemini optional) + git. No API keys for the manual, guardrails, crew, and CLI; the autonomous PR loop and fleet need model auth when you opt in. ๐Ÿบ Homebrew โ€” managed & versioned brew install dshakes/tap/compass # latest rel

One config, every agent

CLAUDE.md ยท AGENTS.md ยท GEMINI.md are one file (symlinks), and the plugin/extension manifests are generated from one source and CI-checked (scripts/check-vendor.sh) โ€” a git pull updates every agent at once and a manifest can't drift. The manifests are structure-validated in CI; the live gemini extensions install / codex plugin marketplace add paths are verified manually (those CL