CAT plugin
A plugin that injects repository rules into every Claude Code and Codex session so the agent keeps conventions across files.
- 122 ★ on the repository
- Last commit
Extended access
Why this level
- The installer is downloaded and run as a script and adds permission entries to the agent settings.
- The plugin shapes agent behavior in every project session.
Install
- Works in
Manual install
curl -fsSL https://github.com/holdmyspot-com/cat/releases/download/v1.0/cat.sh | sh -s -- --harness claudeDownloads the Claude Code plugin and installs it together with permission entries.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The installer is downloaded and run as a script and adds permission entries to the agent settings.
- The plugin shapes agent behavior in every project session.
This is third-party code. Review the repository files before installing.
What it does
CAT is a plugin for Claude Code and Codex. When a session starts or resumes, it adds the default rules and the ones a team keeps in its repository to the context. The agent sees the same conventions across files and sessions instead of applying them selectively. When a review exposes a gap, the lesson goes into the project rules and CAT carries it into later sessions. The rules also tell the agent to explain changes in plain language, without needless jargon, so reviewers read results more easily. The installer and a Java runtime ship inside the plugin. Each harness gets its own installation, and the `update` and `uninstall` skills upgrade and remove CAT.
Who it is for. Claude Code and Codex teams whose reviews keep catching the same convention violations and who want rules to live next to the code.
Good fit when
- The agent refactors and misses a convention in half of the files.
- A review exposed a gap and the lesson should become a rule for all later sessions.
- The project uses Claude Code and Codex together and needs one set of rules.
- Reviewers complain that explanations of agent changes are full of jargon.
Not a fit when
- You need a stable tool for a production project today: version 1.0 is still in internal development.
- The team is commercial and not ready for a paid plan.
- The environment is native Windows without WSL2.
Example request
Continue the orders module refactoring, follow the project rules, and explain the changes in plain words in the summary.Limitations
The author warns that version 1.0 is still in internal development and not ready for public use; features, rules and installation may change without notice. CAT is free for non-commercial use only, and commercial plans are described in `docs/PRICING.md`. Runners and prompt optimization are unavailable on native Windows, so WSL2 is required. The authors certify rules (at least 95% compliance at 95% confidence) on their own tests, and results on your project may differ.
How to disable. Ask the agent to run the `uninstall` skill: it asks about plugin data and removes this harness installation together with the permission entries. Project rules in the repository stay untouched.
FAQ
How do I install CAT for Claude Code and Codex?
Run the install command with `--harness claude` or `--harness codex`, or both if you use both harnesses. Restart the harness afterwards and start or resume a session.
How do I update or remove CAT?
Ask the agent. The `update` skill installs the latest release your policy approves or the one you name, and the `uninstall` skill removes the plugin and permission entries for that harness.
Is CAT free?
For non-commercial use, yes. Teams have commercial plans described in `docs/PRICING.md`.
Does CAT work on Windows?
Runners and prompt optimization are unavailable on native Windows. Use WSL2.
Where are team rules stored?
In the repository next to the code. The team changes them through ordinary review, and CAT injects the applicable project rules into later sessions.
Discussion
No questions or reviews yet.
Related
PluginsA Codex plugin that runs Claude Code for reviews, rescue tasks and tracked background jobs without leaving Codex
A plugin that readies a project for Claude Code: guidance, tests, review, TDD, refactoring and a resumable fix loop
The ce plugin for Claude Code and Codex: eleven skills and four sub-agents for plans, review, tests, architecture and writing.
Two Claude Code skills that look for an existing solution before coding and stop additions nobody asked for.
OpenAI's official plugin: Codex reviews of your changes and task delegation to Codex from inside a Claude Code session
A Codex plugin adds development discipline, 29 skills, 31 hooks and multi-model subagents in one package.
README in short
The project publishes releases with signed metadata, and the installer verifies the archive before installing. Each version has its own folder, and the active and previous ones are kept.