Warning
Community Project Disclaimer Antimatter is an unofficial, community-driven, open-source project. It is NOT an official product of Google, Anthropic, or any AI provider.
Antimatter is the ultimate open-source bridge ecosystem that securely connects your mobile device directly to your local AI agents (Google Antigravity, Claude Code, and more).
By securely tunneling your phone to your local host machine, you can view your active AI agent's trajectory, monitor its thought process, read logs in real-time, send new prompts, and browse your workspace files—all from your mobile device.
Antimatter is built on a massive architectural breakthrough: The Independent Adapter Model.
flowchart LR
Mobile[Mobile App] -- E2EE Ciphertext --> CF[Cloudflare Tunnel]
CF -- TLS Terminated --> Gateway[Antimatter Gateway]
subgraph GatewayNode[Local Machine]
Gateway
Gateway == Plaintext IPC ==> AG[AG IDE Adapter]
Gateway == Plaintext IPC ==> AG2[AG 2.0 Adapter]
Gateway == Plaintext IPC ==> CC[Claude Adapter]
end
Instead of packing complex security and tunneling code into every single AI integration, Antimatter splits the ecosystem into two distinct layers, ensuring absolute stability and security.
The brain of the operation. This is a highly secure Python daemon that runs in the background. It manages Cloudflare Tunnels, generates 256-bit cryptographic keys, and handles the Ed25519 Handshake with your Android device. It hosts a secure local IPC router at 127.0.0.1:8765.
Lightweight, "dumb" IPC clients that connect to the Gateway. Because they don't have to worry about security or networking, they are extremely modular and custom-built for specific AI environments.
We currently officially support:
- Antigravity IDE Adapter (
ag) - A TypeScript VS Code extension. - Antigravity 2.0 Adapter (
ag2) - A standalone Python daemon. - Claude Code Adapter (
cc) - A Node.js streaming integration.
Want to connect a brand new AI agent? Just write a simple WebSocket IPC script and connect it to the Gateway!
Getting started is easier than ever with the new PyPI structure.
Install the core infrastructure using uv (or pip):
uv tool install antimatter-gateway
antimatter-gateway startUpon starting, you will be prompted to dynamically select your preferred connection mode: Local Network (LAN), Cloudflare Tunnel, or Both.
Install the adapter for the AI you are using. For example, for the Antigravity IDE:
- Download the
.vsixfrom our GitHub Releases and install it in VS Code. It will automatically connect to your running Gateway!
- Download the Antimatter Android App from F-Droid or GitHub Releases.
- In your terminal running the gateway, type
antimatter-gateway pairto generate a secure QR code. - Choose which connection method you want to pair with (LAN or Cloudflare).
- Scan the code with the app. You are now cryptographically paired!
Warning
Connection Mode Selection
Antimatter does not save your connection preference. You can dynamically choose between Local Network (LAN) and Cloudflare Tunnel on every start and pair command, without modifying any configuration files. When connecting over LAN, the app relies on robust Application-Layer E2EE rather than TLS, maintaining full security without requiring manual certificate installation.
We have a dedicated documentation website!
👉 Read the Official Antimatter Documentation Here
Explore the depths of the ecosystem:
Getting Started
- Installation & Setup - End-to-end quickstart.
- Features Breakdown - A detailed list of everything Antimatter can do.
Architecture & Security
- Architecture Deep Dive - Learn exactly how the Gateway routes IPC payloads.
- Security Policy - Read about our Biometric locks, Cryptographic Handshakes, and sandboxing.
- Zero Trust Guide - Add a secondary enterprise authentication layer with Cloudflare Access.
Reference
- WebSocket Protocol - The complete message contract between the Gateway and the app.
- Android App - Learn how the Jetpack Compose app dynamically selects active adapters.
- Real-Time Streaming: Watch your agent's thought process character-by-character.
- Native Remote PTY Terminal: Full
os/execintegration directly to your host machine viaSwiftTerm(iOS) andTermux(Android) with standard Linux shell commands over the secure E2EE tunnel. - Zero Trust Security: Ed25519 pairing prevents Man-In-The-Middle attacks even on compromised public networks.
- Seamless Tunnels: Free Cloudflare Quick Tunnels provisioned automatically—no firewall configurations required.
- Offline History: The Android app uses a local Room database to cache conversations and artifacts for offline viewing.
- Live file tree — browse your IDE workspace in real-time.
- File viewer — tap any file to read its contents.
- File writing — make quick edits on the go.
Workspace Whitelisting
By default, the gateway restricts access to only the directory from which the adapter was started. To explicitly allow the Android App to browse and switch between specific directories, whitelist them by adding anallowed_workspacesarray to your~/.antimatter_daemon/config.json:{ "allowed_workspaces": [ "/home/user/my-project", "/home/user/another-project" ] }
Workspace Exclusions
The Android app loads your file tree in real-time. To prevent performance issues or hanging on massive caches (like Android build folders ornode_modules), the gateway ignores specific folders. You can customize this by setting theignored_folderslist in your~/.antimatter_daemon/config.json:{ "ignored_folders": [ "node_modules", ".git", "dist", "build", "out", ".gradle", "__pycache__", ".venv", "venv", ".idea", ".DS_Store", ".kotlin", "gradle-user-home", "Pods", ".cxx", ".dart_tool" ] }(Changes to this list take effect instantly on the next file tree load).
We love contributions! Antimatter is built by developers, for developers.
- Contributing Guidelines: Learn how to set up the environments locally and submit PRs.
- Code of Conduct: Please review our community interaction guidelines.
MIT License