Repolode
Submit
coldteadotai

coldteadotai/abide

Enforces your project's AI-agent instruction rules by checking every edit and turn with a decision model and asking the agent to fix violations.

View on GitHub
Stars
624
Forks
47
Open issues
5
Last commit
28 days ago

What is it?

Abide is a tool for coding agents such as Claude Code, Codex, OpenCode and Pi. Project instruction files like AGENTS.md or CLAUDE.md contain rules that linters cannot check, such as "never let a raw error reach a user". Abide turns each rule into a question and asks Jev, TypeSafe's decision model, for a probability after every edit or at the end of a turn. Jev sees only the rule and the diff, not the conversation.

When a rule scores high enough, the agent is told which rule was broken and repairs the code in the same turn. Moderate scores show a note to the user without triggering a repair. Rules are stored in a readable, committed file, .abide/rubric.json, so wrong verdicts can be fixed by rewording the rule. Commands cover auditing existing files, checking uncommitted changes, and replaying past sessions.

Setup uses npx with a TypeSafe or Vercel AI Gateway key. Hooks are installed per agent, or into the project so teammates get them with the checkout.

Key features

  • 01Checks each edit or turn against each rule in your instruction files.
  • 02Reports the violated rule and asks the agent to repair the code in the same turn.
  • 03Stores rules in a committed, human-readable rubric file.
  • 04Supports Claude Code, Codex, OpenCode and Pi.
  • 05Audits existing files and checks uncommitted changes from the command line.
  • 06Lets you scope rules to file globs and exclude files with .abideignore.

Use cases

  • Enforcing conventions such as required validation libraries or error-handling patterns that linters cannot check.
  • Preventing agents from adding unnecessary abstractions or oversized files during long coding sessions.
  • Auditing an existing codebase against its written instructions.
  • Sharing one set of agent rules across a team through the project checkout.

Quick start

  1. 1

    Store your TypeSafe or Vercel AI Gateway key

    npx @coldtea/abide login
  2. 2

    Install the hooks into every agent on this machine

    npx @coldtea/abide init
  3. 3

    Start your agent (claude, codex, opencode or pi) as usual

Things to know

  • Checks require a TypeSafe API key or a Vercel AI Gateway key, and network access.
  • Codex needs a manual step in /hooks to accept the new hook entries.

In collections

Claude Code tools, skills & pluginsOpen-source AI agent frameworks & appsAI coding assistants & agents

Topics

#ai-agent#coding-agent#claude-code#llm#code-review#linting#developer-tools#claude-code-hooks#claude-code-plugin#claude-code-plugins

FAQ

What is abide?
Enforces your project's AI-agent instruction rules by checking every edit and turn with a decision model and asking the agent to fix violations. Abide is a tool for coding agents such as Claude Code, Codex, OpenCode and Pi. Project instruction files like AGENTS.md or CLAUDE.md contain rules that linters cannot check, such as "never let a raw error reach a user". Abide turns each rule into a question and asks Jev, TypeSafe's decision model, for a probability after every edit or at the end of a turn. Jev sees only the rule and the diff, not the conversation.
Is abide free to use? What license does it have?
abide is open source under the MIT license. Check the license terms before using it in commercial products.
Is abide still maintained?
Actively maintained. The last commit to abide was on Oct 10, 2026.
What can I use abide for?
Enforcing conventions such as required validation libraries or error-handling patterns that linters cannot check. Preventing agents from adding unnecessary abstractions or oversized files during long coding sessions. Auditing an existing codebase against its written instructions. Sharing one set of agent rules across a team through the project checkout.
How do I install abide?
Store your TypeSafe or Vercel AI Gateway key: npx @coldtea/abide login Install the hooks into every agent on this machine: npx @coldtea/abide init Start your agent (claude, codex, opencode or pi) as usual
Where can I get abide?
The source code and installation instructions are on GitHub: https://github.com/coldteadotai/abide

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects