agys

Manage multiple antigravity-cli oauth token accounts with ease.

Prerequisites

Before using agys, ensure you have generated your OAuth token:

1. Open Antigravity CLI by running the command agy and complete the setup/login process.
2. This ensures the token file is generated at ~/.gemini/antigravity-cli/antigravity-oauth-token.

Features

• Add Accounts: Easily add and name new OAuth token accounts.
• List Accounts: View all managed accounts and see which one is currently active.
• Interactive Switch: Switch between accounts using an interactive CLI menu.
• Delete Accounts: Securely delete account tokens with confirmation and active account protection.
• Persistent State: Keeps track of the active account automatically.

Changelog

See the CHANGELOG.md for a detailed list of changes and release history.

Installation

npm install -g @first087/agys
# or
bun install -g @first087/agys

Usage

Add a new account

agys add <name>

List all accounts

agys list
# or
agys ls

Switch account

Run agys without any arguments to open the interactive selection menu:

agys
# or explicitly
agys switch

Delete an account

Run agys delete to open the interactive selection menu:

agys delete
# or aliases
agys rm
agys del
agys remove

Compatibility

agys is primarily developed and tested on Linux (bash/sh).

While it is designed to be cross-platform using Node.js/Bun, it has not been extensively tested on other environments, such as:

• Operating Systems: macOS, Windows (Command Prompt, PowerShell).
• Shells: Other shells or Windows-specific shells.

If you encounter any issues in your environment, or if you have tested agys and it works as expected, please open an issue with details about your OS and Shell. Contributions to improve cross-platform support are highly welcome!

Security & Privacy

agys is an open-source tool. Your OAuth tokens are stored locally on your machine within the ~/.agys/ directory for account switching purposes. We do not transmit, store, or share your tokens with any external servers. You are welcome to inspect the source code to verify our privacy practices.