@juanbenjumea/pi-agy

Enhanced fork of @bacnh85/pi-agy.

Delegates bulk work to the Antigravity CLI (agy) while Pi stays the conductor.

Install

pi install npm:@juanbenjumea/pi-agy

What's different from upstream 0.3.1

| Feature | Upstream | This fork | |---------|----------|-----------| | Live progress | Final text only | stream-json → Pi onUpdate cards | | Model aliases | Hardcoded ids | Live agy models catalog (newest stable generation wins; preview/experimental ignored), static map fallback | | Conversation resume | None | conversation_id, continue, session store, /agy sessions picker | | Verify injection | npm test only | just ci first, then npm test/uv run pytest | | Post-write summary | None | Appends git diff --stat for newly-dirty files only; pre-existing dirt is listed separately | | Preflight | Every call | Cached 5 min per process; also refreshes the model catalog | | Concurrency | Unlocked | Per-directory lock (in-process + filesystem, symlink-aware), lock wait counts against the timeout | | Transient failures | Fatal | One retry when agy fails before doing any work | | Cancellation | Direct child only | Full process-tree kill on cancel/timeout via detached process groups |

Auth is unchanged: existing agy OAuth (~/.gemini/oauth_creds.json).

Tool params (new)

| Param | Description | |-------|-------------| | conversation_id | Resume agy conversation by ID | | continue | --continue most recent conversation | | new_session | Force fresh session; set false to reuse last ID for dir | | effort | Reasoning effort via --effort (low/medium/high); mostly useful for sonnet/opus/gpt-oss since Gemini aliases encode effort in the model id | | stream | Use stream-json (default true) | | mode | accept-edits by default; use plan for exploration/review |

Human-callable /agy command

Run agy directly from the Pi TUI — fast path when fully specified, wizard otherwise:

/agy flash fix git conflicts        # fully specified → runs immediately
/agy plan sonnet review the diff    # mode + model + prompt
/agy plan                           # wizard: model select → task editor
/agy                                # wizard: mode → model → task editor
/agy continue fix the tests         # continue this directory's last conversation
/agy timeout=10m sonnet big task    # raise the run cap (also 90s / 1500ms; bare = minutes)
/agy sessions                       # pick a recorded conversation to resume

Leading option tokens (plan, a model alias, continue, timeout=…) are consumed in any order; the remainder is the prompt. /agy continue reuses the last model when the session store recorded one. timeout= caps at 10m.

First token optional: accept-edits / plan / sandbox mode prefix, then a model alias (flash, pro, sonnet, opus, gpt-oss, …), then the prompt. The interactive wizard and direct agy_execute calls default to accept-edits; the wizard confirms before writing. Use plan explicitly for exploration/review. Sandbox runs do not bypass agy permission checks.

Missing pieces open interactive dialogs (mode select, model select with descriptions, multi-line task editor). accept-edits asks for confirmation before writing. The command then runs agy directly with the selected parameters; progress is shown in the (throttled) status bar and the final response is notified — no second LLM turn or custom TUI surface.

Config

Optional $PI_CODING_AGENT_DIR/agy-config.json (default ~/.pi/agent/agy-config.json):

{
  "skipPermissions": true,
  "defaultModel": "flash-medium"
}

• skipPermissions (default true) — pass --dangerously-skip-permissions for accept-edits runs. Set false to leave agy's own permission checks in place; note print mode has no interactive approval path, so restricted operations may fail instead of prompting.
• defaultModel — alias used when agy_execute omits model/tier.
• defaultModelCommand — shell command whose stdout sets the default alias when defaultModel is unset (an explicit defaultModel always wins). Must print one valid alias; failures and invalid output fall back to the built-in default. Result cached ~5 min per process. Escape hatch for custom resolvers; prefer quotaBalancing below.
• quotaBalancing — steer the default across agy's quota families by recent usage balance: when the Gemini group (flash/pro) carried ≥75% of the last 24h of recorded conversations (min 3), the default flips to sonnet so routine delegation rests the hot group. Tune with AGY_DEFAULT_MODEL_WINDOW_HOURS, AGY_DEFAULT_MODEL_MIN_SESSIONS, and AGY_DEFAULT_MODEL_GEMINI_SHARE. Missing/corrupt stores mean no signal.

Tool results record permissions_skipped in details for auditability.

Live catalog resolution ignores preview/experimental model ids so an unstable entry can never silently become the default. Set PI_AGY_ALLOW_PREVIEW=1 to opt into preview ids explicitly.

Development

npm test
npm run typecheck

License

MIT