From 48a99b974c86c306bbf0dff9ed38600a43a997e1 Mon Sep 17 00:00:00 2001 From: NagyVikt Date: Wed, 22 Apr 2026 15:24:25 +0200 Subject: [PATCH] Make the README feel like the product before readers hit the docs The old first screen opened with a badge wall and a plain heading, which hid the brand shape and made the README feel denser than the actual product pitch. This reworks the hero into a centered GitHub-dark style using the existing root logo, a tighter badge row, and quick anchor links while keeping the deeper README sections intact. Constraint: Must stay GitHub README-safe and reuse ./logo.png Rejected: Full README rewrite | too much copy churn for a style-only ask Confidence: high Scope-risk: narrow Directive: Keep the hero centered and lightweight; do not reintroduce the top-of-file badge wall without a stronger visual reason Tested: README source review; git diff --check Not-tested: Browser-rendered GitHub preview --- README.md | 49 +++++++++++++++++++++++++++++++++++++------------ 1 file changed, 37 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index b30a01c..a6408ea 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,44 @@ -# GitGuardex — Guardian T-Rex for your repo +

+ gitguardex logo +

+ +

gitguardex

+ +

+ guardian t-rex for multi-agent repos +

+ +

+ isolated worktrees, file locks, and PR-only merges for codex, claude, and human teammates +

-[![npm version](https://img.shields.io/npm/v/%40imdeadpool%2Fguardex?label=npm&color=cb3837&logo=npm)](https://www.npmjs.com/package/@imdeadpool/guardex) -[![npm downloads](https://img.shields.io/npm/dm/%40imdeadpool%2Fguardex?label=downloads&color=0b76c5)](https://www.npmjs.com/package/@imdeadpool/guardex) -[![GitHub stars](https://img.shields.io/github/stars/recodeee/gitguardex?label=stars&color=d4ac0d)](https://github.com/recodeee/gitguardex/stargazers) -[![License](https://img.shields.io/npm/l/%40imdeadpool%2Fguardex?label=License&color=97ca00)](./LICENSE) +

+ npm version + stars + last commit + license +

-[![CI](https://img.shields.io/github/actions/workflow/status/recodeee/gitguardex/ci.yml?branch=main&label=CI)](https://github.com/recodeee/gitguardex/actions/workflows/ci.yml) -[![Release](https://img.shields.io/github/actions/workflow/status/recodeee/gitguardex/release.yml?label=Release)](https://github.com/recodeee/gitguardex/actions/workflows/release.yml) -[![CodeQL](https://img.shields.io/github/actions/workflow/status/recodeee/gitguardex/codeql.yml?branch=main&label=CodeQL)](https://github.com/recodeee/gitguardex/actions/workflows/codeql.yml) -[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/recodeee/gitguardex/badge)](https://securityscorecards.dev/viewer/?uri=github.com/recodeee/gitguardex) +

+ About • + Install • + What it does • + Workflow • + VS Code • + Commands +

-[about_description.txt](./about_description.txt) +

+ guard many agent. keep one repo clean. +

-Guardian T-Rex for your multi-agent repo. Isolated worktrees, file locks, and PR-only merges stop parallel Codex & Claude agents from overwriting each other's work. Auto-wires Oh My Codex, Oh My Claude, OpenSpec, and Caveman. +

+ GitGuardex is a safety layer for parallel agent work in git repos. Every task gets an isolated + worktree, claimed files, and a PR-only finish path instead of one shared checkout where agents + stomp each other. +

-**GitGuardex is a safety layer for parallel agent work in git repos.** If you're running more than one Codex or Claude agent on the same codebase, this is what keeps them from deleting each other's work. +--- > [!WARNING] > Not affiliated with OpenAI, Anthropic, or Codex. Not an official tool. @@ -36,6 +60,7 @@ I was running ~30 Codex agents in parallel and hit a wall: they kept working on GitGuardex exists to stop that loop. Every agent gets its own worktree, claims the files it's touching, and can't clobber files another agent has claimed. Your local branch stays clean; agents stay in their lanes. +## Install

Install GitGuardex