Antigravity Link (antigravity-link) 🤖⚡🤖

The Official Peer AI Collaboration & Tandem Sync Plugin for Google Antigravity (AGY).
Connects remote Antigravity AI agents across Linux and Windows for live pair-programming, tandem vibecoding, cryptographic conflict prevention, and autonomous cross-machine task execution.

---

🌟 What is Antigravity Link?

When two developers pair-program on separate machines across the internet, their respective AI coding assistants typically have zero awareness of each other. This leads to:

• Overwritten Code: Both AIs editing the same file simultaneously, causing massive git merge conflicts.
• Platform Blindspots: A Linux AI cannot compile WinMM/DirectInput or test Windows batch scripts; a Windows AI cannot test systemd or evdev drivers.
• Context Fragmentation: Manual copy-pasting of test logs, terminal outputs, and system specs between team members.

Antigravity Link solves this completely. It plugs directly into Antigravity (AGY CLI, Antigravity IDE, PyCharm, VS Code) as a native customization plugin, creating an encrypted background bridge where both AI agents work in tandem.

+------------------------------------+             +------------------------------------+
|       Lead Node (Linux / macOS)    |             |      Contributor Node (Windows)    |
|   Ubuntu 24.04 LTS / Unix          |             |         Windows 10 / 11 Native     |
|                                    |             |                                    |
|   +----------------------------+   |             |   +----------------------------+   |
|   |    Antigravity AGY TUI     |   |             |   |    Antigravity AGY TUI     |   |
|   |   /link, /peer, /inbox     |   |             |   |   /link, /peer, /inbox     |   |
|   +--------------+-------------+   |             |   +--------------+-------------+   |
|                  |                 |             |                  |                 |
|   +--------------v-------------+   |             |   +--------------v-------------+   |
|   |     PreInvocation Hook     |   |             |   |     PreInvocation Hook     |   |
|   |   PreToolUse Conflict Gate |   |             |   |   PreToolUse Conflict Gate |   |
|   +--------------+-------------+   |   Cloud     |   +--------------+-------------+   |
|                  |                 |   Relay     |                  |                 |
|   +--------------v-------------+   |  HTTPS/443  |   +--------------v-------------+   |
|   |    agy_link.py Companion   |<===================>|    agy_link.py Companion   |   |
|   |    HMAC-SHA256 Signed      |   (ntfy.sh /    |   |    HMAC-SHA256 Signed      |   |
|   +----------------------------+   |    TCP)     |   +----------------------------+   |
+------------------------------------+             +------------------------------------+

---

⚡ Key Capabilities

1. Strict AGY TUI Isolation: All peer interactions, task summaries, status updates, and reports render directly inside your existing AGY terminal session. Zero external terminal popups.
2. Cryptographic Conflict Prevention: When one AI is working on a file, it broadcasts an active lock. If the other AI attempts to modify that file, the plugin's PreToolUse hook intercepts the action and requires owner confirmation.
3. Autonomous Task Summoning (@ai): Dispatch tasks to the remote peer AI on demand. The remote AI executes the prompt locally, collects the logs/diffs, and delivers a structured report back to your session.
4. Human-in-the-Loop (HITL) Security Gate: Incoming remote task summons trigger a native OS modal dialog (zenity on Linux, MessageBox on Windows) before executing, preventing unauthorized remote code execution.
5. HMAC-SHA256 Packet Integrity: Every message, diff, and state update is cryptographically signed using a shared room key. Spoofed or tampered packets are automatically dropped.
6. Zero-Pip Axiom: 100% Python Standard Library (ctypes, hmac, hashlib, urllib, socket). No pip install, no virtualenv activation, zero bloat.

---

🚀 Quick Start (1-Line Installation)

Install the Antigravity Link plugin, agent skills, and terminal CLI tool with a single command:

curl -fsSL https://raw.githubusercontent.com/ImNotMrReaper/antigravity-link/main/install.sh | bash

Option 2: Manual Installation via AGY Plugin CLI

git clone https://github.com/ImNotMrReaper/antigravity-link.git ~/.gemini/config/plugins/antigravity-link
agy plugin install ~/.gemini/config/plugins/antigravity-link

Option 3: Project-Level Tandem Sync

git clone https://github.com/ImNotMrReaper/antigravity-link.git .agents/plugins/antigravity-link

What happens automatically:

• Automatic Lifecycle: Antigravity launches mcp_server.py on session start; the background listener and cloud relay automatically activate without any external daemons or manual script execution.
• Embedded Web Dashboard: Visit http://127.0.0.1:7891 (or use PyCharm's built-in View -> Tool Windows -> Web Browser) for real-time mesh telemetry.
• Conflict Prevention: Hooks intercept concurrent file modifications, prompting for confirmation before conflicts occur.
• Verification: Run agy plugin validate ~/.gemini/config/plugins/antigravity-link.

---

🧩 Official Plugin Components

The plugin conforms 100% to the Google Antigravity Plugin Specification:

Component	Path	Description
Skills	skills/agy-link/SKILL.md	Provides the agent with full operating rules, delegation CLI commands, and synchronization runbooks.
Agents	agents/peer-ai.md agents/senpai-ai.md	Remote peer AI and Windows Lead subagents for autonomous cross-machine handoffs.
Commands	commands/link.md commands/peer.md commands/senpai.md commands/inbox.md	Native AGY slash commands (/link, /peer, /senpai, /inbox) directly inside the chat interface.
MCP Server	mcp_server.py mcp_config.json	Exposes 7 stdio tools: link_status, link_summon, link_send, link_sync, link_inbox, link_open, link_gui.
Lifecycle Hooks	hooks.json hooks/pre_invocation_sync.py hooks/pre_tool_guard.py	PreInvocation injects active peer locks into turn context; PreToolUse blocks concurrent writes to locked files.

Verify anytime with:

agy plugin validate ~/.gemini/config/plugins/antigravity-link

Output:

  [ok]    ~/.gemini/config/plugins/antigravity-link
          ✔ skills      : 1 processed
          ✔ agents      : 2 processed
          ✔ commands    : 4 processed (converted to skills)
          ✔ mcpServers  : 1 processed
          ✔ hooks       : 1 processed

---

📖 Day-to-Day Workflow (Zero-Touch)

Antigravity Link is completely hands-off—no background terminal scripts or system services required. Everything executes directly inside your Antigravity chat:

1. Zero-Touch Startup: Open your project in PyCharm and run agy. Antigravity spawns mcp_server.py, which silently activates background transport listeners (Direct TCP and Cloud Relay).
2. Check Status (/link status): Instantly view connection health, active locks, and remote station telemetry.
3. Peer Messaging (/link send <message>): Dispatch technical notes directly to your partner's IDE session with native OS desktop alerts.
4. Remote Task Delegation (/peer <task>): Dispatch cross-platform validation or compile jobs. The remote machine owner confirms via native OS security prompt ([Yes / No]), and results stream directly back to your chat.
5. Conflict Prevention: Tell your AI "Lock file.py while I work on this feature". If the remote AI tries to touch the file, Antigravity's PreToolUse hook intercepts and blocks the write.
6. Embedded PyCharm Dashboard (/link gui): Dock http://127.0.0.1:7891 in PyCharm's built-in Web Browser tool window (View -> Tool Windows -> Web Browser) for real-time telemetry and one-click file navigation.

---

💬 AGY TUI Commands & Slash Integration

Antigravity Link operates entirely inside the Antigravity TUI terminal and compatible IDEs (PyCharm, VS Code):

/link status                                  Check connectivity and active file locks
/link sync --task "<Task>" --files "<File>"   Broadcast task progress and lock files
/link summon "<Task>"                         Summon both AIs to work autonomously
/peer "<Task or message>"                     Delegate task directly to remote peer AI
/senpai "<Task or message>"                   Delegate task specifically to Windows Lead AI
/inbox                                        Read latest messages and task handoffs
/link open <file> [--line <n>]                Open file in PyCharm editor tab
/link gui                                     Display embedded collaborative web GUI URL

CLI Utilities (python3 agy_link.py):

# Check peer status and active locks
python3 agy_link.py status

# Interactive live terminal chat with peer
python3 agy_link.py chat

# Pair session credentials
python3 agy_link.py pair

# Configure Human-in-the-Loop security gate mode:
python3 agy_link.py security prompt            # (Default) GUI modal confirmation for every remote task
python3 agy_link.py security session_trusted   # Auto-approves tasks from paired peer for this session
python3 agy_link.py security deny              # Hard-rejects all incoming remote execution requests

---

🧪 Automated Test Suite

Antigravity Link includes a zero-dependency test suite running on Python's built-in unittest runner:

python -m unittest discover -s tests -v

Coverage:

• tests/test_protocol.py: Wire packet structure, HMAC-SHA256 signature generation, validation, spoofing detection, and tamper detection.
• tests/test_security.py: Security gate decision tree (prompt, autonomous, deny), role hierarchies, and sandboxed execution boundaries.
• tests/test_plugin_hooks.py: PreInvocation lock injection and PreToolUse concurrent file-write prevention with Windows/Linux path normalization.

Every commit and pull request is automatically tested across Linux and Windows runners on Python 3.10, 3.11, 3.12, and 3.13 via GitHub Actions.

---

👥 Core Team & Governance

• Project Lead & Linux Architect: @Mr-Reaper
  Host System: Dell Inspiron 16 5640 · Ubuntu 24.04 LTS (Noble Numbat) · GNOME 46 Wayland
  Authority: Canonical architecture, main branch owner, Linux daemon engine, security framework.

• Platform Lead & Windows Specialist: @Senpai59
  Host System: Custom PC · Windows 11 Home (Build 26200) · AMD Ryzen 5 3600
  Authority: Windows engineering, windows branch owner, PowerShell installers, Win32/WinMM integration.

---

📄 License

Licensed under the MIT License. Free for open-source and commercial pair-programming.