agy-staff

English | Simplified Chinese

Hire Google's Antigravity CLI (agy) as a staffer for Claude Code, OpenAI Codex, Pi, and OpenCode.

Install · Examples · Core design · Upgrade

What & Why

agy-staff lets your senior agents delegate to agy, which ships fast Gemini 3.8 Flash. Five personas: staffer (general-purpose), researcher, reviewer (code and plans/decisions), implementer, and ask — plus a model-facing jobs skill. Claude Code uses /agy: and Codex uses $agy:.

If you use Codex you know the feeling: GPT-5.6-Sol is slow even with fast mode on. Claude Code is quicker but still not fast, and Fable quota is scarce enough that you want it orchestrating subagents, not grinding through every survey and review itself. An agy worker gives you a fast lane — second opinions in seconds, research and reviews at Flash speed, scoped implementation handled off to the side while you keep moving. And where speed isn't the point, a second model family looking at the same code buys coverage and robustness your main agent can't give itself.

How

Invoke a persona

Type /agy: in Claude Code and the five personas are right there:

Same plugin in Codex, invoked with $agy:

Install

For humans

Step 1 — install the Antigravity CLI (official docs), then verify with agy --version. Node.js is also required:

curl -fsSL https://antigravity.google/cli/install.sh | bash

Step 2 — install the plugin into your harness:

claude plugin marketplace add keli-wen/agy-staff
claude plugin install agy@agy-staff

codex plugin marketplace add https://github.com/keli-wen/agy-staff
codex plugin add agy@agy-staff

Using Pi?

Install: pi install git:github.com/keli-wen/agy-staff. Skills are prefixed as /skill:agy- (e.g. /skill:agy-ask reply with OK), with /skill:agy-jobs for job management. Update with pi update --extension git:github.com/keli-wen/agy-staff, then run /reload.

Using OpenCode?

With OpenCode V1 (verified on 1.18.34), install the package through its native plugin manager:

opencode plugin 'agy-staff@git+https://github.com/keli-wen/agy-staff.git' --global

Restart OpenCode, then run /agy-ask reply with OK. The plugin automatically registers all seven agy-* skills and their native slash commands, including /agy-lead and /agy-jobs. No separate skills path or command wrappers are needed. Node.js and an authenticated agy are required, as above.

OpenCode caches the complete package spec. Restarting does not refresh an unchanged Git spec. To upgrade, choose a newer Git tag or commit and run opencode plugin 'agy-staff@git+https://github.com/keli-wen/agy-staff.git#<tag-or-commit>' --global --force, then restart. See the reference for config and local development. OpenCode V2 is not covered by this adapter.

Restart Claude Code or Codex afterwards. First run: /agy:ask reply with OK (Claude Code) or $agy:ask reply with OK (Codex). Ask is tool-free and needs no setup.

[!IMPORTANT] There is no mandatory setup step. staffer, researcher, reviewer and implementer run unrestricted by default: agy can inspect the repo, run commands, and edit files. agy-staff keeps that practical with prompts that adapt to the current repo state. For example, when implementer starts in a dirty workspace, the companion tells agy which files already had changes and reminds it not to overwrite or deliver unrelated user work. If the task asks for a commit, push, or PR, agy can do that delivery; otherwise it leaves a working-tree diff for review. These prompt instructions do not provide permission isolation. setup + --restricted is optional hardening for untrusted input — per run (--restricted) or as a per-repo default (setup --restrict review,research). setup dry-runs and asks before writing anything ("set up agy" triggers it); read the permission notes first — the allowlist is prefix-matched, applies machine-wide, and a restricted run can return less than an unrestricted one.

For agents

Paste this into any coding agent:

Read the raw text of https://raw.githubusercontent.com/keli-wen/agy-staff/master/docs/INSTALL_FOR_AGENTS.md (curl it — do not
work from a summary) and follow it to install and verify the agy-staff plugin for the harness you are running in.
Respond in the user's language.

Upgrade

Claude Code and Codex install a copy, so a new version only reaches you when you pull it in yourself:

claude plugin marketplace update agy-staff && claude plugin update agy@agy-staff

codex plugin marketplace upgrade && codex plugin add agy@agy-staff  # then restart Codex

Claude Code and Codex cache per version directory, so an upgrade lands only if the plugin version changed; restart the harness afterwards. If a fix does not show up, see upgrading — it has the force-refresh command.

CUJs

Examples below use Claude Code's /agy:…; in Codex use $agy:…, in Pi /skill:agy-…, and in OpenCode /agy-….

Use case	Invocation
Lead an ongoing task	/agy:lead investigate the options, draft a proposal, and revise it with my feedback
Quick second opinion	/agy:ask what's your backend model
A general task	/agy:staffer summarize the open TODOs in this repo
Generate an image	/agy:staffer generate a pixel-art robot mascot, save it as assets/mascot.png
Review the working tree	/agy:reviewer Review the current working tree
Review a PR	/agy:reviewer Review PR #730
Review a plan or decision	/agy:reviewer Challenge the migration plan in docs/plan.md
Survey a topic	/agy:researcher how does auth work in this repo
Implement a scoped fix	/agy:implementer fix the flaky retry test