🚀 AgyChat

The Ultimate Antigravity Session & Account Manager

A beautiful, zero-dependency Terminal User Interface (TUI) to view, manage, and seamlessly resume Google Antigravity (AGY) CLI sessions, complete with native Multi-Account OAuth switching and live limits checking!

Features • Installation • Usage • Architecture

---

✨ Features

• 🔐 Multi-Account & Limits Checker: Syncs multiple Antigravity IDE and CLI accounts seamlessly. Press c to instantly view and switch between accounts based on remaining limits (flash, pro, flash_lite) across all your emails! Gracefully handles expired tokens.
• 🧠 Built-in Senior AI Rules Manager: Seamlessly manages and activates elite Antigravity/Gemini AI rules (senior-developer, cli-permissions, security-and-secrets). Press r in the TUI to toggle or use --rules / --install-rules to elevate your AI agent to an autonomous, senior-level software engineer!
• 🌍 Multilingual (i18n): Fully supports English (en), Russian (ru), and Uzbek (uz). Auto-detects your system language or can be set manually via --lang.
• 🎨 Stunning Interactive UI: Beautiful box-drawn terminal tables with modern ANSI colors, complete with Live Keyboard Navigation! Use arrow keys ↑/↓ to select, Enter to resume, s for live filtering, t to tag, and p to pin right from the UI.
• ⚡ Zero Dependencies: Built entirely using Python's Standard Library. No external packages needed. Extremely portable.
• 🚀 Lightning Fast: Optimized lazy-parsing of massive .jsonl transcript logs. It reads only what's necessary, making it blazing fast even with hundreds of sessions.
• 🏷️ Tagging & 📌 Pinning: Give custom names to your important sessions (--tag or t) and pin them to the top of the list (--pin or p).
• 🔍 Live Search: Type s in the UI to instantly filter past sessions in real-time as you type, or use --search from the CLI.
• 🔄 Auto-Updater: AgyChat will automatically check for new releases in the background and let you update seamlessly with a single keypress (u)!

📦 Installation

Install AgyChat directly from GitHub using uv (recommended) or pipx:

uv tool install git+https://github.com/thefarrukhdev/AgyChat.git

Installing the package automatically provides everything you need with zero external dependencies:

• agychat — Interactive TUI for Sessions, Multi-Account Switching, Limits & AI Rules
• agy-oauth-manager — Standalone headless OAuth account switcher & quotas checker

🛠️ Usage

Interactive TUI Mode

Simply run:

agychat

Interactive Keybindings:

• [↑/↓]: Navigate sessions / accounts / rules
• [Enter]: Resume selected session / switch account / toggle rule
• [c]: Check limits and switch active account (Displays limits across all saved accounts!)
• [a]: Open Accounts Manager view
• [r]: Open AI Rules Manager view (Toggle senior developer rules)
• [Tab]: Cycle views (Chats ➔ Accounts ➔ Rules)
• [s]: Live Search
• [t]: Tag selected session
• [p]: Pin/Unpin selected session
• [n]: Start a new session
• [q]: Quit

CLI Commands

agychat 5                      # Resume session #5 immediately
agychat --accounts             # View all saved Antigravity accounts
agychat --add-account          # Auto-detect and save current login
agychat --limits               # Live rate limits across all accounts
agychat --switch-account user@gmail.com # Switch active account
agychat --rotate-account       # Quickly rotate to the next account
agychat --rules                # View status of Gemini AI rules
agychat --install-rules        # Activate all senior AI rules into ~/.gemini/config/rules/
agychat --lang uz              # Switch the UI to Uzbek permanently
agychat -t "Backend" 3         # Assign the name "Backend" to session #3
agychat --pin 3                # Pin session #3 to the top
agychat -s "react"             # Search for "react" in your history
agychat --clear-all            # Safely clear all history

⚙️ Architecture

AgyChat follows strict SOLID and DRY principles, modularized into a professional package structure:

• core/ — Handles lazy file I/O, state management, accounts/limits tracking, and configuration.
• ui/ — Terminal rendering, dynamic grid alignment, accounts table, and ANSI coloring.
• i18n/ — Zero-dependency robust translation system with automatic OS language fallback.
• cli.py — The core event loop, live search, and CLI argument parsing.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

📜 License

MIT License. Do whatever you want with it! Built for the developer community.