Run agy --print synchronously and return the assistant text + metadata. Compatible drop-in for the legacy gemini tool: same PROMPT / cd / sandbox / SESSION_ID / return_all_messages / model fields, with new mode / timeout / allow_write / worktree / backend / output_protocol options.

Continue an existing agy session. Identical to agy except SESSION_ID is required and the underlying adapter resumes the Antigravity conversation.

Start an agy session in the background. Returns an envelope with status='running' and a job_id you can poll via agy_status / agy_read / agy_cancel.

Return the JobRecord (status, exit code, error, timestamps) for a job_id or unique job-id prefix.

Read events from a job's event log. since is the 0-based offset; translate may be 'raw', 'claude', or 'codex' to wire-format the events (default returns canonical events as dicts). job_id may be a full id or unique prefix.

Return the captured output for a finished background job. Pass job_id (full id or unique prefix) to select a job, or omit it to use the latest finished job from agy_sessions. Set include_events=true to also return stored events; otherwise use agy_read for the full event log.

Signal a running job to stop by full job_id or unique prefix. Returns success=True, signalled=True if the worker was alive, signalled=False if it was unknown / already finished.

List recent jobs, newest first. limit defaults to 50; pass 0 for the full list.

Run capability + auth + session-store probes. Returns a structured report (no secrets) suitable for surfacing to a user via MCP. Pass force_refresh=true to drop the cached binary probe (use after upgrading the underlying agy / gemini CLI without restarting the MCP server).

Install the agy-mcp collaboration skill bundle into one or more agent platforms. targets may include 'claude', 'codex', 'antigravity', or 'all' (default expands to all three). User scope writes to ~/.claude/skills/, ~/.agents/skills/, and ~/.agy/skills/ respectively; project scope writes to .claude/skills/, .agents/skills/, and .antigravity/skills/ under the supplied project_root. Antigravity's wrapper-owned ~/.agy/ is used in user scope because the standing rule 'do not write under ~/.gemini/' rules out the Antigravity CLI's own state directory. force=False (the default) skips files whose on-disk body already matches; force=True rewrites every file unconditionally.

Delete session-store job directories whose mtime is older than days. Returns the removed job ids and a coarse count of remaining jobs. days must be a positive integer <= 3650; zero or negative values are rejected to avoid an accidental wipe via off-by-one config.