agyforclaude

Universal MCP server + Claude skill for delegating tasks to the Antigravity (Gemini) CLI.

agyforclaude installs an MCP server and a Claude skill into ~/.claude/, making it work with any AI client that supports Model Context Protocol — Claude Code, OpenCode, Cursor, Codex, and more.

Prerequisites

• Node.js >= 18
• Antigravity CLI (agy) — install it first

Install

npm install -g agyforclaude@latest

The postinstall hook automatically:

1. Checks if agy is installed
2. Appends agyforclaude to ~/.claude/mcp.json
3. Copies the agy skill to ~/.claude/skills/agy/SKILL.md

Then restart your AI agent to pick up the new MCP server.

Usage

Your AI agent now has an agy_delegation tool:

Param	Type	Default	Description
prompt	string	(required)	The task to delegate to Gemini
tier	flash / flash-lo / pro	flash	Model tier
dir	string[]	[]	Workspace directories to include
yolo	boolean	false	Auto-approve agy tool permissions
sandbox	boolean	false	Run agy in sandbox mode

Example prompts

• "Use agy to scaffold a Next.js app with TypeScript and Tailwind"
• "Delegate to Gemini: generate unit tests for src/utils.ts"
• "Use agy (pro tier) to review this PR for security issues"

The skill

The installed ~/.claude/skills/agy/SKILL.md reminds your agent:

• When to delegate (user asks, bulk work, cheap work)
• Always verify agy's output
• Never auto-merge

CLI Commands

After install, you also get agyforclaude on your PATH:

agyforclaude setup      # Re-run setup (e.g. after moving node_modules)
agyforclaude uninstall  # Remove from ~/.claude/ (also runs on npm uninstall)
agyforclaude status     # Check if everything is properly installed

How it works

• MCP Server (dist/mcp-server.js): Receives tool calls via stdio, spawns agy --print with the user's prompt, returns stdout.
• Skill (~/.claude/skills/agy/SKILL.md): Tells the AI when and how to use the agy_delegation tool.
• CLI (bin/agyforclaude): Manages installation/uninstallation of the above.

Dependencies

• @modelcontextprotocol/sdk — MCP server SDK
• agy (external) — The Antigravity CLI (must be installed separately)

License

MIT