Home

omit

Omit needless code. An editorial discipline for AI coding agents: draft less, cite everything, cut last. The rules are words; the hooks, the pre-commit gate and the PR Action are what make them hold.

This wiki is the how-to layer. It does not restate the README: a second copy of anything is a copy that drifts.

Start here

npx @sriinnu/omit init            # drop the rule file into this repo (AGENTS.md by default)
npx @sriinnu/omit hook install    # git pre-commit gate: works with any agent
npx @sriinnu/omit hook install claude   # or codex, ribhu: live sentinels inside the agent (0.6.0+)

Then add the GitHub Action so every PR gets a verdict, whatever wrote the code.

Where things live

You want	Go to
What omit is, how enforcement works, what it does not catch	README
Copy-paste setup for your agent (Claude Code, Cursor, Codex, Copilot, Cline, Windsurf, …)	GETTING-STARTED.md
The rules themselves, portable to any agent	AGENTS.md
Setting up the PR verdict and reading each row of it	GitHub Action
Letting an agent explore a repo without filling its context with every file it read	Codemode
A gate, a sentinel or the Action said something you did not expect	Troubleshooting
The receipt format and how omit verify re-checks it	README: Receipts
Measuring omit against a baseline or another skill	bench/

Get it

• GitHub Marketplace: omit audit
• npm: @sriinnu/omit
• Claude Code: /plugin marketplace add sriinnu/omit, then /plugin install omit@omit
• Any SKILL.md-aware agent: npx skills add sriinnu/omit