overcodex 0.1.0__py3-none-any.whl

overcodex/payload/prompts/handoff-status.md

@@ -0,0 +1,26 @@
+---
+description: "Show whether a handoff package is pending for this directory, and how old it is."
+argument-hint: ""
+---
+
+# /prompts:handoff-status — check pending handoff state
+
+## 1. Compute the state path
+
+Run exactly this (macOS /bin/bash 3.2 compatible):
+
+```bash
+HASH=$(printf '%s' "$PWD" | /usr/bin/shasum -a 256 | awk '{print $1}' | cut -c1-12)
+STATE_DIR="${CODEX_HOME:-$HOME/.codex}/overcodex"
+PENDING="$STATE_DIR/handoff-pending-$HASH.md"
+```
+
+## 2. Report
+
+- If `$PENDING` does not exist: report "no handoff pending for this directory."
+- If it exists: read line 1, extract `created="<epoch>"`. Compute age with `NOW=$(date +%s); AGE=$((NOW - CREATED))`.
+  - Report the path, age in minutes, and the one-line goal (from the `# Handoff — <goal>` heading, line 2).
+  - If age < 600s: "still eligible for auto-injection on next `codex` launch in this directory."
+  - If age >= 600s: "expired — no longer auto-injected; contents are still readable at this path, or run `/prompts:handoff` again to repackage."
+
+Do not modify or delete the file — this is a read-only probe. If the user wants it removed, point them at `/prompts:handoff-cancel`.

overcodex/payload/prompts/handoff.md

@@ -0,0 +1,57 @@
+---
+description: "Package this session's state and prepare a fresh Codex session to pick it up."
+argument-hint: "[now|force]"
+---
+
+GATE — read before acting. Only run this if the user explicitly asked for a handoff (typed `/prompts:handoff` or `/handoff` themselves, or said yes to an offer to hand off). If no such consent exists in this conversation, stop and ask instead: "Want me to hand this off to a fresh session?"
+
+# /prompts:handoff — continue in a fresh Codex session
+
+Codex has no live session-switching command analogous to `/swap` — this prompt only packages state for the NEXT `codex` invocation to pick up via the SessionStart hook. The user must exit and relaunch manually; there is no in-place restart.
+
+## 1. Compute the state paths
+
+Run exactly this to get the cwd hash (macOS /bin/bash 3.2 compatible):
+
+```bash
+HASH=$(printf '%s' "$PWD" | /usr/bin/shasum -a 256 | awk '{print $1}' | cut -c1-12)
+STATE_DIR="${CODEX_HOME:-$HOME/.codex}/overcodex"
+PENDING="$STATE_DIR/handoff-pending-$HASH.md"
+mkdir -p "$STATE_DIR"
+```
+
+`$PENDING` is the target file for this cwd. If `$CODEX_HOME` is set in the environment, it wins — never hardcode `~/.codex`.
+
+## 2. Overwrite guard
+
+If `$PENDING` already exists, check its `created` epoch (first line, see format below). If less than 600 seconds old, warn the user: "another handoff pending for this cwd (<N> min ago) — proceeding replaces it" and wait for confirmation before continuing.
+
+## 3. Write the package
+
+Write to `$PENDING` with this exact structure. Line 1 MUST be the comment shown, first line, no blank line before it — `cwd` is the absolute cwd, `created` is the current epoch integer (`date +%s`):
+
+```markdown
+<!-- handoff cwd="<abs-cwd>" created="<epoch-int>" -->
+# Handoff — <one-line goal>
+
+## Goal
+## Current state
+## Decisions + rationale
+## Files touched
+## Work in flight
+## Next steps
+## Gotchas
+## Session chain
+```
+
+Fill every section from this conversation — concise and decision-dense, a summary not a transcript. Files touched: absolute paths. Work in flight: anything half-done, with exact resume points. Session chain: append one line for this session — `<session-id-if-known> — <cwd> — <YYYY-MM-DD>` — keep only the last 3 entries; if this session itself began with an injected handoff note, carry its prior entries forward first.
+
+## 4. Tell the user
+
+"Handoff packaged at `$PENDING`. Exit this session and run `codex` again from the same directory — the SessionStart hook will inject it automatically. The package expires after 10 minutes; after that it's stale (still readable via `/prompts:handoff-status`, but no longer auto-injected)."
+
+`now` token: there is no phase-2 idle-kill for Codex sessions yet — always fall back to the manual exit-and-relaunch instruction above, and say so explicitly rather than implying an automatic kill happened.
+
+## VS Code / non-TTY entrypoints
+
+If the entrypoint can't be exited/relaunched by the user directly (e.g. an embedded extension host), write the package (steps 1–3) but tell the user the window must be reloaded manually for the injector to pick it up on the next session start.

overcodex/payload/shell/zshrc-snippet.sh

@@ -0,0 +1,24 @@
+# --- overcodex integration (begin) ---
+# codex-swap is installed to ~/.local/bin — ensure it is on PATH.
+case ":$PATH:" in *":$HOME/.local/bin:"*) ;; *) export PATH="$HOME/.local/bin:$PATH" ;; esac
+alias cswap-codex='codex-swap'
+codex() {
+  local active_file="$HOME/.codex-accounts/.active"
+  local name=""
+  [ -f "$active_file" ] && name=$(tr -d '[:space:]' <"$active_file" 2>/dev/null)
+  case "$name" in
+    ""|primary)
+      unset CODEX_HOME
+      ;;
+    *)
+      if [ -d "$HOME/.codex-accounts/$name" ]; then
+        export CODEX_HOME="$HOME/.codex-accounts/$name"
+      else
+        echo "overcodex: active account '$name' not found under ~/.codex-accounts — falling back to primary (~/.codex)" >&2
+        unset CODEX_HOME
+      fi
+      ;;
+  esac
+  command codex "$@"
+}
+# --- overcodex integration (end) ---

overcodex/payload/uninstall.sh

@@ -0,0 +1,196 @@
+#!/bin/bash
+# uninstall.sh — overcodex uninstaller.
+# macOS /bin/bash 3.2 compatible. set -u; errors handled explicitly.
+# Removes exactly what install.sh added. Leaves user state untouched:
+# accounts (auth.json), sessions/threads (sqlite), and any non-overcodex
+# content in config.toml / AGENTS.md / .zshrc.
+
+set -u
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+
+CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
+LOCALBIN="$HOME/.local/bin"
+ZSHRC="$HOME/.zshrc"
+
+CONFIG_TOML="$CODEX_HOME/config.toml"
+AGENTS_MD="$CODEX_HOME/AGENTS.md"
+
+SRC_SWAP="$SCRIPT_DIR/bin/codex-swap"
+
+# Markers (must match install.sh exactly).
+AGENTS_BEGIN='# --- overcodex ultracode (begin) ---'
+AGENTS_END='# --- overcodex ultracode (end) ---'
+ZSH_BEGIN='# --- overcodex integration (begin) ---'
+ZSH_END='# --- overcodex integration (end) ---'
+HOOKS_BEGIN='# --- overcodex hooks (begin) ---'
+HOOKS_END='# --- overcodex hooks (end) ---'
+SL_BEGIN='# --- overcodex statusline (begin) ---'
+SL_END='# --- overcodex statusline (end) ---'
+
+EPOCH=$(date +%s)
+
+DID=()
+SKIPPED=()
+WARNED=()
+note_did()  { DID[${#DID[@]}]="$1";     echo "  [-] $1"; }
+note_skip() { SKIPPED[${#SKIPPED[@]}]="$1"; echo "  [=] $1"; }
+note_warn() { WARNED[${#WARNED[@]}]="$1";   echo "  [!] $1" >&2; }
+die()       { echo "uninstall: ERROR: $1" >&2; exit 1; }
+
+backup_file() {
+  bf_path="$1"
+  if [ -f "$bf_path" ]; then
+    cp -p "$bf_path" "$bf_path.bak-$EPOCH" || die "backup failed: $bf_path"
+    echo "$bf_path.bak-$EPOCH"
+  fi
+}
+
+# strip_block <file> <begin> <end>
+#   Delete the inclusive begin..end range. Buffers runs of blank lines so the
+#   single separator blank that install.sh writes before a block is consumed
+#   with it (keeps install/uninstall cycles byte-idempotent); at most one blank
+#   is dropped, user blank lines survive. Prints nothing; returns 0 always.
+strip_block() {
+  sb_file="$1"; sb_begin="$2"; sb_end="$3"
+  awk -v b="$sb_begin" -v e="$sb_end" '
+    $0 == b { drop = 1
+              if (pending > 0) pending--
+              while (pending > 0) { print ""; pending-- } }
+    drop != 1 {
+      if ($0 == "") { pending++ }
+      else { while (pending > 0) { print ""; pending-- }; print }
+    }
+    $0 == e { drop = 0 }
+    END { while (pending > 0) { print ""; pending-- } }
+  ' "$sb_file"
+}
+
+echo "== overcodex uninstaller =="
+echo "   CODEX_HOME: $CODEX_HOME"
+echo "   epoch:      $EPOCH"
+echo
+
+# ---------------------------------------------------------------------------
+# 1. Remove copied files (only the ones the kit installs).
+# ---------------------------------------------------------------------------
+echo "-- files --"
+
+# codex-swap.
+if [ -f "$LOCALBIN/codex-swap" ]; then
+  rm -f "$LOCALBIN/codex-swap" && note_did "removed $LOCALBIN/codex-swap" \
+    || note_warn "could not remove $LOCALBIN/codex-swap"
+else
+  note_skip "not present: $LOCALBIN/codex-swap"
+fi
+
+# Hook scripts (by the names shipped in the kit).
+for h in "$SCRIPT_DIR"/hooks/*.sh; do
+  [ -f "$h" ] || continue
+  dest="$CODEX_HOME/hooks/$(basename "$h")"
+  if [ -f "$dest" ]; then
+    rm -f "$dest" && note_did "removed $dest" || note_warn "could not remove $dest"
+  else
+    note_skip "not present: $dest"
+  fi
+done
+
+
+# Prompts (by the names shipped in the kit).
+for p in "$SCRIPT_DIR"/prompts/*.md; do
+  [ -f "$p" ] || continue
+  dest="$CODEX_HOME/prompts/$(basename "$p")"
+  if [ -f "$dest" ]; then
+    rm -f "$dest" && note_did "removed $dest" || note_warn "could not remove $dest"
+  else
+    note_skip "not present: $dest"
+  fi
+done
+
+# Prune now-empty kit dirs (never touch anything non-empty).
+for d in "$CODEX_HOME/hooks" "$CODEX_HOME/prompts"; do
+  [ -d "$d" ] && rmdir "$d" 2>/dev/null && note_did "removed empty dir $d"
+done
+echo
+
+# ---------------------------------------------------------------------------
+# 2. config.toml — remove ONLY our marker blocks (hooks + status_line).
+# ---------------------------------------------------------------------------
+echo "-- config.toml --"
+if [ ! -f "$CONFIG_TOML" ]; then
+  note_skip "no config.toml"
+else
+  HAS_HOOKS=no; HAS_SL=no
+  grep -qF "$HOOKS_BEGIN" "$CONFIG_TOML" && HAS_HOOKS=yes
+  grep -qF "$SL_BEGIN"    "$CONFIG_TOML" && HAS_SL=yes
+  if [ "$HAS_HOOKS" = no ] && [ "$HAS_SL" = no ]; then
+    note_skip "config.toml has no overcodex blocks (no change)"
+  else
+    b=$(backup_file "$CONFIG_TOML")
+    tmp="$CONFIG_TOML.tmp-$EPOCH"
+    cp "$CONFIG_TOML" "$tmp" || die "could not stage config.toml"
+    if [ "$HAS_HOOKS" = yes ]; then
+      strip_block "$tmp" "$HOOKS_BEGIN" "$HOOKS_END" > "$tmp.2" && mv "$tmp.2" "$tmp" \
+        || die "could not strip hooks block"
+    fi
+    if [ "$HAS_SL" = yes ]; then
+      strip_block "$tmp" "$SL_BEGIN" "$SL_END" > "$tmp.2" && mv "$tmp.2" "$tmp" \
+        || die "could not strip status_line block"
+    fi
+    mv "$tmp" "$CONFIG_TOML" || die "could not write $CONFIG_TOML"
+    [ "$HAS_HOOKS" = yes ] && note_did "removed hooks block from config.toml (backup: $b)"
+    [ "$HAS_SL" = yes ]    && note_did "removed [tui].status_line block from config.toml (backup: $b)"
+  fi
+fi
+echo
+
+# ---------------------------------------------------------------------------
+# 3. AGENTS.md — remove the ultracode block between markers.
+# ---------------------------------------------------------------------------
+echo "-- AGENTS.md --"
+if [ -f "$AGENTS_MD" ] && grep -qF "$AGENTS_BEGIN" "$AGENTS_MD"; then
+  b=$(backup_file "$AGENTS_MD")
+  strip_block "$AGENTS_MD" "$AGENTS_BEGIN" "$AGENTS_END" > "$AGENTS_MD.tmp-$EPOCH" \
+    && mv "$AGENTS_MD.tmp-$EPOCH" "$AGENTS_MD" \
+    && note_did "removed ultracode block from $AGENTS_MD (backup: $b)" \
+    || note_warn "could not edit $AGENTS_MD"
+  # If AGENTS.md is now empty (only whitespace), drop the file we effectively created.
+  if [ -f "$AGENTS_MD" ] && ! grep -q '[^[:space:]]' "$AGENTS_MD" 2>/dev/null; then
+    rm -f "$AGENTS_MD" && note_did "removed now-empty $AGENTS_MD"
+  fi
+else
+  note_skip "no ultracode block in AGENTS.md"
+fi
+echo
+
+# ---------------------------------------------------------------------------
+# 4. .zshrc — delete the integration block between markers.
+# ---------------------------------------------------------------------------
+echo "-- .zshrc --"
+if [ -f "$ZSHRC" ] && grep -qF "$ZSH_BEGIN" "$ZSHRC"; then
+  b=$(backup_file "$ZSHRC")
+  strip_block "$ZSHRC" "$ZSH_BEGIN" "$ZSH_END" > "$ZSHRC.tmp-$EPOCH" \
+    && mv "$ZSHRC.tmp-$EPOCH" "$ZSHRC" \
+    && note_did "removed integration block from $ZSHRC (backup: $b)" \
+    || note_warn "could not edit $ZSHRC"
+  note_warn "Open a new shell for the change to take effect."
+else
+  note_skip "no integration block in .zshrc"
+fi
+echo
+
+# ---------------------------------------------------------------------------
+# Summary + what we deliberately kept.
+# ---------------------------------------------------------------------------
+echo "== summary =="
+echo "  changed:  ${#DID[@]}"
+echo "  skipped:  ${#SKIPPED[@]}"
+echo "  warnings: ${#WARNED[@]}"
+echo
+echo "-- kept (user state, never touched) --"
+echo "  * $CODEX_HOME/auth.json        (your account credentials)"
+echo "  * $CODEX_HOME/*.sqlite         (sessions / thread history)"
+echo "  * remaining $CONFIG_TOML       (all non-overcodex settings)"
+echo "  * any per-account CODEX_HOME dirs you created for codex-swap"
+echo "  * timestamped .bak-$EPOCH copies of every file we edited"
+echo "Done."

overcodex-0.1.0.dist-info/METADATA

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: overcodex
+Version: 0.1.0
+Summary: Codex CLI, overclocked — cold multi-account switching, context-threshold handoff, instrumented statusline, and AGENTS.md routing policy for multi-agent workflows
+Project-URL: Homepage, https://github.com/arthur-bump-pm/overcodex
+Project-URL: Repository, https://github.com/arthur-bump-pm/overcodex
+Project-URL: Issues, https://github.com/arthur-bump-pm/overcodex/issues
+Author: arthur-bump-pm
+License: MIT
+License-File: LICENSE
+Keywords: cli,codex,codex-cli,dotfiles
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# overcodex
+
+[![PyPI version](https://img.shields.io/pypi/v/overcodex)](https://pypi.org/project/overcodex/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+![Platform: macOS](https://img.shields.io/badge/platform-macOS-lightgrey)
+
+**Codex CLI, overclocked.** Cold-switch between Codex accounts, hand off to a fresh session with `/prompts:handoff` before context fills up, watch usage on the statusline, and route multi-agent work with an AGENTS.md policy:
+
+```text
+codex-swap work         # register/list accounts, then switch — restart required
+/prompts:handoff        # package this session's state, resume fresh next launch
+
+ctx [████░░░░░░] 42% remaining | 5h limit 71% | weekly limit 18%
+└ get_context_remaining      └ native Codex statusline items
+```
+
+## Install
+
+```bash
+pipx install overcodex && overcodex install
+```
+
+> **Fresh machine?** If you get `command not found: overcodex`, pipx's bin folder isn't on your PATH yet — run `pipx ensurepath && source ~/.zshrc`, then `overcodex install`. (Use `source`, not `exec zsh`: replacing the shell swallows any commands you pasted after it.)
+
+Then register your accounts (once, per account):
+
+```bash
+codex-swap add work        # creates an isolated account home + links shared config
+codex-swap add personal    # then log in to each: CODEX_HOME=~/.codex-accounts/work codex login
+codex-swap work             # cold switch: writes auth.json, then restart codex
+```
+
+Start a **new** Codex CLI session (hooks and AGENTS.md load at session start) and confirm the statusline shows the context/limit meters. Run `/prompts:handoff` inside Codex to hand off before you hit auto-compact.
+
+<details>
+<summary>Other install methods, requirements, upgrading</summary>
+
+```bash
+# uv
+uv tool install overcodex && overcodex install
+
+# from source
+git clone https://github.com/arthur-bump-pm/overcodex && cd overcodex && ./install.sh
+```
+
+Or paste this into any Codex CLI session and let it install itself:
+
+> Install overcodex (https://github.com/arthur-bump-pm/overcodex) on this machine, fix anything its preflight complains about, and tell me what post-install steps I need to do myself.
+
+**Requirements:** macOS, zsh, `pipx` or `uv`, a Codex CLI install (`codex --version`). No keychain daemon and no background credential engine — cold switching is just isolated `$CODEX_HOME` directories, one per account.
+
+**Upgrade:** `pipx upgrade overcodex && overcodex install`
+
+**Uninstall:** `overcodex uninstall` — removes exactly what install added (backed up); each account's isolated `$CODEX_HOME` copy survives untouched.
+
+The installer is idempotent and conservative: timestamped backups of everything it touches, additive edits to `config.toml` (never overwrites an existing `hooks` or `status_line` key), re-running is a no-op.
+
+</details>
+
+## What you get
+
+### `codex-swap` — cold account switching
+Each account gets its own isolated `CODEX_HOME` (a separate `auth.json`, never a copied/overwritten one — refresh tokens can be single-use across copies, so isolation is the only safe design). `codex-swap <account>` points the shell at that directory and tells you to restart. **This is a cold switch**: any Codex session already running keeps its old credentials until you quit and relaunch it. There is no hot mid-session swap here — if you need that, it's overclaude's `/swap` for Claude Code, not this.
+
+### `/prompts:handoff` — escape context bloat, keep the thread
+
+```mermaid
+flowchart LR
+    A[Context fills up] --> B[get_context_remaining / statusline flags it]
+    B --> C[You run /prompts:handoff]
+    C --> D[Codex packages goals, state, next steps]
+    D --> E[Session ends]
+    E --> F[SessionStart hook injects the package on next launch]
+    F --> G[Fresh session, ctx near zero]
+    G --> A
+```
+
+You lose the token bloat, not the thread. Combine with a `codex-swap` restart when you're also switching accounts.
+
+### Statusline
+Codex's native statusline already covers the meters — run `/statusline` inside Codex and enable the context, five-hour, and weekly items (or set `tui.status_line` in config.toml yourself). The kit deliberately ships no statusline config: the native picker is authoritative, and the exact config-key vocabulary is undocumented — nothing to clobber, nothing to break.
+
+### AGENTS.md routing policy
+A policy block appended to `$CODEX_HOME/AGENTS.md` (loaded globally, then project `AGENTS.md` files concatenate root-down): bulk work rides cheap models/effort, verification rides a stronger reasoning tier, only final judgment spends the top tier. Routing table, hard floors, escalation rules included.
+
+### Hooks + prompts
+`PreToolUse`/`PostToolUse`/`SessionStart`/`Stop` hooks wired via an inline `[hooks]` table in `config.toml`, plus `/prompts:*` markdown prompts under `$CODEX_HOME/prompts/` (YAML frontmatter, `$1`-`$9` placeholders) for the handoff flow and other repeatable operations.
+
+## Cheat sheet
+
+| Command | Effect |
+|---|---|
+| `codex-swap add <name>` | Create an isolated home under `~/.codex-accounts/<name>` and link shared config; log in to it with the printed `CODEX_HOME=... codex login` |
+| `codex-swap <name>` | Point `$CODEX_HOME` at that account's isolated store — **restart codex after** |
+| `codex-swap list` | Show registered accounts and which is active |
+| `/prompts:handoff` | Package this session's state; auto-injected on next launch |
+| `overcodex install` | (Re)install/refresh the kit — idempotent |
+| `overcodex uninstall` | Remove exactly what install added |
+| `overcodex path` | Print the bundled payload directory |
+
+Or skip memorizing and **paste a prompt**:
+
+| Paste into Codex CLI | Runs |
+|---|---|
+| "Hand off — context is filling up" | `/prompts:handoff` |
+| "Switch me to my work account" | walks you through `codex-swap work` + the restart |
+| "Install overcodex on this machine" | the whole install flow (works before the kit exists) |
+| "Upgrade overcodex and refresh the hooks" | `pipx upgrade overcodex && overcodex install` |
+
+## How it fits together
+
+```mermaid
+flowchart TD
+    AH[AGENTS.md routing policy] --> HK[config.toml hooks table: SessionStart/UserPromptSubmit/Stop]
+    HK --> PR[/prompts:handoff and friends]
+    PR --> CS[codex-swap: isolated CODEX_HOME per account]
+    CS --> RS[Cold restart adopts the new account]
+    SL[Statusline: get_context_remaining + native limit items] --> HK
+```
+
+<details>
+<summary>Caveats worth knowing</summary>
+
+- **Cold switch only.** `codex-swap` changes which `$CODEX_HOME` the shell points at; a session already running keeps reading its original `auth.json` until you quit and relaunch. There is no live/hot swap in this kit.
+- **Refresh-token isolation is the whole point.** Codex's refresh tokens can be single-use across copies of the same credential (open upstream bug reports) — so accounts are never file-swapped or symlinked into a shared `auth.json`. Each account's `CODEX_HOME` refreshes its own token in place, permanently separate from the others.
+- **Hooks run arbitrary shell on your events.** Review `hooks/*.sh` before installing on a machine you don't fully trust, same as any hook-based tool.
+- **Sessions are sqlite, not JSONL.** `experimental_thread_store` keeps history in `sqlite_home` (e.g. `logs_2.sqlite`) — `codex resume --last` / `codex resume <id>` read from there, not from plain log files.
+- Enterprise configs can set `allow_managed_hooks_only`, which blocks this kit's hooks from installing — check that first if hooks don't seem to load.
+
+</details>
+
+<details>
+<summary>Components (file → destination)</summary>
+
+| File | Installs to | Role |
+|---|---|---|
+| `bin/codex-swap` | `~/.local/bin/` | Cold account switcher: register, list, point `$CODEX_HOME` at an account |
+| `hooks/*.sh` | `$CODEX_HOME/hooks/` | SessionStart / UserPromptSubmit / Stop handlers |
+| `config/hooks-block.toml.tpl` | inline `[hooks]` table appended to `config.toml` (markers) | Hook wiring — only if no `hooks` key exists |
+| `codex/AGENTS-ULTRACODE.md` | appended to `$CODEX_HOME/AGENTS.md` (markers) | Model/effort routing policy |
+| `prompts/*.md` | `$CODEX_HOME/prompts/` | `/prompts:*` custom prompts (handoff, etc.) |
+
+| `shell/zshrc-snippet.sh` | `~/.zshrc` (markers) | `codex-swap` PATH/alias wiring |
+
+</details>
+
+<details>
+<summary>Maintainer workflow</summary>
+
+```bash
+./sync.sh            # live setup -> repo: scrub-gated diff, commit, push
+./sync.sh --release  # + version bump + GitHub release -> PyPI (trusted publishing)
+./sync.sh --dry-run  # preview either
+```
+
+A plain `git push` updates git installs only — **PyPI users get changes only via releases**. The scrub gate aborts any commit whose diff contains usernames, emails, or `/Users/…` paths. See `CLAUDE.md` for the full protocol.
+
+</details>
+
+## Credits
+
+overcodex is the Codex CLI sibling of **[overclaude](https://github.com/arthur-bump-pm/overclaude)** (same author, same packaging shape) — overclaude does hot account swapping for Claude Code; Codex CLI's credential model only allows a cold switch, so this kit is built around that constraint instead of hiding it.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

overcodex-0.1.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+overcodex/__init__.py,sha256=uqFDNvuj3hnFrYFReYhBTwWMqtvSgi6uu23L3dQgSZo,174
+overcodex/cli.py,sha256=NodCagAxNsoVE6eMv99VDIexVhb8ZdtFb5HsAdrDbZo,1760
+overcodex/payload/bin/codex-swap,sha256=xOfWIZAs4f4R7t42kZkRi-bp5cYuNeED5TJ1GfxeD2s,11064
+overcodex/payload/codex/AGENTS-ULTRACODE.md,sha256=nZQHXGZt4oK_MOxMESK0ZUG9eNz2TaQfmD0WpmOwb58,7208
+overcodex/payload/config/hooks-block.toml.tpl,sha256=iReCr3bCDufQKp4P9_xLvexI-1-pc0mdmixoPyCAcKk,1752
+overcodex/payload/hooks/overcodex-ctx-lib.sh,sha256=0PI7vBBkrZI_BUrNkW4HtvQSsSbX0e02gvy7MVHKNGM,3566
+overcodex/payload/hooks/overcodex-ctx-watch.sh,sha256=ESBPPepU1CQ0f1N2QS9RHMFCm4amuIyZUHxSLtYfi2o,3778
+overcodex/payload/hooks/overcodex-handoff-inject.sh,sha256=NqBRYgu8C-c_90tvEKeoIxW0Xck98esPVm_q7_QIluU,4090
+overcodex/payload/hooks/overcodex-notify.sh,sha256=juMhs2nZXt-BSSl5kKiZiRVKrfTPcW8v-V6ao0zhPa4,2305
+overcodex/payload/hooks/overcodex-precompact-offer.sh,sha256=AmYLKiqFhzZOgb7AvDQq0WFLcbIRXs77aMtPEgUjRsE,2035
+overcodex/payload/install.sh,sha256=LZTeO8LofhZnZ9oNRabYZ0pvDO9OCy07w7_UwOdYYss,16516
+overcodex/payload/prompts/handoff-cancel.md,sha256=wq8uzE2DuJFr66Q-F_i1pcb20lfBDUdyW_mLvmtft58,896
+overcodex/payload/prompts/handoff-status.md,sha256=lJjPjD5lWFKtC7IbM2cJkMk02q_UEpi1SMua3EIzLkI,1159
+overcodex/payload/prompts/handoff.md,sha256=16jGQZZxD2o7arcXrqFLuzquw-6j6jZHGnHYctHdyfs,3147
+overcodex/payload/shell/zshrc-snippet.sh,sha256=oVPWScR1R_N6hFw9AlwuisFqKqsxdN-CkgelwDDJZ1U,820
+overcodex/payload/uninstall.sh,sha256=c-47ippAHd-gBw-vuY1x0n1omf5IPpaOjz_TrhGklYk,7319
+overcodex-0.1.0.dist-info/METADATA,sha256=ct2D0y2avBcCwln5hYMB3BbjMS09Rb_9pYGXScHjJ8o,10041
+overcodex-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+overcodex-0.1.0.dist-info/entry_points.txt,sha256=uyDoJEO0G6nb_rorcnoyFAnSWP-hAoVW4tI-hgTMZxM,49
+overcodex-0.1.0.dist-info/licenses/LICENSE,sha256=s_6LxrkKh1cC6n7YVC7D1MYKifV_LdQoZ7medZNcCaA,1071
+overcodex-0.1.0.dist-info/RECORD,,

overcodex-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

overcodex-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+overcodex = overcodex.cli:main

overcodex-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 arthur-bump-pm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.