VS Code Extension to empower Antigravity IDE's Orchestrator Agents to manage Sub-Agents (Codex CLI, Claude Code CLI).
Antigravity SubAgents provides the infrastructure for Antigravity IDE to utilize specialized Sub-Agents. In Antigravity, multiple Main Agents can act as Orchestrators. This extension allows these Orchestrators to delegate tasks to Sub-Agents that execute via other CLI tools (Codex CLI or Claude Code CLI).
- Orchestration — Enables Main Agents in Antigravity to act as Orchestrators, intelligently delegating tasks.
- Sub-Agent Vendors — Create agents that run on Codex CLI or Claude Code CLI.
- Focused Execution — Sub-Agents are launched ONLY with their specific, narrow instructions. This ensures they stay focused on the task without the distraction of general chat history or conflicting directives.
- Real-time Logging — When a SubAgent runs, a Terminal window automatically opens showing formatted live output:
- Codex: Verbose stderr with thinking, tool calls, and execution logs
- Claude: JSONL session log parsed with colored formatting (💭 thinking, ⚡ tools, ✅ results)
- Orchestrator receives only the final answer to save tokens
- SubAgent Isolation — SubAgents are completely isolated from user's global configuration:
- Codex: Uses separate
CODEX_HOME(blocks~/.codex/AGENTS.md, preserves auth) - Claude: Runs with
--setting-sources ""(blocks allCLAUDE.mdfiles)
- Codex: Uses separate
- Multi-turn Conversations — SubAgents can ask clarifying questions; Orchestrator provides answers via
resume.sh - Auto-Routing — Automatically creates
.agent/rules/subagent-delegation-protocol.mdwith routing instructions for the Orchestrator. - Workflow Generation — Automatically generates Slash Commands for the Orchestrator:
- Global:
~/.gemini/antigravity/global_workflows/ - Project:
<project>/.agent/workflows/
- Global:
- Visual Editor — Rich VS Code UI to create and manage agents.
- Full Autonomy — Sub-Agents run with unsafe flags, giving them complete freedom to execute any operations without permission prompts.
Before using this extension, ensure you have the following installed and authenticated:
- Codex CLI: Required if you plan to use Codex-based Sub-Agents.
- Claude Code CLI: Required if you plan to use Claude-based Sub-Agents.
Both tools must be available in your system PATH and fully authenticated (logged in).
Download the latest .vsix release from Releases and install in VS Code:
- In VS Code:
Extensions→...→Install from VSIX... - Select the downloaded
.vsixfile
- Open SubAgent Manager from the Activity Bar (MsA icon).
- Create a new SubAgent (e.g., "Translator").
- Select Vendor:
CodexorClaude. - Define Triggers:
translate,перевод.
- Select Vendor:
- Deploy to Project (current workspace) or Global (system-wide).
- Use in Antigravity IDE:
- Auto: Just ask the Orchestrator "Translate this file..." -> It will route the task to your Sub-Agent.
- Manual: Use the generated slash command (e.g.,
/subagent-translator).
Name: translator
Vendor: Codex
Triggers: Translates text and/or files to the specified language
Instructions: |
You are a professional translator.
Translate the given text to the requested language.
Save translations next to the original files.Workflow:
- You ask the Orchestrator: "Translate README.md to Russian".
- The Orchestrator reads
GEMINI.mdand finds thetranslatoragent. - The Orchestrator delegates the task.
- The Sub-Agent starts with only the translator instructions, ensuring a perfect result.
~/.subagents/ # Global SubAgents Storage
├── manifest.json # Registry of deployed agents
└── {agent}/ # Agent Directory (Instructions & State)
~/.gemini/ # Antigravity Configuration
├── GEMINI.md # Auto-Routing Instructions
└── antigravity/global_workflows/ # Global Slash Commands
└── subagent-{name}.md
<ProjectRoot>/ # Project Configuration
├── .subagents/ # Project SubAgents
└── .agent/workflows/ # Project Slash Commands
└── subagent-{name}.md
MIT