<p align="center" <img alt="GitGuardex logo" src="./logo.png" width="240" </p
<h1 align="center"GitGuardex</h1
<p align="center" <strongSafe parallel work for Codex, Claude, and humans.</strong<br One task → one worktree → one PR → one clean merge. </p
<p align="center" <a href="https://www.npmjs.com/package/@imdeadpool/guardex"<img alt="npm version" src="https://img.shields.io/npm/v/%40imdeadpool%2Fguardex?label=npm&style=flat-square&color=cb3837&logo=npm&logoColor=white"</a <a href="https://github.com/recodeee/gitguardex/actions/workflows/ci.yml"<img alt="CI status" src="https://img.shields.io/github/actions/workflow/status/recodeee/gitguardex/ci.yml?branch=main&label=CI&style=flat-square"</a <a href="https://scorecard.dev/viewer/?uri=github.com/recodeee/gitguardex"<img alt="OpenSSF Scorecard" src="https://img.shields.io/ossf-scorecard/github.com/recodeee/gitguardex?label=OpenSSF%20Scorecard&style=flat-square"</a <a href="https://github.com/recodeee/gitguardex/stargazers"<img alt="GitHub stars" src="https://img.shields.io/github/stars/recodeee/gitguardex?label=stars&style=flat-square&color=d4ac0d"</a <a href="./LICENSE"<img alt="license" src="https://img.shields.io/npm/l/%40imdeadpool%2Fguardex?label=license&style=flat-square&color=97ca00"</a </p
<p align="center" <a href="#install"Install</a · <a href="#the-problem"Why</a · <a href="#what-gitguardex-can-do"Capabilities</a · <a href="#see-every-lane-in-vs-code"VS Code view</a · <a href="#daily-workflow"Workflow</a · <a href="#code-assist-review-gate"Code assist</a · <a href="#essential-commands"Commands</a </p
---
Install
<p align="center" <img alt="Install GitGuardex" src="https://raw.githubusercontent.com/recodeee/gitguardex/main/docs/images/install-hero.svg" width="680" </p
npm i -g @imdeadpool/guardex
cd /path/to/your-repo
gx setup
gx onboard # optional 2-minute tourRequires Node.js 18+, Git, and GitHub CLI (gh). Recommended on macOS or Linux; use WSL on Windows.
[!WARNING] GitGuardex is an independent project. It is not affiliated with OpenAI, Anthropic, or Codex.
---
The problem
Parallel agents can edit the same files, overwrite tests, or commit directly to main. More agents can create more conflicts instead of more progress.
What GitGuardex can do
<p align="center" <img alt="GitGuardex capability map: isolated lanes, evidence-driven shipping, and safe cleanup" src="https://raw.githubusercontent.com/opencue/gitguardex/main/docs/images/capabilities-dark.svg" width="900" </p
| Isolate and coordinate | Ship with evidence | Recover without loss | | --- | --- | --- | | One agent/ branch and worktree per task. | Preflight, CI, and optional AI review block risky merges. | Dirty, locked, blocked, and uncertain lanes are preserved. | | Shared file claims prevent silent overwrites. | The recorded base keeps unattended finishes on the correct target. | Successful lanes are merged, then their temporary branch and worktree are removed. | | Protected branches stay behind a PR boundary. | Billing-aware fallbacks waive only explicitly named checks. | Cleanup fails closed instead of deleting work it cannot prove safe. |
<details <summary<strongImplementation evidence and shipped hardening</strong</summary