{
 "schema_version": 1,
 "generated": "2026-10-24",
 "id": "akimiya-z-codex-guard--gate-agent-prs-on-github",
 "repo": "Akimiya-z/codex-guard",
 "repo_url": "https://github.com/Akimiya-z/codex-guard",
 "repo_slug": "akimiya-z-codex-guard",
 "title": "Gate AI-generated PRs before they merge to main",
 "page_title": "How to gate AI-generated PRs before they merge to main with Codex Guard",
 "summary": "Install a workflow that scans agent-written PRs for TODOs, secrets, bad commits and red CI.",
 "who": "A maintainer whose repo receives pull requests from Codex, Claude Code or Copilot and who wants routine problems caught before human review.",
 "problem": "Agent-written PRs often arrive with leftover TODO comments, hardcoded keys, WIP commit subjects and failing CI, which wastes reviewer time.",
 "outcome": "Agent PRs get annotated findings and a summary comment automatically, and the Codex Guard status check can block merges once you turn on enforcement.",
 "steps": [
  "Run `npx --yes codex-guard init` from 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)",
  "Set `preset: 'balanced'` in the workflow, then add Codex Guard under Settings, Branches, Require status checks."
 ],
 "agent_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`.",
 "agents": [
  "codex",
  "claude-code"
 ],
 "difficulty": "Intermediate",
 "time": "15 minutes",
 "basis": "readme",
 "caveat": "The installer starts in observe mode, so findings are reported but do not fail the workflow until you choose a stronger preset.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "javascript",
 "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"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/akimiya-z-codex-guard/gate-agent-prs-on-github/",
 "md": "https://dedupedai.com/use-cases/akimiya-z-codex-guard/gate-agent-prs-on-github/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/akimiya-z-codex-guard--gate-agent-prs-on-github.json",
 "api_version": "v1"
}