# agyforclaude

> Universal MCP server + Claude skill for delegating tasks to the [Antigravity](https://antigravity.google) (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

```bash
npm install -g agyforclaude@latest
```

**The postinstall hook automatically:**
1. Checks if `agy` is installed
2. Configures the MCP server in `~/.claude/mcp.json` (Claude Code)
3. Configures the MCP server in `~/.config/opencode/opencode.json` (OpenCode)
4. Copies the `agy` skill to `~/.claude/skills/agy/SKILL.md`

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

> **Other agents** (Cursor, Codex, Windsurf, etc.): MCP config is not automated. You'll need to manually add the server entry per your agent's docs. The server binary is at `dist/mcp-server.js` inside the agyforclaude package — find it with `npm root -g`.

## 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 |
| `timeout` | `number` | `300` | Max seconds for agy to complete (30-600). Default matches agy's built-in timeout. Increase for very large tasks. |

### 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:

```bash
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
agyforclaude -p "prompt" [options]  # Delegate a task directly from the command line
```

### Options for Prompt Delegation:
- `-p`, `--prompt <string>`: The task prompt to send to Gemini (required)
- `-t`, `--tier <tier>`: Model tier: `flash` (default), `flash-lo`, `pro`
- `-d`, `--dir <dir>`: Additional workspace directory to include (can be repeated)
- `-y`, `--yolo`: Auto-approve tool permissions (dangerous)
- `-s`, `--sandbox`: Run agy in sandbox mode
- `--timeout <seconds>`: Max seconds to wait (default: 300)

## 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