git:20261028.8540741 to git:20261028.3be1941
8 added, 0 removed. Audit A to A.
# codexbar-quota-handoff Development
## Local setup
From the repository root, run the only public setup entry point:
```bash
bash scripts/setup.sh --plugin codexbar-quota-handoff --threshold 0.9
```
In a terminal the script interactively installs the plugin into a selected
Claude Code, Codex, or Copilot runtime, then configures the host integration.
It detects and skips an existing plugin install. Pass `--local` to register
this checkout instead of the published GitHub source, or use `--runtime` and
`--yes` for non-interactive setup.
The root `scripts/upgrade.sh` and `scripts/uninstall.sh` use the same interactive
runtime/plugin-state flow. Upgrade refreshes the local integration; uninstall
removes it after the selected plugin-manager entry is removed.
Plugin-local `configure-host.sh`, `remove-host.sh`, and `remove-grok.sh` are
internal helpers and are not public lifecycle entry points. `remove-grok.sh`
drops leftover Grok hook files and the CodexBar grok rule without uninstalling
the plugin from other runtimes.
## Checks
From the repository root:
```bash
for test in tests/codexbar-quota-handoff-*.sh; do bash "$test"; done
mise run lint
```
The two marketplace manifests (`.claude-plugin/`, `.agents/plugins/`) must
continue to resolve to this shared plugin root; Copilot reuses the
Claude one, so there is no third. Grok Build is not a supported plugin
runtime: do not add `.grok-plugin/`. Configure removes leftover
`~/.grok/hooks/codexbar-quota-handoff.json` files from older installs so they
cannot claim the Claude flag.
The reminder's host detection depends on each runtime's hook identity variables
and the order they are tested in (`../../docs/agents/harnesses.md`).
+ ## Hooks: two files, two formats
+
+ `hooks.json` (plugin root) — **agy format**: named hook namespace (`"codexbar-quota-handoff"`)
+ with flat handler lists under `PreInvocation`. Injects `ephemeralMessage` via stdout JSON.
+
+ `hooks/hooks.json` — **Copilot/Claude Code format**: nested wrapper
+ (`Stop`, `PostToolUse`). Exits 2 with wrap-up procedure on stderr.
+