What do you want to do?
5 use cases
-
Gate AI-generated PRs before they merge to main
Install a workflow that scans agent-written PRs for TODOs, secrets, bad commits and red CI.
View prompt
In the repository Akimiya-z/codex-guard style Git repo at <repo-path>, run `npx --yes codex-guard init` and then add and commit .github/workflows/codex-guard.yml. Expected output: the workflow file exists and is staged. Verify that the file contains `uses: Akimiya-z/codex-guard@v1`.
-
Preview gate findings on a local diff before pushing
Run the Codex Guard CLI on a patch file to see the same checks locally before CI.
View prompt
In the repository at <repo-path>, create /tmp/patch.diff from the diff against main and run `npx --yes codex-guard --diff /tmp/patch.diff`. Expected output: a list of TODO, secret and commit findings, or a clean result. Verify that no finding points to a file you did not change.
-
Check a Codex Guard install for config errors
Run the read-only doctor to find workflow, permission and policy mistakes locally.
- REPO
Akimiya-z/codex-guard - Software and DevOps
- Intermediate
View prompt
In the repository at <repo-path>, run `npx --yes codex-guard doctor --json` and save the output. Expected output: JSON describing each check as a pass, warning or error. Verify that the command exit code is 0 or 1 and that any error names the file and key involved.
- REPO
-
Set a per-repo gate policy agents cannot loosen
Put the policy in .github/codex-guard.yml on the default branch to set blocking rules.
- REPO
Akimiya-z/codex-guard - Software and DevOps
- Intermediate
View prompt
In the repository at <repo-path>, create .github/codex-guard.yml with `preset: balanced` and `comment-mode: replace`, then run `npx --yes codex-guard doctor`. Expected output: the policy file is accepted with no errors. Verify that the file is on the default branch and not only in a feature branch.
- REPO
-
Scan every open agent PR in one manual run
Use the sweep input with workflow_dispatch to check all open agent pull requests at once.
View prompt
In the repository at <repo-path>, add a workflow_dispatch trigger and set sweep to true in .github/workflows/codex-guard.yml, then run the workflow manually. Expected output: a report on each open agent PR targeting main. Verify that human-authored PRs without agent markers were not reported.
Quick start with Codex Guard
- Check you have what it needs: A GitHub repository with Actions enabled and permission to add a workflow file; Node.js with npx available on your machine; A Git working copy of the repository (the init command runs from its root).
- Open Akimiya-z/codex-guard on GitHub and read the README and license.
- Run
npx --yes codex-guard initfrom the root of your Git repository. - Run
git add .github/workflows/codex-guard.yml. - Run
git commit -m "ci: add Codex Guard"and push the branch. - Open a test pull request from a codex/ branch and check the Codex Guard report. (inferred, check the README)
These steps come from our top use case, Gate AI-generated PRs before they merge to main, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for Akimiya-z/codex-guard
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeCodex Guard alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forEngineering teams and maintainers who receive pull requests from AI coding agents and want automatic checks before human review.
- Why it is hot133 stars, launched 65 days ago
- LanguageJavaScript
- Sourcegithub.com/Akimiya-z/codex-guard · Back to Hot repos
Requirements
- A GitHub repository with Actions enabled and permission to add a workflow file
- Node.js with npx available on your machine
- A Git working copy of the repository (the init command runs from its root)
- Permission to change branch protection settings if you want the check to block merges
Add this badge to your README
Maintain Codex Guard? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/akimiya-z-codex-guard/?utm_source=github&utm_medium=badge&utm_campaign=Akimiya-z-codex-guard)
HTML
<a href="https://dedupedai.com/use-cases/akimiya-z-codex-guard/?utm_source=github&utm_medium=badge&utm_campaign=Akimiya-z-codex-guard"><img src="https://dedupedai.com/badge/Akimiya-z/codex-guard.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Codex Guard
What is Codex Guard?
A GitHub Action and CLI that checks AI-generated pull requests for TODO leftovers, leaked secrets, sloppy commit subjects and failing CI before they reach main. It is an open-source project on GitHub: https://github.com/Akimiya-z/codex-guard.
Who is Codex Guard for?
Engineering teams and maintainers who receive pull requests from AI coding agents and want automatic checks before human review.
What can I do with Codex Guard?
5 use cases so far, for example: Gate AI-generated PRs before they merge to main; Preview gate findings on a local diff before pushing; Check a Codex Guard install for config errors. Each has steps and a copy-paste agent prompt.
What do I need to run Codex Guard?
A GitHub repository with Actions enabled and permission to add a workflow file; Node.js with npx available on your machine; A Git working copy of the repository (the init command runs from its root); Permission to change branch protection settings if you want the check to block merges.
What are alternatives to Codex Guard?
Other hot AI repos in Software and DevOps: Codex LB Enhanced, Reuse Before Build, Aibuildai LLM Posttrain Agent, FlowX, Kyb.
Is Codex Guard safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.