🛰️ subvibe — subagent delegation marketplace

Grown out of antigravity-for-claude-code: a robust delegation wrapper, background jobs, and routing/cost discipline — packaged as a marketplace with two plugins (pick your executor at install time) for both Codex and Claude Code.

you → Codex / Claude Code (conduct: design / verify / review)
         ├── agy-plugin  → agy  (Gemini Flash — lower-intelligence / high-volume)
         └── grok-plugin → grok (Grok Build — stronger reasoning bulk work)

Generation is solved; verification, judgement, and direction are the craft.

• Two plugins, one marketplace — install only the executor you use, or both and let the conductor route.
• Routes work across the SDLC — the conductor keeps the judgement calls (including all code review); the executor handles scaffolding, test generation, and migrations.
• Background jobs — fire a long delegation with agy-job / grok-job, keep working, collect later.
• Built-in cost discipline — --digest output contracts, dump-size warnings, break-even guidance.
• Policy injected automatically — each plugin's SessionStart hook injects its docs/AGENTS-snippet.md (routing policy + verification gates).

If both are installed there is no SUBVIBE_DRIVER switch — the agent chooses which skill/wrapper to call per task.

Codex

codex plugin marketplace add zicjin/subvibe

Then inside Codex run /plugins, pick the subvibe marketplace.

Claude Code

/plugin marketplace add zicjin/subvibe

Codex — from the subvibe marketplace install agy-plugin and/or grok-plugin.

Claude Code

/plugin install agy-plugin@subvibe
/plugin install grok-plugin@subvibe

Each plugin gives you:

• Skills — e.g. agy-delegate / grok-delegate, research, jobs, setup, prompting
• SessionStart hook — injects that plugin's routing policy
• Scripts — scripts/*-delegate.sh, *-job.sh, doctor.sh (invoked by path; no PATH setup)

Prerequisites: the matching executor CLI authenticated — agy and/or grok — plus Codex CLI or Claude Code.

Platform support: macOS, Linux, and WSL. Native Windows is not recommended for headless executor CLIs (ConPTY / unauth hangs); wrappers use a wall-clock timeout/gtimeout guard.

Code review is not delegated.

Background jobs are for interactive sessions. In headless one-shot runs, delegate synchronously.

# agy-plugin
agy-delegate --tier medium --dir . --digest "Map the auth flow"
ID=$(agy-job start --tier high --dir . "big task"); agy-job result "$ID"

# grok-plugin
grok-delegate --tier high --dir . --yolo "Implement the parser module"

Remap with GROK_TIER_* / AGY_TIER_*, or SUBVIBE_DEFAULT_MODEL / --model. Other knobs: SUBVIBE_DEFAULT_TIER, SUBVIBE_TIMEOUT, SUBVIBE_DIGEST_WARN_CHARS.

Guardrails

• Always verify the executor's output.
• --yolo auto-approves tool calls — use with --sandbox or a throwaway dir.
• Write tasks: dedicated branch/worktree; review the diff.

Known limits

• Writes need --yolo (headless executors may only describe edits otherwise).
• Native Windows: headless agy / unauthenticated grok can hang — wall-clock guard returns TIMEOUT (12). Prefer WSL/macOS/Linux.
• WSL: agy --add-dir on /mnt/c/... is slow (9p); keep repos on the Linux FS.

.agents/plugins/marketplace.json   Codex marketplace (agy-plugin + grok-plugin)
.claude-plugin/marketplace.json    Claude Code marketplace (same two plugins)
plugins/agy-plugin/                installable unit: Antigravity/Gemini
plugins/grok-plugin/               installable unit: Grok Build
scripts/                           core templates + _gen_plugins.py (dev only)
docs/drivers.md                    packaging + how to add another executor
tests/                             bash tests/run-tests.sh

bash tests/run-tests.sh
# after editing scripts/ templates:
python scripts/_gen_plugins.py