Send a prompt to the agy CLI (Antigravity, Gemini-backed) and return its response.

Runs agy non-interactively in print mode. Use this for a second opinion from Gemini/Claude/GPT models, to delegate a self-contained task, or to continue a multi-turn agy conversation.

Args:

• prompt (string, required): The prompt to send.

• model (string, optional): A model from agy_list_models (e.g. "Gemini 3.1 Pro (High)"). Omit for default.

• add_dir (string[], optional): Absolute dirs to add to agy's workspace so it can read those files.

• project (string, optional): Existing agy project ID.

• new_project (boolean, default false): Create a new project for this session.

• continue_conversation (boolean, default false): Continue the most recent conversation.

• conversation_id (string, optional): Resume a specific conversation by ID (overrides continue_conversation).

• timeout_ms (number, default 300000): Max wait in ms (1000..1800000).

Returns JSON: { "response": string, "model": string, "exit_code": number }. On failure exit_code is non-zero and response contains agy's stderr (e.g. binary not found, timeout).

Note: runs agy with --dangerously-skip-permissions so tool actions inside agy are auto-approved (required for non-interactive use). Only invoke with prompts you trust to run unattended.

List the models available to the agy CLI (runs agy models).

Use before agy_ask to discover valid values for its 'model' argument.

Takes no arguments. Returns JSON: { "models": string[] } — e.g. ["Gemini 3.5 Flash (High)", "Gemini 3.1 Pro (High)", "Claude Opus 4.6 (Thinking)"].

Report whether agy is logged in and how much per-model quota (credit) remains.

Reads agy's local account store (~/.antigravity_tools). Never returns the auth token.

Takes no arguments. Returns JSON: { "logged_in": boolean, // true if a current account has a valid, non-disabled token "email": string | null, // current account email "name": string | null, // current account display name "accounts": string[], // all known account emails "models_quota": [ { "display_name": string, "percentage": number, "reset_time": string } ] // percentage = remaining credit for that model (100 = full) }

Use before agy_ask to confirm agy is usable; if logged_in is false, call agy_login.

Ensure agy is logged in. If already authenticated, returns immediately.

Otherwise opens a terminal window running agy so you can complete Google sign-in in your browser (agy drives the OAuth flow itself), then polls agy's account store until a valid account appears and reports the signed-in email.

Args:

• timeout_ms (number, default 180000): how long to wait for login to complete (10000..600000).

Returns JSON: { "logged_in": boolean, "email": string | null, "already": boolean, "message": string }.

• already=true means agy was already logged in (no terminal opened).

• logged_in=false with a message means the wait timed out (finish login and call agy_auth_status).

macOS only (opens Terminal.app). On other platforms, run agy yourself to log in, then use agy_auth_status.