git404hub

what is veto-gate fr?

revvax/veto-gate — explained in plain English

Analysis updated 2026-05-18

0ShellAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

veto-gate blocks a git commit inside Claude Code if an AI reviewer (OpenAI Codex CLI, with optional local or free-tier pre-checkers) finds a real problem in the staged diff.

vibe map

mindmap
  root((veto-gate))
    What it does
      Reviews staged git diffs
      Blocks bad commits
      Explains why it blocked
    Reviewers
      Codex CLI main reviewer
      Local pre-checker
      Groq or Gemini pre-checker
      Deterministic checks
    Tech stack
      Shell scripts
      OpenAI Codex CLI
      LM Studio or Ollama
    Setup
      macOS quickstart
      Per repo opt in
      Local dashboard
    Audience
      Claude Code users
      Developers wanting safety checks

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Block a commit automatically when an AI reviewer detects invented or broken code in the staged diff.

VIBE 2

Add a free local or remote pre-checker to catch obvious issues before spending main reviewer usage.

VIBE 3

Run a local dashboard to see recent commit reviews and whether flagged issues were resolved.

what's the stack?

ShellOpenAI Codex CLILM StudioOllamaGroqGemini

how it stacks up fr

revvax/veto-gate123satyajeet123/bitnet-serveradeilsonrbrito/cross-model-consult
Stars000
LanguageShellShellShell
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires your own OpenAI account for the Codex CLI reviewer, Windows support is WSL2 only and not fully verified.

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

veto-gate is a review gate that sits in front of git commit when you are working inside Claude Code. Before a commit is allowed through, the staged changes are sent to an AI reviewer, and if the reviewer spots a real problem, the commit is blocked with an explanation instead of quietly landing. The idea is to catch broken or invented code before it gets into your history, not after. The main reviewer is the OpenAI Codex CLI, which you connect using your own OpenAI account since veto-gate does not pay for any AI calls on your behalf. In front of that main reviewer you can optionally add a free pre-checker, either a local model running on your own machine through a tool like LM Studio or Ollama, or a remote free-tier option through Groq or Gemini. The pre-checker looks at the diff first and catches obvious mistakes early, saving the main reviewer's usage for trickier cases. A few checks run without any AI at all: a size limit on how large a single commit can be, a check for invented function calls, and checks around tests and evidence notes. Setup on macOS involves installing a few common command line tools, installing and logging into the Codex CLI, cloning the repository, and running an install script. After that, each repository you want reviewed needs a small config file turned on, since the gate only watches repositories that opt in. There is also a local web dashboard you can start that shows recent runs and any findings, along with per-repository settings. This is a shell-based developer tool aimed at people already using Claude Code and the Codex CLI who want an automatic safety check before commits land. It has been developed and tested on macOS, with Windows support available only through WSL2 and not yet fully verified. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Walk me through installing veto-gate on macOS and connecting it to my own Codex CLI account.
prompt 2
How do I enable veto-gate for one specific repository using the .claude/config/veto-gate.json file?
prompt 3
Set up a local LM Studio pre-checker for veto-gate and explain how the model ID matching works.
prompt 4
Explain the difference between veto-gate's local pre-checker and its remote Groq or Gemini pre-checker.

Frequently asked questions

what is veto-gate fr?

veto-gate blocks a git commit inside Claude Code if an AI reviewer (OpenAI Codex CLI, with optional local or free-tier pre-checkers) finds a real problem in the staged diff.

What language is veto-gate written in?

Mainly Shell. The stack also includes Shell, OpenAI Codex CLI, LM Studio.

What license does veto-gate use?

MIT license: use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is veto-gate to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is veto-gate for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.