Connect Antigravity
Add the Piyaz MCP server to Antigravity and install the bundled workflow plugin.
Piyaz is hosted at app.piyaz.ai. The plugin installs into Antigravity once, at the user level, and works in every project you open. No clone required. Add the MCP server, then authenticate (Antigravity handles OAuth automatically, once per machine).
Add the MCP server
Add the Piyaz MCP server to your global config. The IDE and the CLI share one config at ~/.gemini/config/mcp_config.json (in the IDE: MCP Store → Manage MCP Servers → View raw config):
{
"mcpServers": {
"piyaz": { "serverUrl": "https://app.piyaz.ai/api/mcp" }
}
}Authenticate and install the skills
Run /mcp (CLI) or open the MCP manager (IDE) and Authenticate. Antigravity handles OAuth automatically.
The workflow skills ship as a bundled plugin. Clone this repo and copy plugins/antigravity/ into ~/.gemini/config/plugins/ (global) or .agents/plugins/ at your workspace root. The bundled mcp_config.json declares the hosted piyaz server; self-hosters add their own alongside it.
Verify
Ask Antigravity:
/piyaz List my projects.Antigravity returns your project list. An empty list is expected on a fresh account.
Antigravity replaces Gemini CLI (consumer access ended 2026-06-18). Run agy plugin import gemini to migrate, then use the Antigravity setup above.
Self-host
The plugin ships one MCP server, piyaz, pointing at the hosted app. To use your own server, start it and add a second entry to ~/.gemini/config/mcp_config.json, or %USERPROFILE%\.gemini\config\mcp_config.json on Windows. Use .agents/mcp_config.json at your workspace root to scope the server to that workspace.
Merge the entry into the existing mcpServers object rather than replacing the file:
{
"mcpServers": {
"piyaz-self-hosted": { "serverUrl": "http://localhost:3000/api/mcp" }
}
}Remote servers must use serverUrl. Antigravity does not accept url or httpUrl. Swap http://localhost:3000 for your own origin if you run Piyaz elsewhere, and serve it over HTTPS unless it is on localhost.
Restart Antigravity afterwards, then run /mcp and Authenticate against piyaz-self-hosted. For running the server itself, see the self-host guide.
What gets installed
- The 9 MCP tools that give your agent direct access to the project graph. See the MCP overview.
- The
/piyazskill. - The workflow skills: brainstorm, decompose, decompose-feature, decompose-task, manage, onboarding, and review.
composer (end-to-end task orchestration) and the dispatchable agents are Claude Code only. Antigravity ships the skills above and runs each phase inline. For the composer loop, use Claude Code.
Last updated