Skip to content

Repository files navigation

agyswap Banner

CI Release Token Savings: 96.1% MCP: 2026 Stateless License: MIT Platform: macOS

The Uninterrupted Multi-Account & Intelligent Context Engine for Google Antigravity (agy) CLI
Instant switching in 0.1s · Zero-interruption 429 rate-limit guard · 96% context token compression · 2026 Stateless MCP server.


Explore the Live Rate-Limit Guard Simulator, Interactive Token ROI Calculator, 9-Language AST Split Viewer, and Stateless MCP Sandbox directly in your browser.


⚡ Quick Start (30 Seconds)

# 1. Register current logged-in account
agyswap add personal

# 2. Switch to account #2 and resume conversation immediately with full auto-approval
agyswap 2 -r -y

# 3. 🛡️ Never hit rate limits again: Launch agy under auto-rotating guard protection
agyswap guard -y --ctx

# 4. Interactive Live TUI Dashboard
agyswap tui

✨ Why agyswap?

Feature Without agyswap With agyswap
Account Switching Log out in browser, re-authenticate (~60s) agyswap 2 (~0.1s instant switch)
Session Context Context lost on browser re-login -r keeps 100% conversation history (agy -c)
Rate Limits (429) Work stops; manual terminal intervention agyswap guard auto-rotates & resumes seamlessly
Token Consumption Full codebase loaded on resets (~50k tokens) agyswap ctx 96.1% AST compression (~1.9k tokens)
AI Agent Autonomy Agents cannot manage their own quotas 2026 Stateless MCP Server (agyswap mcp)
Parallel Sessions Only one account system-wide Independent accounts per terminal window simultaneously

🚀 Installation

Option 1: Homebrew (Recommended on macOS)

brew install g1mn/tap/agyswap

Option 2: One-Line Curl Installer

curl -fsSL https://raw.githubusercontent.com/g1mn/agyswap/main/install.sh | bash

🤖 2026 Stateless MCP Server

Connect agyswap to Antigravity, Cursor, or Claude Code so your AI coding agents can check their own Gemini quotas and rotate credentials autonomously without human intervention:

{
  "mcpServers": {
    "agyswap": {
      "command": "agyswap",
      "args": ["mcp"]
    }
  }
}

Zero dependencies. Conforms to the latest 2026 Stateless MCP specification with zero mandatory handshakes.


📖 Essential Commands

agyswap                     # List all registered accounts with token health & quota
agyswap 2 -r -y             # Switch to slot 2 + resume (agy -c) + auto-approve tools
agyswap guard -y --ctx      # 🛡️ Auto-rotate on 429 + 96% context compaction
agyswap rotate --all        # Refresh all OAuth tokens in background (no browser)
agyswap ctx bench           # Measure real-time codebase token footprint & savings
agyswap tui                 # Keyboard-driven terminal dashboard (rich/textual)
agyswap prompt              # Fast prompt string for Starship / zsh (`[agy:work 85%]`)

📚 For comprehensive documentation, architecture diagrams, storage specs, and security audits:
👉 Visit the Interactive Documentation & Architecture Dashboard


📄 License

MIT License © 2026 g1mn

About

⚡ Fast Multi-Account Switcher & Session Manager for Google Antigravity (agy) CLI on macOS

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages