ouroboros-ai 0.44.1.dev2__tar.gz → 0.44.1.dev3__tar.gz

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ouroboros-ai
-Version: 0.44.1.dev2
+Version: 0.44.1.dev3
 Summary: Specification-first workflow engine for AI coding agents. Works with Claude Code and Codex CLI.
 Author-email: Q00 <jqyu.lee@gmail.com>
 License-File: LICENSE

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/docs/cli-reference.md

@@ -68,7 +68,7 @@ ouroboros auto "Build a local-first habit tracker CLI"
 | Option | Description |
 |--------|-------------|
 | `--resume TEXT` | Resume an existing auto session id |
-| `--runtime TEXT` | Runtime backend for the **run-handoff** phase. Shipped values: `claude`, `codex`, `opencode`, `hermes`, `gemini`, `goose`, `kiro`, `copilot`, `pi`, `gjc`. Authoring phases (interview, seed generation, seed repair) **always run in-process** inside the Ouroboros MCP server in `ooo auto` flow — see [What `--runtime` controls in `ooo auto`](#what---runtime-controls-in-ooo-auto) below. |
+| `--runtime TEXT` | Runtime backend for the **run-handoff** phase. Shipped values: `claude`, `codex`, `opencode`, `hermes`, `gemini`, `goose`, `kiro`, `copilot`, `pi`, `gjc`, `antigravity`. Authoring phases (interview, seed generation, seed repair) **always run in-process** inside the Ouroboros MCP server in `ooo auto` flow — see [What `--runtime` controls in `ooo auto`](#what---runtime-controls-in-ooo-auto) below. |
 | `--max-interview-rounds INTEGER` | Maximum automatic interview rounds; prevents unbounded interview loops |
 | `--max-repair-rounds INTEGER` | Maximum Seed repair rounds; prevents unbounded repair loops |
 | `--skip-run` | Stop after creating an A-grade Seed |
@@ -243,7 +243,7 @@ ouroboros setup [OPTIONS]
 
 | Option | Description |
 |--------|-------------|
-| `-r, --runtime TEXT` | Runtime backend to configure. Shipped values: `claude`, `codex`, `opencode`, `hermes`, `gemini`, `goose`, `kiro`, `copilot`, `pi`, `gjc`. Auto-detected if omitted |
+| `-r, --runtime TEXT` | Runtime backend to configure. Shipped values: `claude`, `codex`, `opencode`, `hermes`, `gemini`, `goose`, `kiro`, `copilot`, `pi`, `gjc`, `antigravity`. Auto-detected if omitted |
 | `--opencode-mode TEXT` | OpenCode integration mode: `plugin` (default, recommended — bridge plugin for interactive sessions) or `subprocess` (headless/CI). Mutually exclusive — see [OpenCode runtime guide](runtime-guides/opencode.md#configuration) |
 | `--non-interactive` | Skip interactive prompts (for scripted installs) |
 | `--mcp-mode TEXT` | Codex MCP config mode: `auto` (default), `preserve`, or `stdio` |
@@ -343,7 +343,7 @@ ouroboros init [start] [OPTIONS] [CONTEXT]
 | `-r, --resume TEXT` | Resume an existing interview by ID |
 | `--state-dir DIRECTORY` | Custom directory for interview state files |
 | `-o, --orchestrator` | Use Claude Code for the interview/seed flow; combine with `--runtime` to choose the workflow handoff backend |
-| `--runtime TEXT` | Agent runtime backend for the workflow execution step after seed generation. Shipped values: `claude`, `codex`, `opencode`, `hermes`, `gemini`, `goose`, `kiro`, `copilot`, `pi`, `gjc`. Custom adapters registered in `runtime_factory.py` are also accepted. |
+| `--runtime TEXT` | Agent runtime backend for the workflow execution step after seed generation. Shipped values: `claude`, `codex`, `opencode`, `hermes`, `gemini`, `goose`, `kiro`, `copilot`, `pi`, `gjc`, `antigravity`. Custom adapters registered in `runtime_factory.py` are also accepted. |
 | `--llm-backend TEXT` | LLM backend for interview, ambiguity scoring, and seed generation (`claude_code`, `litellm`, `codex`, `copilot`, `opencode`, `gemini`, `goose`, `kiro`, `pi`, `gjc`) |
 | `-d, --debug` | Show verbose logs including debug messages |
 
@@ -416,7 +416,7 @@ ouroboros run [workflow] [OPTIONS] SEED_FILE
 | Option | Description |
 |--------|-------------|
 | `-o/-O, --orchestrator/--no-orchestrator` | Use the agent-runtime orchestrator for execution (default: enabled) |
-| `--runtime TEXT` | Agent runtime backend override (`claude`, `codex`, `opencode`, `hermes`, `gemini`, `copilot`, `goose`, `kiro`, `pi`, `gjc`). Uses configured default if omitted |
+| `--runtime TEXT` | Agent runtime backend override (`claude`, `codex`, `opencode`, `hermes`, `gemini`, `copilot`, `goose`, `kiro`, `pi`, `gjc`, `antigravity`). Uses configured default if omitted |
 | `-r, --resume TEXT` | Resume a previous orchestrator session by ID |
 | `--mcp-config PATH` | Path to MCP client configuration YAML file |
 | `--mcp-tool-prefix TEXT` | Prefix to add to all MCP tool names (e.g., `mcp_`) |
@@ -945,7 +945,7 @@ ouroboros mcp serve [OPTIONS]
 | `-p, --port INTEGER` | Port to bind to (default: 8080) |
 | `-t, --transport TEXT` | Transport type: `stdio`, `sse`, or `streamable-http` (default: stdio). Note: `http` is only a client config alias for outbound MCP connections and is NOT a valid serve transport. |
 | `--db TEXT` | Path to the EventStore database file |
-| `--runtime TEXT` | Agent runtime backend for orchestrator-driven tools (`claude`, `codex`, `opencode`, `hermes`, `gemini`, `copilot`, `goose`, `kiro`, `pi`, `gjc`). Affects which tool variants are instantiated |
+| `--runtime TEXT` | Agent runtime backend for orchestrator-driven tools (`claude`, `codex`, `opencode`, `hermes`, `gemini`, `copilot`, `goose`, `kiro`, `pi`, `gjc`, `antigravity`). Affects which tool variants are instantiated |
 | `--llm-backend TEXT` | LLM backend for interview/seed/evaluation tools (`claude_code`, `litellm`, `codex`, `copilot`, `opencode`, `gemini`, `goose`, `kiro`, `pi`, `gjc`). Affects which tool variants are instantiated |
 
 **Examples:**
@@ -1027,7 +1027,7 @@ ouroboros mcp info [OPTIONS]
 
 | Option | Description |
 |--------|-------------|
-| `--runtime TEXT` | Agent runtime backend for orchestrator-driven tools (`claude`, `codex`, `opencode`, `hermes`, `gemini`, `copilot`, `goose`, `kiro`, `pi`, `gjc`). Affects which tool variants are instantiated |
+| `--runtime TEXT` | Agent runtime backend for orchestrator-driven tools (`claude`, `codex`, `opencode`, `hermes`, `gemini`, `copilot`, `goose`, `kiro`, `pi`, `gjc`, `antigravity`). Affects which tool variants are instantiated |
 | `--llm-backend TEXT` | LLM backend for interview/seed/evaluation tools (`claude_code`, `litellm`, `codex`, `copilot`, `opencode`, `gemini`, `goose`, `kiro`, `pi`, `gjc`). Affects which tool variants are instantiated |
 
 **Available Tools:**
@@ -1066,7 +1066,7 @@ The table below covers the most commonly used variables. For the full list — i
 | `ANTHROPIC_API_KEY` | — | Anthropic API key for Claude models |
 | `OPENAI_API_KEY` | — | OpenAI API key for LiteLLM / Codex CLI |
 | `OPENROUTER_API_KEY` | — | OpenRouter API key for consensus and LiteLLM |
-| `OUROBOROS_AGENT_RUNTIME` | `orchestrator.runtime_backend` | Override the runtime backend (`claude`, `codex`, `opencode`, `hermes`, `gemini`, `goose`, `kiro`, `copilot`, `pi`, `gjc`) |
+| `OUROBOROS_AGENT_RUNTIME` | `orchestrator.runtime_backend` | Override the runtime backend (`claude`, `codex`, `opencode`, `hermes`, `gemini`, `goose`, `kiro`, `copilot`, `pi`, `gjc`, `antigravity`) |
 | `OUROBOROS_RUNTIME` | `orchestrator.runtime_backend` (fallback) | Shortcut env var honored by both `orchestrator.runtime_backend` and `llm.backend` resolution when their dedicated env vars are unset |
 | `OUROBOROS_KIRO_CLI_PATH` | `orchestrator.kiro_cli_path` | Explicit path to `kiro-cli` binary when it is not on `PATH` |
 | `OUROBOROS_AGENT_PERMISSION_MODE` | `orchestrator.permission_mode` | Permission mode for Claude Code / Codex runtimes (no-op for OpenCode) |

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/docs/runtime-capability-matrix.md

@@ -13,7 +13,7 @@ The runtime backend is selected via the `orchestrator.runtime_backend` config ke
 
 ```yaml
 orchestrator:
-  runtime_backend: claude   # Supported values: claude | codex | opencode | hermes | gemini | kiro | copilot | pi | gjc
+  runtime_backend: claude   # Supported values: claude | codex | opencode | hermes | gemini | kiro | copilot | pi | gjc | antigravity
                             # The runtime abstraction layer also accepts custom
                             # adapters registered in runtime_factory.py
 ```
@@ -26,10 +26,15 @@ ouroboros run workflow --runtime codex seed.yaml
 
 You can also override the configured backend with the `OUROBOROS_AGENT_RUNTIME` environment variable.
 
-> **Extensibility:** Ouroboros uses a pluggable `AgentRuntime` protocol. Claude Code, Codex CLI, OpenCode, Hermes, Gemini CLI, Kiro CLI, GitHub Copilot CLI, Pi CLI, and GJC are the natively shipped backends; additional runtimes can be registered by implementing the protocol and extending `runtime_factory.py`. See [Architecture — How to add a new runtime adapter](architecture.md#how-to-add-a-new-runtime-adapter).
+> **Extensibility:** Ouroboros uses a pluggable `AgentRuntime` protocol. Claude Code, Codex CLI, OpenCode, Hermes, Gemini CLI, Kiro CLI, GitHub Copilot CLI, Pi CLI, GJC, and the Antigravity CLI (`agy`, Google's Gemini-CLI successor — runtime-only) are the natively shipped backends; additional runtimes can be registered by implementing the protocol and extending `runtime_factory.py`. See [Architecture — How to add a new runtime adapter](architecture.md#how-to-add-a-new-runtime-adapter). For the full Antigravity contract, see [runtime-guides/antigravity.md](runtime-guides/antigravity.md).
 
 ## Capability Matrix
 
+> **Note — runtime-only backends not yet threaded as columns:** The tables below
+> predate the runtime-only backends added more recently. Their per-capability
+> contract lives in the per-runtime guide rather than as a column here:
+> Antigravity (`agy`) → [runtime-guides/antigravity.md](runtime-guides/antigravity.md).
+
 ### Workflow Layer (identical across runtimes)
 
 These capabilities are part of the Ouroboros core engine and work the same way regardless of runtime backend.

ouroboros_ai-0.44.1.dev3/docs/runtime-guides/antigravity.md

@@ -0,0 +1,154 @@
+# Antigravity CLI Runtime
+
+Run Ouroboros workflows on top of the locally installed **Antigravity CLI**
+(the `agy` binary) — Google's successor to the Gemini CLI.
+
+On **2026-06-18** the Gemini CLI stops serving the Google AI Pro / Ultra / free
+consumer tiers and migrates those users to the Antigravity CLI (enterprise and
+API-key Gemini access is unaffected). If you authenticated the Gemini runtime
+through a Pro/Ultra subscription, switch the affected stages to the
+`antigravity` runtime.
+
+The Antigravity runtime extends the Gemini runtime (Antigravity is Google's
+Gemini-CLI successor): Ouroboros owns the orchestration loop and shells out to
+`agy` per task. `agy -p` prints a **plain-text** response (there is no
+`--output-format` flag), so the runtime surfaces the final answer as assistant
+messages and checkpoints at the Ouroboros layer (event store + lineage) rather
+than inside the subprocess.
+
+## Prerequisites
+
+| Requirement       | Why                                                              |
+|-------------------|------------------------------------------------------------------|
+| `agy` CLI         | Provider — the Antigravity CLI binary, installed in `~/.local/bin`|
+| Google auth       | Run `agy` once (browser OAuth) — Google AI Pro/Ultra/free, or set `ANTIGRAVITY_API_KEY` |
+| Ouroboros (base)  | `pip install ouroboros-ai` — no provider-specific extras         |
+
+> Antigravity runs on the **base** Ouroboros package. It does **not** require
+> the `[claude]` extra.
+
+## Quick start
+
+```bash
+# 1. Authenticate the Antigravity CLI (one-time browser OAuth)
+agy            # first launch opens the sign-in flow
+
+# 2. Point Ouroboros at Antigravity (config.yaml or the settings GUI)
+ouroboros config           # GUI: set Execute/Evaluate/... runtime to "antigravity"
+# or set OUROBOROS_ANTIGRAVITY_CLI_PATH / orchestrator.antigravity_cli_path
+
+# 3. Run a workflow
+ouroboros run workflow seed.yaml --runtime antigravity
+```
+
+## CLI path resolution
+
+The runtime looks for the binary in this order:
+
+1. Constructor argument `cli_path=...`
+2. `OUROBOROS_ANTIGRAVITY_CLI_PATH` environment variable
+3. `orchestrator.antigravity_cli_path` in `~/.ouroboros/config.yaml`
+4. `agy` on `$PATH`
+
+## Configuration
+
+```yaml
+# ~/.ouroboros/config.yaml
+orchestrator:
+  runtime_backend: antigravity
+  antigravity_cli_path: ~/.local/bin/agy   # optional; auto-detected
+```
+
+Antigravity is **runtime-only** — it drives the agentic orchestrator but is not
+registered as an LLM-completion backend (`agy -p` returns plain text, not a
+structured JSON/schema payload), so it is not a valid `llm.backend` value. Use
+the runtime via `orchestrator.runtime_backend`, per-stage routing, or
+`--runtime antigravity`. For completion-level diversity (consensus / role
+models) route Gemini/other vendors through `litellm`/OpenRouter.
+
+### Per-stage routing
+
+Antigravity shines as a cross-vendor stage in a multi-LLM pipeline — for
+example, generate with one vendor and verify with another:
+
+```yaml
+orchestrator:
+  runtime_backend: claude
+  runtime_profile:
+    stages:
+      execute: claude          # generate
+      evaluate: antigravity    # cross-vendor verification (Gemini 3.x via agy)
+```
+
+## Headless contract
+
+Each task spawns:
+
+```text
+agy -p <PROMPT> \
+    --dangerously-skip-permissions \
+    [--model <MODEL>]
+```
+
+| Flag                             | Why                                                       |
+|----------------------------------|-----------------------------------------------------------|
+| `-p` (`--print` / `--prompt`)    | Runs a single prompt non-interactively, prints the answer |
+| `--dangerously-skip-permissions` | Auto-approves tool requests so the subprocess never blocks|
+| `--model`                        | Forwarded only for an explicit, non-sentinel model id     |
+
+`agy` exposes no granular accept-edits-only mode, so both Ouroboros
+non-blocking permission modes map to the single skip flag:
+
+| Ouroboros permission mode | `agy` behavior                  | Notes                                         |
+|---------------------------|---------------------------------|-----------------------------------------------|
+| `acceptEdits` (default)   | `--dangerously-skip-permissions`| Over-approximated to full skip (no narrower mode) |
+| `bypassPermissions`       | `--dangerously-skip-permissions`| Explicit full bypass                          |
+
+The interactive Ouroboros `default` mode is normalized to `acceptEdits` (with an
+audit log) because a headless `agy -p` invocation cannot service a TTY approval
+prompt.
+
+> ⚠️ **Security note — `acceptEdits` is full auto-approval here.** Unlike the
+> Gemini parent runtime (where `acceptEdits` maps to the narrower edits-only
+> `--approval-mode auto_edit`), `agy` exposes no edits-only mode, so on
+> Antigravity **both** `acceptEdits` (the default) and `bypassPermissions`
+> resolve to `--dangerously-skip-permissions` — every tool request is
+> auto-approved, not just file edits. This is `agy`'s all-or-nothing permission
+> model, and it applies only when you explicitly select the `antigravity`
+> backend. Run Antigravity stages in a sandbox/worktree (Ouroboros uses managed
+> git worktrees by default) and do not select it for untrusted inputs if you
+> need edits-only containment — use the Claude, Codex, or Gemini runtime there
+> instead.
+
+Available models (`agy models`): Gemini 3.5 Flash, Gemini 3.1 Pro, Claude
+Sonnet 4.6, Claude Opus 4.6, GPT-OSS 120B (subject to your plan). Antigravity is
+a **sentinel-model backend** — by default Ouroboros lets `agy` pick its own
+configured model and only forwards `--model` when you set an explicit id.
+
+## Capabilities
+
+| Capability               | Status                                                |
+|--------------------------|-------------------------------------------------------|
+| Headless execution       | ✅ `agy -p`                                           |
+| Tool calls               | ✅ (Antigravity-managed via `--dangerously-skip-permissions`) |
+| Structured event stream  | ❌ plain-text stdout (no `--output-format`)           |
+| Session resumption       | ❌ not surfaced in v1 (recovery at the Ouroboros lineage layer) |
+| LLM-completion backend   | ❌ runtime-only                                       |
+
+If you need a structured event stream or resumable sessions, use the Claude,
+Codex, or Grok runtime.
+
+## Troubleshooting
+
+**`agy` not found.** Install the Antigravity CLI, then set
+`OUROBOROS_ANTIGRAVITY_CLI_PATH=/abs/path/to/agy` or
+`orchestrator.antigravity_cli_path`.
+
+**The CLI hangs waiting for input.** The runtime always passes
+`--dangerously-skip-permissions` and `-p`. If you see a hang, confirm you are
+invoking the runtime through `ouroboros run` (or the MCP server) rather than
+driving `agy` directly.
+
+**Gemini stopped working on 2026-06-18.** That is the consumer-tier Gemini CLI
+cutoff. Switch the affected stages to `antigravity`, or keep Gemini via an
+enterprise/API-key credential (unaffected).

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/docs/runtime-guides/skill-capability-guides.md

@@ -42,6 +42,7 @@ its rendered guide or a documented fallback.
 | Kiro | `~/.kiro/steering/ouroboros-skill-capability-guide.md` | Installed by Kiro setup as a global steering file. |
 | Copilot | `~/.copilot/ouroboros-instructions/AGENTS.md` | Installed by Copilot setup; Ouroboros Copilot runtime also injects that directory through `COPILOT_CUSTOM_INSTRUCTIONS_DIRS`. |
 | GJC | `<agent-dir>/rules/ouroboros-skill-capability-guide.md` | Installed by GJC setup as a setup-owned, renderer-generated capability artifact. |
+| Antigravity | No setup-owned capability artifact yet | Known gap: Antigravity (the `agy` binary, Google's Gemini CLI successor) can be selected as a runtime, but setup does not yet install a durable agy-owned instruction artifact. Use `render_backend_skill_capability_guide("antigravity")` when building Antigravity prompts until a stable artifact surface exists. |
 | Goose | No setup-owned capability artifact yet | Known gap: setup can select Goose as a runtime, but no durable Goose instruction surface or Goose-specific `SkillExecutionCapability` entries are registered yet. Keep skill requirements runtime-neutral and rely on runtime-local operator guidance until a Goose artifact installer exists. |
 | Pi | No setup-owned capability artifact yet | Known gap: Pi has generic rendered capability guidance in the registry, but setup does not yet install it into a durable Pi-owned instruction artifact. Use `render_backend_skill_capability_guide("pi")` when building Pi prompts until a stable artifact surface exists. |
 

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.44.1.dev2'
-__version_tuple__ = version_tuple = (0, 44, 1, 'dev2')
+__version__ = version = '0.44.1.dev3'
+__version_tuple__ = version_tuple = (0, 44, 1, 'dev3')
 
 __commit_id__ = commit_id = None

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/backends/capabilities.py

@@ -491,6 +491,24 @@ _CAPABILITIES: tuple[BackendCapability, ...] = (
         supports_tool_envelope=False,
         skill_execution_capabilities=_GENERIC_SKILL_EXECUTION_CAPABILITIES,
     ),
+    BackendCapability(
+        # Antigravity is Google's successor to the Gemini CLI (the ``agy``
+        # binary). Gemini CLI stops serving the Pro/Ultra/free consumer tiers
+        # on 2026-06-18 and migrates those users to Antigravity. Runtime-only:
+        # ``agy -p`` prints a plain-text response (no ``--output-format``), so
+        # it drives the agentic orchestrator runtime but does not back
+        # structured LLM completions or auto-interview answering.
+        name="antigravity",
+        aliases=("agy",),
+        supports_runtime=True,
+        supports_llm=False,
+        supports_interview_driver=False,
+        switchable_runtime=True,
+        cli_name="agy",
+        cli_config_key="antigravity_cli_path",
+        supports_tool_envelope=False,
+        skill_execution_capabilities=_GENERIC_SKILL_EXECUTION_CAPABILITIES,
+    ),
     BackendCapability(
         # ourocode is an LLM-completion backend only: it streams a single Claude
         # turn over ACP (`ourocode --acp`, its OAuth `:claude_api`) with no tool

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/backends/model_catalog.py

@@ -36,7 +36,7 @@ from ouroboros.config._model_defaults import DEFAULT_OPUS_MODEL, DEFAULT_SONNET_
 # than a Claude model id. Mirrors the loader's sentinel frozensets
 # (_CODEX_LLM_BACKENDS et al.); the mirror is locked by a unit test.
 _SENTINEL_MODEL_BACKENDS = frozenset(
-    {"codex", "opencode", "kiro", "copilot", "hermes", "pi", "gjc"}
+    {"codex", "opencode", "kiro", "copilot", "hermes", "pi", "gjc", "antigravity"}
 )
 
 # The sentinel the loader maps Claude-incapable backends to.
@@ -183,6 +183,7 @@ _CLI_PATH_GETTERS: dict[str, str] = {
     "goose": "get_goose_cli_path",
     "pi": "get_pi_cli_path",
     "gjc": "get_gjc_cli_path",
+    "antigravity": "get_antigravity_cli_path",
     "ourocode": "get_ourocode_cli_path",
 }
 

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/cli/commands/auto.py

@@ -109,6 +109,7 @@ class AgentRuntimeBackend(str, Enum):  # noqa: UP042
     KIRO = "kiro"
     PI = "pi"
     GJC = "gjc"
+    ANTIGRAVITY = "antigravity"
 
 
 app = typer.Typer(

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/cli/commands/config.py

@@ -462,6 +462,10 @@ def backend(
         from ouroboros.config import get_pi_cli_path
 
         cli_path = get_pi_cli_path()
+    elif new_backend == "antigravity":
+        from ouroboros.config import get_antigravity_cli_path
+
+        cli_path = get_antigravity_cli_path()
     if not cli_path:
         cli_path = shutil.which(cli_name)
     if not cli_path:
@@ -500,6 +504,7 @@ def backend(
     # print_error to set a flag.
     from ouroboros.cli.commands import setup as setup_mod
     from ouroboros.cli.commands.setup import (
+        _setup_antigravity,
         _setup_claude,
         _setup_codex,
         _setup_gemini,
@@ -536,6 +541,8 @@ def backend(
             _setup_goose(cli_path)
         elif new_backend == "pi":
             _setup_pi(cli_path)
+        elif new_backend == "antigravity":
+            _setup_antigravity(cli_path)
     except Exception as exc:
         setup_failed = True
         console.quiet = prev_quiet

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/cli/commands/init.py

@@ -72,6 +72,7 @@ class AgentRuntimeBackend(str, Enum):  # noqa: UP042
     COPILOT = "copilot"
     PI = "pi"
     GJC = "gjc"
+    ANTIGRAVITY = "antigravity"
 
 
 class LLMBackend(str, Enum):  # noqa: UP042

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/cli/commands/mcp.py

@@ -71,6 +71,7 @@ class AgentRuntimeBackend(str, Enum):  # noqa: UP042
     GOOSE = "goose"
     PI = "pi"
     GJC = "gjc"
+    ANTIGRAVITY = "antigravity"
 
 
 class LLMBackend(str, Enum):  # noqa: UP042

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/cli/commands/run.py

@@ -122,6 +122,7 @@ class AgentRuntimeBackend(str, Enum):  # noqa: UP042
     KIRO = "kiro"
     PI = "pi"
     GJC = "gjc"
+    ANTIGRAVITY = "antigravity"
 
 
 def _derive_quality_bar(seed: "Seed") -> str:

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/cli/commands/setup.py

@@ -246,6 +246,15 @@ def _detect_runtimes() -> dict[str, str | None]:
         "gjc"
     )
 
+    # Antigravity (agy): explicit-path config first, then PATH.
+    try:
+        from ouroboros.config import get_antigravity_cli_path
+
+        antigravity_path = get_antigravity_cli_path()
+    except Exception:
+        antigravity_path = None
+    runtimes["antigravity"] = antigravity_path or shutil.which("agy")
+
     return runtimes
 
 
@@ -2112,6 +2121,52 @@ def _setup_gemini(gemini_path: str) -> None:
     _install_runtime_instruction_artifact("gemini")
 
 
+def _setup_runtime_only_backend(backend: str, cli_path: str, cli_config_key: str) -> None:
+    """Configure a runtime-only backend (Antigravity / Grok).
+
+    These backends drive the agentic orchestrator runtime but have no
+    LLM-completion adapter (``supports_llm=False``), so this intentionally sets
+    ONLY ``orchestrator.runtime_backend`` + the CLI path and leaves
+    ``llm.backend`` untouched (it is a completion-only contract that rejects
+    these backends). No setup-owned instruction artifact is installed yet — a
+    documented gap in ``docs/runtime-guides/skill-capability-guides.md``.
+    """
+    from ouroboros.config.loader import create_default_config, ensure_config_dir
+
+    config_dir = ensure_config_dir()
+    config_path = config_dir / "config.yaml"
+
+    if config_path.exists():
+        config_dict = yaml.safe_load(config_path.read_text(encoding="utf-8")) or {}
+    else:
+        create_default_config(config_dir)
+        config_dict = yaml.safe_load(config_path.read_text(encoding="utf-8")) or {}
+
+    if not isinstance(config_dict, dict):
+        print_error(
+            f"~/.ouroboros/config.yaml top-level is not a mapping — aborting {backend} setup."
+        )
+        return
+
+    orch = config_dict.get("orchestrator")
+    if not isinstance(orch, dict):
+        orch = {}
+        config_dict["orchestrator"] = orch
+    orch["runtime_backend"] = backend
+    orch[cli_config_key] = cli_path
+
+    with config_path.open("w", encoding="utf-8") as f:
+        yaml.dump(config_dict, f, default_flow_style=False, sort_keys=False)
+
+    print_success(f"Configured {backend} runtime (CLI: {cli_path})")
+    print_info(f"Config saved to: {config_path}")
+
+
+def _setup_antigravity(antigravity_path: str) -> None:
+    """Configure Ouroboros for the Antigravity CLI (``agy``) runtime."""
+    _setup_runtime_only_backend("antigravity", antigravity_path, "antigravity_cli_path")
+
+
 def _setup_pi(pi_path: str) -> None:
     """Configure Ouroboros for the Pi CLI runtime.
 
@@ -3171,6 +3226,16 @@ def setup(
             )
             raise typer.Exit(1)
         _setup_goose(goose_path)
+    elif selected in ("antigravity", "agy"):
+        antigravity_path = available.get("antigravity")
+        if not antigravity_path:
+            print_error(
+                "Antigravity CLI (agy) not found.\n"
+                "Install it, set OUROBOROS_ANTIGRAVITY_CLI_PATH, or configure "
+                "orchestrator.antigravity_cli_path."
+            )
+            raise typer.Exit(1)
+        _setup_antigravity(antigravity_path)
     else:
         print_error(f"Unsupported runtime: {selected}")
         raise typer.Exit(1)

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/config/__init__.py

@@ -31,6 +31,7 @@ from ouroboros.config.loader import (
     get_agent_permission_mode,
     get_agent_reasoning_effort,
     get_agent_runtime_backend,
+    get_antigravity_cli_path,
     get_assertion_extraction_model,
     get_clarification_model,
     get_cli_path,
@@ -149,6 +150,7 @@ __all__ = [
     "get_mechanical_detector_model",
     "get_codex_cli_path",
     "get_copilot_cli_path",
+    "get_antigravity_cli_path",
     "get_gemini_cli_path",
     "get_gjc_cli_path",
     "get_goose_cli_path",

{ouroboros_ai-0.44.1.dev2 → ouroboros_ai-0.44.1.dev3}/src/ouroboros/config/loader.py

@@ -77,6 +77,11 @@ _COPILOT_LLM_BACKENDS = frozenset({"copilot", "copilot_cli"})
 _HERMES_LLM_BACKENDS = frozenset({"hermes", "hermes_cli"})
 _PI_LLM_BACKENDS = frozenset({"pi", "pi_cli"})
 _GJC_LLM_BACKENDS = frozenset({"gjc", "gjc_cli"})
+# Antigravity (`agy`) is runtime-only and Claude-incapable: it runs its own
+# Gemini/Claude models, so generic Claude default ids map to the CLI's own
+# configured default (the "default" sentinel), exactly like the other
+# non-Claude CLI backends above.
+_ANTIGRAVITY_LLM_BACKENDS = frozenset({"antigravity", "agy"})
 _OPENCODE_BACKENDS = frozenset({"opencode", "opencode_cli"})
 _CODEX_DEFAULT_MODEL = "default"
 _KIRO_DEFAULT_MODEL = "default"
@@ -84,6 +89,7 @@ _COPILOT_DEFAULT_MODEL = "default"
 _HERMES_DEFAULT_MODEL = "default"
 _PI_DEFAULT_MODEL = "default"
 _GJC_DEFAULT_MODEL = "default"
+_ANTIGRAVITY_DEFAULT_MODEL = "default"
 _PLACEHOLDER_API_KEY_PREFIX = "YOUR_"
 _PLACEHOLDER_API_KEY_SUFFIX = "_API_KEY"
 _DEFAULT_MAX_PARALLEL_WORKERS = 3
@@ -169,6 +175,7 @@ _UNTRUSTED_ENV_DENYLIST = frozenset(
         "OUROBOROS_GEMINI_CLI_PATH",
         "OUROBOROS_PI_CLI_PATH",
         "OUROBOROS_GJC_CLI_PATH",
+        "OUROBOROS_ANTIGRAVITY_CLI_PATH",
         "OUROBOROS_OUROCODE_CLI_PATH",
         # Bare provider aliases (no OUROBOROS_ prefix) that adapters also
         # honor and then execute. Any new such alias MUST be added here:
@@ -1381,6 +1388,41 @@ def get_gemini_cli_path() -> str | None:
     return None
 
 
+def get_antigravity_cli_path() -> str | None:
+    """Get the Antigravity CLI path (``agy``) from environment or config.
+
+    Priority:
+        1. OUROBOROS_ANTIGRAVITY_CLI_PATH environment variable
+        2. config.yaml orchestrator.antigravity_cli_path
+        3. None (resolve from PATH at runtime)
+
+    Stale env var / config values that don't point to an executable are
+    treated as missing so callers fall back to PATH discovery instead of
+    persisting an unusable path. Mirrors the strictness of `shutil.which`
+    used for the other runtime backends in the setup detection path.
+
+    Returns:
+        Path to the Antigravity CLI binary or None.
+    """
+    env_path = os.environ.get("OUROBOROS_ANTIGRAVITY_CLI_PATH", "").strip()
+    if env_path:
+        resolved = str(Path(env_path).expanduser())
+        if shutil.which(resolved):
+            return resolved
+
+    try:
+        config = load_config()
+        antigravity_path = getattr(config.orchestrator, "antigravity_cli_path", None)
+        if antigravity_path:
+            resolved = str(Path(antigravity_path).expanduser())
+            if shutil.which(resolved):
+                return resolved
+    except ConfigError:
+        pass
+
+    return None
+
+
 def get_llm_backend() -> str:
     """Get default LLM backend from environment variable or config.
 
@@ -1486,7 +1528,7 @@ def get_llm_backend_for_stage(
     parsed_stage = stage if isinstance(stage, Stage) else parse_stage(stage)
     try:
         config = load_config()
-        return resolve_runtime_for_stage(
+        resolved = resolve_runtime_for_stage(
             parsed_stage,
             stages=_runtime_profile_stage_map(config),
             default=_runtime_profile_default(config),
@@ -1497,6 +1539,40 @@ def get_llm_backend_for_stage(
         # caller's default agent before the documented get_llm_backend() default.
         return _explicit_llm_backend_override() or fallback_runtime_backend or get_llm_backend()
 
+    return _guard_llm_completion_backend(resolved)
+
+
+def _backend_supports_llm(name: str | None) -> bool:
+    """Whether a backend can serve LLM completions (vs. being runtime-only).
+
+    Runtime-only backends (e.g. ``antigravity``, ``grok``) declare
+    ``supports_llm=False`` in the capability registry: they drive the agentic
+    orchestrator runtime but have no LLM-completion adapter.
+    """
+    if not name:
+        return False
+    capability = get_backend_capability(name)
+    return capability is not None and capability.supports_llm
+
+
+def _guard_llm_completion_backend(resolved: str) -> str:
+    """Ensure a resolved internal-LLM backend can actually serve completions.
+
+    Per-stage routing may point a stage at a *runtime-only* backend
+    (``supports_llm=False`` — e.g. ``antigravity``/``grok``) for agentic
+    execution; using it for an internal LLM call would crash provider
+    construction. The agentic runtime still uses the runtime-only backend (via
+    ``resolve_runtime_for_stage``); only the LLM-completion call falls back to a
+    completion backend — the explicit ``llm.backend`` override when valid, else
+    the documented ``llm.backend`` default.
+    """
+    if _backend_supports_llm(resolved):
+        return resolved
+    override = _explicit_llm_backend_override()
+    if override and _backend_supports_llm(override):
+        return override
+    return get_llm_backend()
+
 
 def get_llm_backend_for_role(
     role: str,
@@ -1509,13 +1585,22 @@ def get_llm_backend_for_role(
     Same precedence as :func:`get_llm_backend_for_stage`: per-stage routing wins,
     then the explicit legacy ``llm.backend`` / ``OUROBOROS_LLM_BACKEND`` override,
     then the default agent runtime.
+
+    Capability guard: an LLM-completion role must resolve to a completion-capable
+    backend. Per-stage routing may point a stage at a *runtime-only* backend
+    (``supports_llm=False`` — e.g. ``antigravity``/``grok``) for agentic
+    execution; such a backend would crash provider construction if used for an
+    internal LLM call. In that case the agentic runtime still uses the
+    runtime-only backend, but the LLM call falls back to a completion backend
+    (the explicit ``llm.backend`` override when valid, else the documented
+    ``llm.backend`` default).
     """
     if explicit_backend:
         return explicit_backend
 
     try:
         config = load_config()
-        return resolve_runtime_for_llm_role(
+        resolved = resolve_runtime_for_llm_role(
             role,
             stages=_runtime_profile_stage_map(config),
             default=_runtime_profile_default(config),
@@ -1526,6 +1611,8 @@ def get_llm_backend_for_role(
         # caller's default agent before the documented get_llm_backend() default.
         return _explicit_llm_backend_override() or fallback_runtime_backend or get_llm_backend()
 
+    return _guard_llm_completion_backend(resolved)
+
 
 # Legacy per-role model fields kept for backward compatibility. The stage
 # model is the default, but a user who explicitly pinned one of these (env var,
@@ -1690,6 +1777,8 @@ def _default_model_for_backend(
         return _PI_DEFAULT_MODEL
     if resolved in _GJC_LLM_BACKENDS:
         return _GJC_DEFAULT_MODEL
+    if resolved in _ANTIGRAVITY_LLM_BACKENDS:
+        return _ANTIGRAVITY_DEFAULT_MODEL
     return default_model
 
 
@@ -1736,6 +1825,8 @@ def _normalize_configured_model_for_backend(
         return _PI_DEFAULT_MODEL
     if resolved in _GJC_LLM_BACKENDS and is_shipped_default:
         return _GJC_DEFAULT_MODEL
+    if resolved in _ANTIGRAVITY_LLM_BACKENDS and is_shipped_default:
+        return _ANTIGRAVITY_DEFAULT_MODEL
 
     return candidate