Add Antigravity (agy) subagent management system via tmux - #304
Draft
dandye wants to merge 2 commits into
Draft
Conversation
Implements a comprehensive tmux-based subagent orchestration system that enables running multiple Antigravity (agy) instances in parallel for complex workflows. Key features: - spawn: Create new agy subagents in detached tmux sessions - send: Send messages to running subagents with intelligent handling of: - Regular prompts (literal text with double Enter submission) - Shell commands (starting with !, single Enter execution) - Slash commands (/help, /model, etc.) - get-output: Retrieve subagent output with configurable line limits - list: View all active subagent sessions with simple or detailed format - kill: Terminate subagent sessions cleanly - attach: Instructions for interactive session viewing - status: Debug and monitor subagent health - spawn-split: Create subagents in split panes - broadcast: Send messages to multiple subagents simultaneously Technical implementation: - Uses tmux sessions to maintain persistent agy instances - Starts bash shell first, then launches agy to ensure session stability - 5-second initialization delay to allow agy startup sequence - Intelligent message routing based on content prefix detection - Literal text mode (-l flag) for regular prompts to prevent shell interpretation This enables advanced use cases like parallel research tasks, distributed analysis, and multi-agent coordination workflows.
dandye
marked this pull request as draft
September 2, 2026 14:16
Enables native Antigravity CLI (/subagent) discovery and autocompletion in addition to legacy .gemini/commands/subagent.toml.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Implements a comprehensive tmux-based subagent orchestration system for Antigravity CLI (
agy), superseding and refactoring #146.Provides both:
.agents/skills/subagent/SKILL.md&.gemini/skills/subagent/SKILL.md): Discovered natively byagyas the/subagentslash command with full autocompletion and execution runbooks..gemini/commands/subagent.toml): Refactored to invokeagyfor Gemini CLI backwards compatibility.Key Features
spawn: Create newagysubagents in detached tmux sessions with configurable models and initial promptssend: Send messages to running subagents with intelligent handling for:!, single Enter execution)/help,/model, etc.)get-output: Retrieve subagent output with configurable line limits or full historylist: View all active subagent sessions in simple or detailed formatkill: Cleanly terminate subagent sessionsattach: Provides instructions for interactive session attachmentstatus: Debug and monitor subagent health and activityspawn-split: Create subagents in split panes for side-by-side operation (agy -p '...')broadcast: Send messages to multiple subagents simultaneouslyTechnical Implementation
agyinstances that survive main process exitsagyto ensure session stabilityagystartup sequenceC-m) matchingagyinteractive input submissiontmux send-keyswith-lflag for literal text to prevent unintended shell interpretationCloses #146