@imdeadpool/guardex 7.0.10 → 7.0.11

package/README.md

@@ -9,6 +9,9 @@
 > [!WARNING]
 > Not affiliated with OpenAI, Anthropic, or Codex. Not an official tool.
 
+> [!IMPORTANT]
+> GitGuardex is still being tested in real multi-agent repos. If something feels rough or broken, especially around cleanup, finish, merge, or recovery flows, sorry. We need to test those paths under real load first, and we'll patch issues as we find them.
+
 ---
 
 ## The problem
@@ -19,6 +22,8 @@ GitGuardex exists to stop that loop. Every agent gets its own worktree, claims t
 
 ![Multi-agent dashboard example](https://raw.githubusercontent.com/recodeee/gitguardex/main/docs/images/dashboard-multi-agent.png)
 
+Coming soon: [recodee.com](https://recodee.com) — live account health, usage, routing, and capacity in one place.
+
 ```mermaid
 flowchart LR
     A[Agent A edits shared files] --> S[Same target surface]
@@ -41,7 +46,7 @@ flowchart LR
 - **Explicit file lock claiming** — an agent declares which files it's editing before it edits them.
 - **Deletion guard** — claimed files can't be removed by another agent.
 - **Protected-base safety** — `main`, `dev`, `master` are blocked by default; agents must go through PRs.
-- **Auto-merges agent configs into every worktree** — `oh-my-codex`, `oh-my-claude`, caveman mode, and OpenSpec all get applied automatically so every spawned agent starts tuned, not bare.
+- **Auto-merges agent configs into every worktree** — `oh-my-codex`, `oh-my-claudecode`, caveman mode, and OpenSpec all get applied automatically so every spawned agent starts tuned, not bare.
 - **Repair/doctor flow** — when drift happens (and it will), `gx doctor` gets you back to a clean state.
 - **Auto-finish** — when Codex exits a session, Guardex commits sandbox changes, syncs against the base, retries once if the base moved, and opens a PR.
 
@@ -59,6 +64,16 @@ That's it. Setup installs hooks, scripts, templates, and scaffolds OpenSpec/cave
 
 ---
 
+## What `gx` shows first
+
+Before you branch, repair, or start agents, run plain `gx`. It gives you a one-screen status view for the CLI, global helpers, repo safety service, current repo path, and active branch.
+
+![GitGuardex terminal status output](https://raw.githubusercontent.com/recodeee/gitguardex/main/docs/images/workflow-gx-terminal-status.svg)
+
+Use `gx setup` the first time you wire GitGuardex into a repo. It bootstraps the managed hooks, scripts, templates, and optional workspace/OpenSpec wiring. If the repo drifts later, use `gx doctor` as the repair path: it reapplies the managed safety files, verifies the setup, and on protected `main` it auto-sandboxes the repair so your visible base branch stays clean.
+
+---
+
 ## Daily workflow
 
 Per new agent task:
@@ -222,7 +237,7 @@ A few things worth knowing up front:
 
 - Running `gx` with no command opens the status/health view.
 - `gx init` is just an alias for `gx setup`.
-- Setup/doctor can install missing global OMX, OpenSpec, and codex-auth — but only with explicit Y/N confirmation.
+- Setup/doctor can install missing global companion CLIs (OMC runtime, OpenSpec, cavemem, codex-auth) — but only with explicit Y/N confirmation.
 - Direct commits/pushes to protected branches are **blocked** by default. Agents must use the `agent/*` + PR flow.
 - **Exception:** VS Code Source Control commits are allowed on protected branches that exist only locally (no upstream, no remote branch).
 - On protected `main`, `gx doctor` auto-runs in a sandbox agent branch/worktree so it can't touch your real main.
@@ -240,21 +255,82 @@ git config multiagent.allowVscodeProtectedBranchWrites true
 
 ## Companion tools
 
-GitGuardex is designed to work alongside these. All optional — but if you're running many agents, you probably want them.
+GitGuardex is designed to work alongside these. All optional — but if you're running many agents, you probably want them. `gx status` reports the machine-detectable global helpers; plugin/skills-first add-ons like `caveman` and `cavekit` are documented below for manual setup.
 
-### GitHub CLI (`gh`)
+```text
+● oh-my-codex: active
+● oh-my-claude-sisyphus: active
+● @fission-ai/openspec: active
+● cavemem: active
+● @imdeadpool/codex-account-switcher: active
+● gh: active
+```
 
-Required for PR/merge automation. `agent-branch-finish.sh` and `codex-agent.sh` auto-finish both depend on it.
+### oh-my-codex — Codex config + skills framework
+
+Loads skills, slash commands, and session defaults into Codex. Guardex merges `oh-my-codex` into every agent worktree automatically, so every spawned agent starts with the same tuned config instead of vanilla Codex.
 
 ```sh
-# https://cli.github.com/
-gh --version
-gh auth status
+npm i -g oh-my-codex
+```
+
+Repo: <https://github.com/Yeachan-Heo/oh-my-codex>
+
+### oh-my-claudecode — Claude Code equivalent
+
+Claude-side mirror of oh-my-codex. Same idea: skills, commands, and defaults loaded into every Claude Code session. Guardex merges it into worktrees alongside oh-my-codex so mixed Codex + Claude agent fleets behave consistently. For the npm CLI/runtime path, the published package name is `oh-my-claude-sisyphus`.
+
+```sh
+npm i -g oh-my-claude-sisyphus@latest
+```
+
+Repo: <https://github.com/Yeachan-Heo/oh-my-claudecode>
+
+### Caveman — output compression for long agent runs
+
+Ultra-compressed response mode for Claude/Codex-style agents. Useful when you want less output-token churn during long reviews, debug loops, or multi-agent sessions.
+
+```sh
+npx skills add JuliusBrussee/caveman
+```
+
+Repo: <https://github.com/JuliusBrussee/caveman>
+
+### Cavemem — local persistent memory for agents
+
+Cross-agent memory with local SQLite + MCP. Helpful when you want Codex or Claude sessions to retain compressed history across runs. `gx setup` can install the CLI; you still run the IDE wiring once per machine.
+
+```sh
+npm install -g cavemem
+cavemem install --ide codex
+cavemem status
 ```
 
+Repo: <https://github.com/JuliusBrussee/cavemem>
+
+### Cavekit — spec-driven build loop
+
+Spec-driven workflow layer for building from durable specs with explicit build/check commands. The current install path also brings in its `spec`, `build`, `check`, `caveman`, and `backprop` skills.
+
+```sh
+npx skills add JuliusBrussee/cavekit
+```
+
+Repo: <https://github.com/JuliusBrussee/cavekit>
+
+### OpenSpec — spec-driven workflows
+
+Structured plan/change/apply/archive flow for agents. Prevents them from drifting off-task on long jobs. Full guide: [`docs/openspec-getting-started.md`](./docs/openspec-getting-started.md).
+
+```sh
+npm i -g @fission-ai/openspec
+```
+
+Repo: <https://github.com/Fission-AI/OpenSpec>
+
 ### codex-auth — multi-account switcher
 
-For multi-identity Codex workflows. I built this because switching accounts manually for 30 agents was impossible.
+For multi-identity Codex workflows. I built this because switching accounts manually for 30 agents was impossible. Auto-registers accounts to a dashboard on `codex login` so you can see every account and switch with one command.
 
 ```sh
 npm i -g @imdeadpool/codex-account-switcher
@@ -267,6 +343,16 @@ codex-auth current
 
 Repo: [recodeecom/codex-account-switcher-cli](https://github.com/recodeecom/codex-account-switcher-cli)
 
+### GitHub CLI (`gh`)
+
+Required for PR/merge automation. `agent-branch-finish.sh` and `codex-agent.sh` auto-finish both depend on it.
+
+```sh
+# https://cli.github.com/
+gh --version
+gh auth status
+```
+
 ### Pull app — fork auto-sync
 
 Guardex installs a starter config at `.github/pull.yml.example`.
@@ -283,7 +369,7 @@ Validate: `https://pull.git.ci/check/<owner>/<repo>`
 
 Install: <https://github.com/apps/cr-gpt>
 
-`gx setup` installs `.github/workflows/cr.yml`. Then add `OPENAI_API_KEY` under `Settings → Secrets and variables → Actions → Variables`. After that, new and updated PRs get reviewed automatically.
+`gx setup` installs `.github/workflows/cr.yml`. Add `OPENAI_API_KEY` under `Settings → Secrets and variables → Actions → Secrets`. After that, new and updated PRs get reviewed automatically.
 
 ---
 
@@ -402,6 +488,11 @@ npm pack --dry-run
 <details>
 <summary><strong>v7.x</strong></summary>
 
+### v7.0.11
+- Fixed the npm release workflow trigger so publishes run from `release.published` or explicit manual dispatch, instead of double-firing on both the tag push and the release event.
+- This keeps the GitHub `npm` environment from collecting duplicate cancelled deploy cards for the same version and leaves one canonical release deployment to monitor.
+- Bumped `@imdeadpool/guardex` from `7.0.10` → `7.0.11` so the next release can publish cleanly after `7.0.10` was already taken on npm.
+
 ### v7.0.10
 - Primary user-facing long name is now **GitGuardex**. CLI/help presents `gitguardex` as the long-form command; `gx` stays the preferred short alias; `guardex` remains as legacy compatibility.
 - Installed Codex/Claude startup files now use `gitguardex` paths: `.codex/skills/gitguardex/SKILL.md` and `.claude/commands/gitguardex.md`.

package/bin/multiagent-safety.js

@@ -11,10 +11,13 @@ const TOOL_NAME = 'gitguardex';
 const SHORT_TOOL_NAME = 'gx';
 const LEGACY_NAMES = ['guardex', 'multiagent-safety'];
 const OPENSPEC_PACKAGE = '@fission-ai/openspec';
+const OMC_PACKAGE = 'oh-my-claude-sisyphus';
+const CAVEMEM_PACKAGE = 'cavemem';
 const GLOBAL_TOOLCHAIN_PACKAGES = [
   'oh-my-codex',
-  'oh-my-claude',
+  OMC_PACKAGE,
   OPENSPEC_PACKAGE,
+  CAVEMEM_PACKAGE,
   '@imdeadpool/codex-account-switcher',
 ];
 const GH_BIN = process.env.GUARDEX_GH_BIN || 'gh';
@@ -4713,7 +4716,7 @@ function setup(rawArgs) {
       `[${TOOL_NAME}] ✅ Global tools installed (${(globalInstallStatus.packages || []).join(', ')}).`,
     );
   } else if (globalInstallStatus.status === 'already-installed') {
-    console.log(`[${TOOL_NAME}] ✅ OMX/OpenSpec/codex-auth npm global tools already installed. Skipping.`);
+    console.log(`[${TOOL_NAME}] ✅ Companion npm global tools already installed. Skipping.`);
   } else if (globalInstallStatus.status === 'failed') {
     console.log(
       `[${TOOL_NAME}] ⚠️ Global install failed: ${globalInstallStatus.reason}\n` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imdeadpool/guardex",
-  "version": "7.0.10",
+  "version": "7.0.11",
   "description": "GitGuardex: hardened multi-agent git guardrails for parallel agent work.",
   "license": "MIT",
   "preferGlobal": true,