Claude To Agy

claude-to-agy

[](https://github.com/rauls-kjarners/claude-to-agy/actions/workflows/ci.yml) [](https://github.com/rauls-kjarners/claude-to-agy/actions/workflows/codeql.yml) [](https://codecov.io/github/rauls-kjarners/claude-to-agy) [](https://badge.fury.io/py/claude-to-agy)

A lightweight MCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) - saving context window and tokens for what matters.

What It Does

Registers a delegate_to_agy MCP tool that Claude automatically uses when it encounters:

• Large files (>200 lines) - logs, dumps, generated code
• Multi-file analysis (>3 files at once)
• Deep searches - git log, git diff, grep
• Web lookups - documentation, external knowledge
• Adversarial review / plan critique - always delegated

Claude sends a prompt + file paths → the bridge runs agy CLI → returns the result.

Requirements

• Python 3.10+
• agy CLI installed and authenticated
• Claude Code

Installation

> Note: The command below uses uvx to run the server without manual installation. If you don't have uv installed, you can substitute uvx with npx -y or pipx run.

# 1. Register the MCP server globally via uvx
claude mcp add -s user claude-to-agy uvx claude-to-agy

# 2. Download the delegation rules into your current project
curl -o CLAUDE.md https://raw.githubusercontent.com/rauls-kjarners/claude-to-agy/main/CLAUDE.md

That's it. Claude will now automatically delegate heavy tasks to Antigravity CLI in any project that has the CLAUDE.md file.

> Tip: To enable globally without copying CLAUDE.md per project, add the rules to ~/.claude/CLAUDE.md instead.

Using as a Skill

This project also includes a SKILL.md file, which is the standard format for reusable Claude Code skills. If your setup supports skills, you can use it instead of manually copying CLAUDE.md:

claude skill add https://raw.githubusercontent.com/rauls-kjarners/claude-to-agy/main/SKILL.md

> Note: You still need the MCP server registered (step 1 above). The skill provides the rules, MCP provides the tool.

Configuration

All settings are optional environment variables:

| Variable | Default | Description | | --------------------- | ------- | --------------------------------- | | AGY_CONNECT_TIMEOUT | 60 | Seconds to start the agy process | | AGY_TOTAL_TIMEOUT | 1200 | Hard timeout for entire execution |

How It Works

User → Claude Code → MCP bridge (FastMCP) → agy CLI → Gemini API
                   ←                      ←         ←

1. CLAUDE.md instructs Claude when to delegate
2. Claude calls delegate_to_agy(prompt, cwd, files?) via MCP
3. bridge.py prepends file paths to the prompt
4. Runs agy --dangerously-skip-permissions --add-dir -p ""
5. Returns the text output cleanly or raises an exception natively handled by FastMCP

Development

# Linting & Formatting
uv run ruff check .
uv run ruff format .

# Type Checking
uv run pyright

# Tests
uv run pytest

# Pre-commit Hooks (Run before committing)
uv run pre-commit install

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: rauls-kjarners
• Source: rauls-kjarners/claude-to-agy
• License: MIT

Install and usage instructions live in the source repository linked above.