Antigravity CLI Tooling

agy-cli-manager

A multi-account auth and account-switching manager for Antigravity CLI (`agy`) with active-standby failover, quota-aware account switching, coordinated runtime failover, Python API control, and terminal dashboard workflows.

View on GitHub Download Release

Install

python3 -m venv .venv
. .venv/bin/activate
pip install https://github.com/zcop/agy-cli-manager/releases/download/v0.2.0/agy_cli_manager-0.2.0-py3-none-any.whl

Core Features

Quota-Aware Switching

Use short-window usage thresholds and refresh-failure counters to move off unhealthy accounts before requests break.

Ranked Account Pool

Choose fuller and healthier standby accounts instead of blindly rotating in name order.

Automation API

Control switch mode, switch policy, usage refresh, and failover through CLI commands or a Python API.

Runtime Failover Control

Coordinate account switching for callers like bots so one failure event leads to one managed switch and one retry.

Terminal Dashboard

Inspect active, standby, cooldown, usage, and switch runtime state from a focused TUI built for operator workflows.

Bot Integration

Use the manager as a switch authority for Telegram bots, automation workers, or any app that needs controlled AGY failover.

Python API Example

from pathlib import Path
from agy_cli_manager import build_paths, get_switch_policy, update_switch_policy

paths = build_paths(Path.home() / ".agy-cli-manager")
policy = get_switch_policy(paths)

update_switch_policy(
    paths,
    short_usage_threshold_percent=12.5,
    refresh_failure_threshold=3,
    candidate_strategy="highest-short",
)

Use Cases

`agy-cli-manager` is useful for Telegram bots, automation workers, cron or systemd timers, multi-account Antigravity CLI auth setups, runtime account rotation, account login storage, and failover-aware local tooling.

Keywords: Antigravity CLI account manager, agy multi account manager, agy multi account auth, agy login manager, agy auth manager, agy account switcher, agy failover, agy quota switching, Antigravity CLI multi account manager, Antigravity multi account auth, Antigravity login manager, Antigravity auth manager, Antigravity account switcher, Gemini CLI multi account auth, Gemini CLI account rotation, active-standby CLI manager, agy automation API, Antigravity automation API, Antigravity CLI failover, runtime account rotation manager.