bg-antigravity
Run Antigravity CLI as a detached background task for long-running autonomous work. Start a job, poll status, tail logs, and stop or remove tasks without blocking the MCP call.
Instructions
Run Antigravity CLI as a detached background task. Subactions: start (returns taskId), status, tail (log output), stop, remove, list. Use for long-running autonomous work — the MCP call returns immediately and you poll status later.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "bg-antigravity"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cd | No | ||
| mode | No | Agent mode (--mode): accept-edits, auto (sandboxed autonomy; not available on every account), or plan (answers go into a plan artifact). | |
| label | No | Human-readable label to identify this task later. | |
| lines | No | Lines to return from log tail. | |
| model | No | Optional model override. Known: Gemini 4 Hydrogen (Low), Gemini 4 Hydrogen (Medium), Gemini 4 Hydrogen (High), Gemini 4 Hydrogen (XHigh), Gemini 4 Argon (Low), Gemini 4 Argon (Medium), Gemini 4 Argon (High), Gemini 4 Carbon (Low), Gemini 4 Carbon (Medium), Gemini 4 Carbon (High), Orchestrator (Argon), Orchestrator (Carbon), Gemini 3.8 Flash (Low), Gemini 3.8 Flash (Medium), Gemini 3.8 Flash (High), Claude Opus 5.5 (Low), Claude Opus 5.5 (Medium), Claude Opus 5.5 (High), Claude Sonnet 5.5 (Low), Claude Sonnet 5.5 (Medium), Claude Sonnet 5.5 (High), GPT-OSS 120B (Medium). | |
| action | Yes | Background task action. | |
| effort | No | Reasoning effort (--effort). Supported levels depend on the model — see list-models. Use with a base model ID (e.g. gemini-4-hydrogen); not supported by Orchestrator. | |
| prompt | No | Prompt (required for action=start). | |
| signal | No | Signal for action=stop (default SIGTERM; SIGKILL for a run that ignores it). | SIGTERM |
| taskId | No | Task ID returned by action=start. | |
| addDirs | No | ||
| sandbox | No | --sandbox: run with terminal restrictions enabled. | |
| timeout | No | agy --print-timeout in milliseconds. Omit for no limit (agy waits for the turn and its background tasks). | |
| workingDir | No | ||
| skipPermissions | No | --dangerously-skip-permissions. Default: true (print mode can't answer permission prompts), false when `mode` is set. Not allowed with mode plan. |