git hooked Install
FREE · NO API KEY

Catch bad code
before you push.

Git hooks powered by the coding agent
you already use.

InstallView on GitHub
CodexClaude CodeGemini CLICopilot CLICursor Agent
Hooky, the over-caffeinated Git gremlin, holding a huge coffee mug
pre-commit
$ git add .env && git commit -m "add deploy config" Hooky checked 4 staged files. Are you mad?! You're trying to commit a .env file! Check builtin:env-files Commit blocked. Your .env stays local.
INSTALL

Install in seconds.

Free, open source, and no additional API key.

Installing with an AI agent?Copy and paste this into your coding agent.

Install Git Hooked in this repository. First verify Node.js 22+, Git, and a supported coding-agent CLI. Then run npm install --save-dev @githooked/cli followed by npx git-hooked init. Review the files and hooks it creates, then tell me what was installed and which agent was detected. Do not bypass any safety checks.

$ npm install --save-dev @githooked/cli
$ npx git-hooked init

Coding agent detected: Codex
Pre-commit hook installed
Pre-push hook installed

Hooky is watching your repoHooky wrestling a green cable into a Git hook
$0$0 forever
Uses your existing
agent CLI
Works locally in
your repository
View installation guideView source on GitHub
HOW IT WORKS

Checks run automatically.

Once installed, Git Hooked checks your changes whenever you commit or push.

01
Set it up once

Install the hooks and starter checks in your repository.

setup
$ npm install -D @githooked/cli$ npx git-hooked init✓ Pre-commit and pre-push installed
02
Work normally

Write code, stage it, and commit exactly as you do today.

your work
<user creates src/api.ts>$ git add src/api.ts$ git commit -m "add profile endpoint"
03
Catch issues before push

Hooky explains what failed and gives you clear ways forward.

pre-commit
Git Hooked is checking…✗ accessToken exposed in API responsesrc/api.ts:42→ Fix the response and commit again→ Review the rule or open the report
Your code goes through your existing agent — not through Git Hooked.
Hooky inspecting a rule with a magnifying glass
PLAIN-ENGLISH RULES

Create a rule in one command.

Describe the policy. Git Hooked plans the safest check and shows you everything before writing it.

Terminal
$ git-hooked rule add \
  "API responses must never expose accessToken"
Hooky builds the plan
  1. 01
    UnderstandReads the rule and relevant repository context.
  2. 02
    ChooseReuses an existing check, creates a script for the task, or defines a prompt for your CLI agent to run before commit or push.
  3. 03
    ClarifyAsks a focused question only when the answer changes the plan.
  4. 04
    Preview & approveShows every file and any generated code before creating it.
Nothing changes until you approve.
Hooky balancing on a chaotic pile of documentation
START HERE

Use it your way.

Follow the complete setup guide, then choose checks that fit the repository.

DOCUMENTATIONFrom install to protected push

Learn the default workflow, hook configuration, custom rules, guide packs, and maintenance commands.

Read the guide CHECK LIBRARYBrowse what is built in

Compare six shipped checks and five curated packs covering security, APIs, databases, and payments.

Explore the library