feat: Antigravity IDE support for MCP servers and skills (#2571)
- Add .antigravity/mcp_config.json with agent-builder and tools MCP servers - Add .antigravity/skills/ with symlinks to .claude/skills/ (5 skills) - Add docs/antigravity-setup.md with setup and troubleshooting - Update README.md with Antigravity IDE support section - Update DEVELOPER.md and docs/contributing-lint-setup.md with Antigravity refs Mirrors Cursor integration for consistent multi-IDE support.
This commit is contained in:
himanshu748
committed by
Richard Tang
Richard Tang
parent
c9f9eb365c
commit
8ff6b76f37
@@ -0,0 +1,20 @@
|
||||
{
|
||||
"mcpServers": {
|
||||
"agent-builder": {
|
||||
"command": "python",
|
||||
"args": ["-m", "framework.mcp.agent_builder_server"],
|
||||
"cwd": "core",
|
||||
"env": {
|
||||
"PYTHONPATH": "../tools/src"
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"command": "python",
|
||||
"args": ["mcp_server.py", "--stdio"],
|
||||
"cwd": "tools",
|
||||
"env": {
|
||||
"PYTHONPATH": "src"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
+1
@@ -0,0 +1 @@
|
||||
../../.claude/skills/agent-workflow
|
||||
@@ -0,0 +1 @@
|
||||
../../.claude/skills/building-agents-construction
|
||||
@@ -0,0 +1 @@
|
||||
../../.claude/skills/building-agents-core
|
||||
@@ -0,0 +1 @@
|
||||
../../.claude/skills/building-agents-patterns
|
||||
+1
@@ -0,0 +1 @@
|
||||
../../.claude/skills/testing-agent
|
||||
@@ -133,6 +133,18 @@ The agent has access to all Hive skills and can scaffold agents, add tools, and
|
||||
|
||||
**[📖 Complete Setup Guide](docs/environment-setup.md)** - Detailed instructions for agent development
|
||||
|
||||
### Antigravity IDE Support
|
||||
|
||||
Skills and MCP servers are also available in [Antigravity IDE](https://antigravity.google/) (Google's AI-powered IDE). To enable:
|
||||
|
||||
1. Open the project in Antigravity IDE (repo root as project root)
|
||||
2. In the agent panel, open **Manage MCP Servers** and use **View raw config**
|
||||
3. Point Antigravity to `.antigravity/mcp_config.json` (or merge its contents into your user `mcp_config.json` and set `cwd` to your repo paths)
|
||||
4. Restart or reload MCP so the **agent-builder** and **tools** servers connect
|
||||
5. Skills are available under `.antigravity/skills/` (symlinks to `.claude/skills/`)
|
||||
|
||||
See [docs/antigravity-setup.md](docs/antigravity-setup.md) for full setup and troubleshooting.
|
||||
|
||||
## Features
|
||||
|
||||
- **[Goal-Driven Development](docs/key_concepts/goals_outcome.md)** - Define objectives in natural language; the coding agent generates the agent graph and connection code to achieve them
|
||||
|
||||
@@ -0,0 +1,102 @@
|
||||
# Antigravity IDE Setup
|
||||
|
||||
This guide explains how to use Aden's agent building tools and skills in [Antigravity IDE](https://antigravity.google/) (Google's AI-powered IDE).
|
||||
|
||||
## Overview
|
||||
|
||||
The repository includes Antigravity IDE support so you can:
|
||||
|
||||
- Use the **agent-builder** MCP server to create and manage agents
|
||||
- Use the **tools** MCP server for file operations, web search, and other agent capabilities
|
||||
- Load and use **skills** for guided agent development (workflow, building, testing)
|
||||
|
||||
Configuration lives in `.antigravity/` and mirrors the Cursor integration for consistency.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- [Antigravity IDE](https://antigravity.google/) installed
|
||||
- Python 3.11+ with the framework and tools installed (run `./scripts/setup-python.sh` from the repo root)
|
||||
- Repository cloned and set up (see [ENVIRONMENT_SETUP.md](../ENVIRONMENT_SETUP.md))
|
||||
|
||||
## MCP Configuration
|
||||
|
||||
MCP servers are configured in `.antigravity/mcp_config.json`:
|
||||
|
||||
| Server | Description |
|
||||
|-----------------|--------------------------------------|
|
||||
| **agent-builder** | Agent building MCP server (goals, nodes, edges, export) |
|
||||
| **tools** | Hive tools MCP server (19 tools for agent capabilities) |
|
||||
|
||||
Both servers use stdio transport and run from the repo with the correct `PYTHONPATH`.
|
||||
|
||||
## Setup Steps
|
||||
|
||||
### 1. Enable MCP in Antigravity
|
||||
|
||||
1. Open Antigravity IDE and open this repository as the project.
|
||||
2. Open the MCP / agent panel (e.g. via the "..." dropdown in the agent area).
|
||||
3. Go to **Manage MCP Servers** (or equivalent).
|
||||
4. Use **View raw config** (or open the config file) so Antigravity uses the project config.
|
||||
|
||||
Antigravity can load MCP config from the project. Point it to `.antigravity/mcp_config.json` or copy its contents into Antigravity’s `mcp_config.json` if the IDE expects a single global/user config file.
|
||||
|
||||
### 2. Load project MCP config
|
||||
|
||||
- If Antigravity supports **project-level** MCP config, ensure the project root is the repo root so `.antigravity/mcp_config.json` is used.
|
||||
- If it only supports a **user-level** config, merge the contents of `.antigravity/mcp_config.json` into your user `mcp_config.json`, and adjust `cwd` paths so they are absolute paths to this repo’s `core` and `tools` directories (e.g. `/path/to/hive/core` and `/path/to/hive/tools`).
|
||||
|
||||
### 3. Restart or reload
|
||||
|
||||
Restart Antigravity or reload MCP servers so the agent-builder and tools servers are connected.
|
||||
|
||||
### 4. Use skills
|
||||
|
||||
Skills are in `.antigravity/skills/` (symlinks to `.claude/skills/`). If Antigravity has a skill/context loader that reads from the project, it can use these. Otherwise, you can reference the same guides under `.claude/skills/` when working in the IDE.
|
||||
|
||||
Available skills:
|
||||
|
||||
- **agent-workflow** – End-to-end workflow for building and testing agents
|
||||
- **building-agents-core** – Core concepts for goal-driven agents
|
||||
- **building-agents-construction** – Step-by-step agent construction
|
||||
- **building-agents-patterns** – Patterns and best practices
|
||||
- **testing-agent** – Goal-based evaluation and testing
|
||||
|
||||
## Directory layout
|
||||
|
||||
```
|
||||
.antigravity/
|
||||
├── mcp_config.json # MCP server config (agent-builder, tools)
|
||||
└── skills/ # Symlinks to .claude/skills/
|
||||
├── agent-workflow
|
||||
├── building-agents-core
|
||||
├── building-agents-construction
|
||||
├── building-agents-patterns
|
||||
└── testing-agent
|
||||
```
|
||||
|
||||
Skills are symlinked so updates in `.claude/skills/` are reflected in Antigravity without extra copies.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### MCP servers do not connect
|
||||
|
||||
- Confirm Python and dependencies are installed: from repo root run `./scripts/setup-python.sh`.
|
||||
- From repo root, run:
|
||||
- `cd core && python -m framework.mcp.agent_builder_server` (Ctrl+C to stop)
|
||||
- `cd tools && PYTHONPATH=src python mcp_server.py --stdio` (Ctrl+C to stop)
|
||||
- If Antigravity uses a user-level `mcp_config.json`, ensure `cwd` and paths point to this repo’s `core` and `tools` directories (use absolute paths if needed).
|
||||
|
||||
### "Module not found" or import errors
|
||||
|
||||
- Ensure you open the repo **root** as the project so `cwd` and `PYTHONPATH` in `mcp_config.json` resolve correctly.
|
||||
- If you copied config to a user file, set `cwd` to the absolute path of `core` or `tools` and keep `PYTHONPATH` as in `.antigravity/mcp_config.json` (relative to that `cwd`).
|
||||
|
||||
### Skills not visible
|
||||
|
||||
- Antigravity may not have a built-in “skills” UI like Cursor. Use the content under `.claude/skills/` (or `.antigravity/skills/`) as reference documentation while using the MCP tools in the IDE.
|
||||
|
||||
## See also
|
||||
|
||||
- [Cursor IDE support](../README.md#cursor-ide-support) – Same MCP servers and skills for Cursor
|
||||
- [MCP Integration Guide](../core/MCP_INTEGRATION_GUIDE.md) – Framework MCP details
|
||||
- [Environment setup](../ENVIRONMENT_SETUP.md) – Repo and Python setup
|
||||
@@ -102,6 +102,10 @@ The repository includes a `.claude/settings.json` hook that automatically runs `
|
||||
|
||||
The `.cursorrules` file at the repo root tells Cursor's AI the project's style rules (line length, import order, quote style, etc.) so generated code follows convention.
|
||||
|
||||
### Antigravity IDE
|
||||
|
||||
Antigravity IDE (Google's AI-powered IDE) is supported via `.antigravity/mcp_config.json` and `.antigravity/skills/` (symlinks to `.claude/skills/`). See [antigravity-setup.md](antigravity-setup.md) for setup and troubleshooting.
|
||||
|
||||
---
|
||||
|
||||
## CI Pipeline
|
||||
|
||||
@@ -215,6 +215,7 @@ hive/ # Repository root
|
||||
├── scripts/ # Utility scripts
|
||||
│ └── auto-close-duplicates.ts # GitHub duplicate issue closer
|
||||
│
|
||||
├── .antigravity/ # Antigravity IDE: mcp_config.json + skills (symlinks)
|
||||
├── quickstart.sh # Interactive setup wizard
|
||||
├── README.md # Project overview
|
||||
├── CONTRIBUTING.md # Contribution guidelines
|
||||
|
||||
Reference in New Issue
Block a user