Start or continue one foreground Antigravity Run.

mode="task" starts a normal bridge-owned task. mode="interactive" starts a persistent conversation session that should be used sparingly. Supplying conversation_id continues that exact Antigravity conversation. dangerously_skip_permissions must be true; the bridge always forwards --dangerously-skip-permissions to Antigravity.

Start one task Run that cannot complete until expected_file is non-empty.

Wait for sparse Run events instead of repeatedly polling status.

run_ids is always a list, even for one Run. Supported condition values: any_attention, any_terminal, all_terminal, any_event, plus aliases attention, terminal, finished, finish, complete, completed, result, all_finished, all_complete, and all_completed.

Refresh Antigravity auth state and optionally open one login session.

Inspect Run state through one lean observation surface.

view="full" returns merged observable state for all run_ids. view="status", "transcript", or "terminal" requires exactly one run_id and returns the corresponding focused view.

Send input to a live foreground Run with optional stale-write guards.

Cancel one active Run and terminate its Antigravity process group.

Read final result metadata, or a bounded chunk when offset_bytes is set.

Start a typed review Run for one commit and return immediately.

Keep issue focused and use narrow scope_paths when possible. After the run completes, prefer agy_review_result over manually polling raw artifacts.

Start a typed review Run for branch and working-tree changes.

Keep issue focused and use narrow scope_paths when possible. Wait for completion with agy_run_wait, then prefer agy_review_result. Avoid frequent agy_run_observe(include_terminal_tail=True) calls unless debugging the bridge.

Validate and summarize the artifact from a typed review Run.

Preferred way to consume completed agy_review_commit/agy_review_branch runs.

Manage bridge scheduler goals with actions create, start_target, status.

dangerously_skip_permissions must be true when supplied.

Run bounded diagnostics and metadata actions for the bridge and agy CLI.