@rynfar/meridian 1.73.0 → 1.74.0

package/README.md

@@ -1,74 +1,39 @@
 <p align="center">
-  <img src="assets/banner.svg" alt="Meridian — Harness Claude, your way." width="800" />
+  <img src="assets/banner.svg" alt="Meridian — Claude and Antigravity, in your tools." width="920" />
 </p>
 
 <p align="center">
-  <strong>Your tools. Your sessions. One place to see what’s happening.</strong>
-</p>
-
-<p align="center">
-  <a href="https://github.com/rynfar/meridian/releases">Releases</a> ·
-  <a href="#get-started">Get started</a> ·
-  <a href="docs/agents.md">Connect your agent</a> ·
+  <a href="#quick-start">Quick start</a> ·
+  <a href="#try-antigravity">Try Antigravity</a> ·
+  <a href="#desktop">Desktop</a> ·
+  <a href="#documentation">Documentation</a> ·
   <a href="https://discord.gg/jP2a2Z92NZ">Discord</a>
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@rynfar/meridian"><img src="https://img.shields.io/npm/v/@rynfar/meridian?style=flat-square&color=58a6ff" alt="npm version" /></a>
-  <img src="https://img.shields.io/badge/desktop-macOS_preview-bc8cff?style=flat-square" alt="Desktop: macOS preview" />
-  <img src="https://img.shields.io/badge/headless-macOS_·_Linux_·_Windows-58a6ff?style=flat-square" alt="Headless: macOS, Linux and Windows" />
-  <a href="https://opensource.org/license/mit"><img src="https://img.shields.io/badge/license-MIT-bc8cff?style=flat-square" alt="MIT license" /></a>
-</p>
-
-Meridian connects Anthropic- and OpenAI-compatible clients to Claude through the
-Claude Agent SDK. Keep the editor or terminal you like, with streaming, persistent
-sessions, account routing and visibility into usage and prompt caching.
-
-**Now with an optional Mac app.** Manage Meridian versions, install plugins, find
-failed requests and see your usage limits without keeping a terminal open.
-Headless Meridian remains fully supported—npm, Docker, Nix and your existing
-service manager all remain valid ways to run it.
-
-## Meet Meridian Desktop
-
-<p align="center">
-  <img src="assets/desktop-dashboard.jpg" alt="Meridian Desktop overview showing usage limits, cache activity and recent requests. Sample data." width="1000" />
+  <a href="docs/antigravity.md"><img src="https://img.shields.io/badge/Antigravity-preview-bc8cff?style=flat-square" alt="Antigravity: preview" /></a>
+  <a href="https://opensource.org/license/mit"><img src="https://img.shields.io/badge/license-MIT-58a6ff?style=flat-square" alt="MIT license" /></a>
 </p>
 
-<p align="center"><sub>macOS dashboard preview · Sample data</sub></p>
-
-| See what matters | Keep it under control |
-| --- | --- |
-| **Usage & limits** — account quota windows, reset times and token activity. | **Versions** — install published Meridian releases, switch versions and roll back. |
-| **Requests & cache** — timing, failures, cache history and request details. | **Service** — start, stop, restart and recover an app-managed installation. |
-| **Logs & alerts** — searchable diagnostics and opt-in failure, cache and quota notifications. | **Plugins** — install and update the Pi, OpenCode, Hermes and OpenClaw scrub plugins. |
-
-Native macOS chrome, menu bar controls and Liquid Glass on supported Macs through
-[electron-liquid-glass](https://github.com/Meridius-Labs/electron-liquid-glass).
-The desktop preview targets **macOS on Apple Silicon**. Linux and Windows desktop
-apps are planned; their runtime support is not ready yet.
-
-## Get started
+Meridian connects coding clients to **Claude and Antigravity using your subscription**.
+Run Pi, OpenCode or another supported client against a local API, and manage
+providers, requests and usage from a browser or the optional Mac app.
 
-### With the Mac app
+Claude requests run through Anthropic’s Agent SDK. Antigravity requests run
+through Google’s official, signed-in `agy` CLI. Account permissions, model
+availability and subscription limits still apply.
 
-The first downloadable desktop release is being prepared. Until it is published,
-use the [desktop preview instructions](apps/desktop/README.md#run-locally).
-Signed, notarized `.dmg` and `.zip` downloads will appear under
-[GitHub Releases](https://github.com/rynfar/meridian/releases).
+| <img src="assets/providers/claude.png" width="40" alt="Claude logo" /><br>Claude | <img src="assets/providers/antigravity.png" width="40" alt="Antigravity logo" /><br>Antigravity |
+| :--- | :--- |
+| **Released** · Claude Agent SDK | **Preview · v1.74.0+** · Official `agy` CLI |
+| Persistent sessions, prompt caching and multiple account profiles | Streaming, client tools, conversation reuse and saved-answer recovery |
+| [Client compatibility and setup](docs/agents.md) | [Pi and OpenCode setup](docs/antigravity.md) |
+| Headless macOS, Linux and Windows | Authenticated acceptance on macOS arm64; Linux/Windows verification unfinished |
 
-1. Connect to an existing local Meridian service, or install Meridian from **Versions**.
-2. For a new installation, choose app management in **Service** and start it.
-3. Sign in to a Claude account, then follow your [agent’s setup guide](docs/agents.md).
+## Quick start
 
-The app can monitor Docker or Nix installations through a published local HTTP
-port. Their package manager retains control of updates and lifecycle. Supported
-macOS LaunchAgents can be handed to the app and returned to headless operation.
-[How service ownership works →](apps/desktop/README.md#connect-to-an-existing-installation)
-
-### Headless, as always
-
-Requires Node.js 22 or newer and a Claude account configured for the SDK.
+For the released **Claude** backend, install [Node.js 22+](https://nodejs.org/), then:
 
 ```sh
 npm install -g @rynfar/meridian
@@ -76,75 +41,122 @@ claude login
 meridian
 ```
 
-Meridian listens at `http://127.0.0.1:3456`. For OpenCode V1, run
-`meridian setup` once and restart OpenCode. Other clients—including OpenCode V2—have
-[specific setup instructions](docs/agents.md).
+Open `http://127.0.0.1:3456`. For OpenCode V1, run `meridian setup` and restart
+OpenCode. For Pi and other clients, follow the [client setup guide](docs/agents.md).
+See [configuration](docs/configuration.md) for API-key protection and Windows
+setup, or [deployment](docs/deployment.md) for Docker and Nix.
+
+## Try Antigravity
+
+**Antigravity is included in Meridian 1.74.0 and later as a preview.**
+The verified setup uses **agy 1.2.7**, **Pi 0.72.1** or **OpenCode V1 1.18.31**,
+and macOS on Apple Silicon. Other versions need their own verification.
+
+Install Node.js 22+ and the
+[official Antigravity CLI](https://antigravity.google/). Run `agy` to sign in with
+your subscription account and disable paid overage credits in its settings.
+Then install Meridian:
 
 ```sh
-# Example for a POSIX shell, with Meridian API-key protection disabled:
-ANTHROPIC_API_KEY=x ANTHROPIC_BASE_URL=http://127.0.0.1:3456 opencode
+npm install -g @rynfar/meridian@1.74.0
+
+MERIDIAN_BACKEND=antigravity \
+MERIDIAN_AGY_ALLOW_TOOL_BRIDGE=1 \
+MERIDIAN_AGY_STATE_PATH="$HOME/.local/state/meridian/antigravity.sqlite" \
+MERIDIAN_PORT=3457 \
+meridian
 ```
 
-`x` is a client-required placeholder. If you configure Meridian’s API-key
-protection, use that key instead. Claude authentication comes from the configured
-Claude account. See [configuration](docs/configuration.md) for authentication,
-ports and Windows setup, or [deployment](docs/deployment.md) for Docker and Nix.
-
-**No desktop dependency.** Installing the headless package does not install
-Electron. You can run Meridian entirely without the app, including its browser
-[telemetry dashboard](MONITORING.md).
-
-## Built for ongoing work
-
-- **Keep conversations going.** Sessions resume across requests and proxy restarts,
-  with handling for client compaction, undo and branching.
-- **Use the protocol your client speaks.** Anthropic Messages, OpenAI Chat
-  Completions and Responses endpoints, including streaming and tool forwarding.
-- **Keep accounts organized.** Multiple Claude profiles, explicit account selection
-  and opt-in sticky session routing.
-- **Understand cache behavior.** Request history, prompt-cache metrics, diagnostic
-  events and optional persistent telemetry. API-equivalent cost estimates are
-  estimates, not your subscription bill.
-- **Keep your deployment.** CLI, containers, declarative Nix services or the
-  optional desktop manager share the same Meridian server.
+Open `http://127.0.0.1:3457/providers` and use **Connect Pi / OpenCode**, or follow
+the [CLI setup instructions](docs/antigravity.md#configure-installed-clients).
+For a source build, follow the [development guide](docs/development.md).
+The tool bridge lets the client execute tools with its own permissions. The
+SQLite path enables saved state across service restarts; it does not guarantee
+recovery of an unfinished action.
+
+### What works
+
+- **The coding loop:** incremental text, client tools, parallel tool batches,
+  approvals, questions, cancellation and client-owned plugins/delegation.
+- **Model and output selection:** available model/effort variants, forced tools
+  and validated structured output.
+- **Client APIs:** Anthropic Messages, OpenAI Chat Completions and a documented
+  Responses subset.
+- **Attachments:** images and public HTTPS image URLs; documents, speech and
+  video through local conversion. These are not native media APIs.
+- **Continuity:** warm conversation reuse, eligible completed-session restoration,
+  history replay and bounded recovery of saved answers and tool IDs.
+- **Provider management:** web and macOS setup, separate quota/status displays,
+  shared navigation and activity. Native browser/subagent access requires
+  separate explicit grants.
+
+### What is unfinished
+
+Active-task reattachment and automatic reconciliation of uncertain tool outcomes
+are unfinished. Some provider-specific plugins, hosted-tool/file contracts and
+client versions need adapters and acceptance tests. Authenticated Linux/Windows
+verification is also outstanding.
+
+The CLI does not expose exact output-token caps, numeric thinking budgets,
+sampling controls or every native media/reasoning feature. Meridian cannot add
+those guarantees through a wrapper. Upstream CLI failures can still interrupt a
+turn. The [support and recovery checklist](docs/antigravity-support.md) records
+what is missing, available workarounds and what would close each gap.
+
+## Desktop
 
 <p align="center">
-  <img src="assets/how-it-works.svg" alt="Your client connects to Meridian, which sends requests through the Claude Agent SDK." width="920" />
+  <img src="assets/desktop-dashboard.jpg" alt="Meridian Desktop showing usage limits, cache activity and recent requests. Sample data." width="1000" />
 </p>
+<p align="center"><sub>macOS dashboard preview · Sample data</sub></p>
+
+The optional Mac app manages the local service, versions, plugins and diagnostics.
+Use **Providers** to navigate Claude and Antigravity; their accounts and quota
+windows stay separate. Request history helps track failures and activity across
+the service.
+
+The desktop preview targets **macOS on Apple Silicon**. The first downloadable
+release is being prepared; use the [source instructions](apps/desktop/README.md#run-locally)
+in the meantime. To try Antigravity, connect the app to a Meridian 1.74.0+ service configured as shown above.
+Older Meridian versions do not include Antigravity.
 
-Meridian uses the SDK’s authentication and request execution. Account access,
-model availability and usage limits still depend on your provider account.
+Headless use remains supported. The npm package does not install Electron;
+Docker, Nix and existing service managers can run the same server.
 
-## Bring your agent
+## How it works
 
-Setup guides cover **OpenCode, Pi, Claude Code, Codex CLI, Cline, Aider, Crush,
-ForgeCode, Droid, Open WebUI, Cherry Studio, Polytoken, Jcode and Prime Agent**.
-Compatibility varies by client and version; see the
-[tested-agent matrix](docs/agents.md#compatibility-at-a-glance) for evidence and
-limitations. Prime Agent concurrent subagents remain unsuitable for unattended
-or usage-sensitive work. Continue is unverified.
+<p align="center">
+  <img src="assets/how-it-works.svg" alt="Pi, OpenCode and other supported clients connect to Meridian. Claude uses the Agent SDK; Antigravity uses the official agy CLI. Each provider uses its own signed-in account." width="920" />
+</p>
 
-The desktop **Plugins** page installs the four official scrub plugins. Client
-connection setup is still separate; installing a scrub plugin does not configure
-its corresponding client. [Plugin guide →](docs/plugins.md)
+Meridian translates supported client requests at the provider boundary. It keeps
+Claude-specific account routing and cache behavior separate from Antigravity’s
+CLI sessions and permissions. Antigravity generation stays on the signed-in CLI;
+there is no Google API-key or model-SDK fallback.
 
 ## Documentation
 
-| Start here | What you’ll find |
+| Guide | Contents |
 | --- | --- |
-| [Desktop guide](apps/desktop/README.md) | Setup, service ownership, updates, plugins and platform status |
-| [Agent setup](docs/agents.md) | Client configuration and compatibility notes |
-| [Configuration](docs/configuration.md) | CLI, environment variables, endpoints and API-key protection |
-| [Accounts & profiles](docs/profiles.md) | Sign-in, multiple accounts and session routing |
+| [Antigravity setup](docs/antigravity.md) | Models, client tools, attachments, permissions and setup |
+| [Antigravity support & recovery](docs/antigravity-support.md) | Feature status, unfinished work and recovery limits |
+| [Claude client setup](docs/agents.md) | Compatibility matrix and client configuration |
+| [Desktop](apps/desktop/README.md) | Local preview, service ownership and platform status |
+| [Configuration](docs/configuration.md) | CLI, environment variables and API-key protection |
+| [Accounts & profiles](docs/profiles.md) | Claude sign-in, multiple accounts and routing |
 | [Deployment](docs/deployment.md) | Docker, Nix and headless services |
 | [Plugins](docs/plugins.md) | Official packages and plugin configuration |
 | [Monitoring](MONITORING.md) | Usage, request diagnostics and prompt caching |
 | [Development](docs/development.md) | Build, test and programmatic API |
-| [Desktop releases](docs/desktop-releases.md) | Signing, notarization and download publication |
+| [Live verification](E2E.md) | Tested versions, flows and known failures |
+
+## Contributing
 
-## Contribute
+[Report an issue](https://github.com/rynfar/meridian/issues), open a PR or join
+[Discord](https://discord.gg/jP2a2Z92NZ). Read [AGENTS.md](AGENTS.md),
+[ARCHITECTURE.md](ARCHITECTURE.md) and [E2E.md](E2E.md) before changing behavior.
+For Antigravity reports, include your OS, `agy` and client versions, the failing
+flow and redacted diagnostics.
 
-[Report a bug or suggest a feature](https://github.com/rynfar/meridian/issues),
-open a PR, or join [Discord](https://discord.gg/jP2a2Z92NZ).
-Read [AGENTS.md](AGENTS.md), [ARCHITECTURE.md](ARCHITECTURE.md) and
-[E2E.md](E2E.md) before changing behavior. Meridian is [MIT licensed](https://opensource.org/license/mit).
+Meridian is [MIT licensed](https://opensource.org/license/mit). Claude and Antigravity are trademarks of
+their respective owners. [Provider asset credits](assets/providers/README.md).

package/assets/banner.svg

@@ -1,53 +1,28 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 400" fill="none">
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="340" viewBox="0 0 1200 340" role="img" aria-labelledby="title desc">
+  <title id="title">Meridian</title>
+  <desc id="desc">Claude and Antigravity, in your tools.</desc>
   <defs>
-    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" stop-color="#0d1117"/>
-      <stop offset="100%" stop-color="#161b22"/>
-    </linearGradient>
-    <linearGradient id="mGrad" x1="0" y1="0" x2="0" y2="190" gradientUnits="userSpaceOnUse">
+    <linearGradient id="brand" x1="0" y1="0" x2="0" y2="1">
       <stop stop-color="#58a6ff"/>
       <stop offset="1" stop-color="#bc8cff"/>
     </linearGradient>
-    <radialGradient id="glowBlue" cx="0.25" cy="0.1" r="0.6">
-      <stop stop-color="#58a6ff" stop-opacity="0.10"/>
+    <radialGradient id="wash">
+      <stop stop-color="#58a6ff" stop-opacity=".12"/>
       <stop offset="1" stop-color="#58a6ff" stop-opacity="0"/>
     </radialGradient>
-    <radialGradient id="glowViolet" cx="0.85" cy="0.95" r="0.6">
-      <stop stop-color="#bc8cff" stop-opacity="0.10"/>
-      <stop offset="1" stop-color="#bc8cff" stop-opacity="0"/>
-    </radialGradient>
   </defs>
-
-  <rect width="1200" height="400" rx="16" fill="url(#bg)"/>
-  <rect width="1200" height="400" rx="16" fill="url(#glowBlue)"/>
-  <rect width="1200" height="400" rx="16" fill="url(#glowViolet)"/>
-  <rect x="0.5" y="0.5" width="1199" height="399" rx="15.5" stroke="#30363d"/>
-
-  <!-- Subtle dot grid -->
-  <g opacity="0.06" fill="#58a6ff">
-    <circle cx="100" cy="100" r="1.5"/><circle cx="200" cy="100" r="1.5"/><circle cx="300" cy="100" r="1.5"/>
-    <circle cx="100" cy="200" r="1.5"/><circle cx="200" cy="200" r="1.5"/><circle cx="300" cy="200" r="1.5"/>
-    <circle cx="100" cy="300" r="1.5"/><circle cx="200" cy="300" r="1.5"/><circle cx="300" cy="300" r="1.5"/>
-    <circle cx="900" cy="100" r="1.5"/><circle cx="1000" cy="100" r="1.5"/><circle cx="1100" cy="100" r="1.5"/>
-    <circle cx="900" cy="200" r="1.5"/><circle cx="1000" cy="200" r="1.5"/><circle cx="1100" cy="200" r="1.5"/>
-    <circle cx="900" cy="300" r="1.5"/><circle cx="1000" cy="300" r="1.5"/><circle cx="1100" cy="300" r="1.5"/>
+  <rect width="1200" height="340" rx="20" fill="#0d1117"/>
+  <ellipse cx="280" cy="70" rx="600" ry="340" fill="url(#wash)"/>
+  <g transform="translate(128 86) scale(.32)" fill="none" stroke="url(#brand)">
+    <circle cx="256" cy="256" r="200" stroke-width="28"/>
+    <ellipse cx="256" cy="256" rx="84" ry="200" stroke-width="20"/>
+    <path d="M56 256h400" stroke-width="16" opacity=".4"/>
+    <circle cx="256" cy="56" r="36" fill="#58a6ff" stroke="none"/>
+    <circle cx="256" cy="456" r="36" fill="#bc8cff" stroke="none"/>
   </g>
-
-  <!-- Logo mark — gradient globe -->
-  <g transform="translate(365, 105)">
-    <circle cx="95" cy="95" r="75" stroke="url(#mGrad)" stroke-width="10"/>
-    <ellipse cx="95" cy="95" rx="31" ry="75" stroke="url(#mGrad)" stroke-width="7" opacity="0.8"/>
-    <path d="M20 95h150" stroke="url(#mGrad)" stroke-width="6" opacity="0.4"/>
-    <circle cx="95" cy="20" r="13" fill="#58a6ff"/>
-    <circle cx="95" cy="170" r="13" fill="#bc8cff"/>
+  <g font-family="-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica,Arial,sans-serif">
+    <text x="348" y="139" fill="#e6edf3" font-size="48" font-weight="700" letter-spacing="10">MERIDIAN</text>
+    <text x="348" y="195" fill="#e6edf3" font-size="30">Claude &amp; Antigravity, in your tools.</text>
+    <text x="348" y="238" fill="#8b949e" font-size="20">Subscription-backed. Local API. Your client.</text>
   </g>
-
-  <!-- Wordmark -->
-  <text x="600" y="195" font-family="Inter, -apple-system, 'SF Pro Display', 'Segoe UI', Helvetica, Arial, sans-serif" font-size="72" font-weight="700" fill="#e6edf3" letter-spacing="10">MERIDIAN</text>
-
-  <!-- Tagline -->
-  <text x="603" y="240" font-family="Inter, -apple-system, 'SF Pro Display', 'Segoe UI', Helvetica, Arial, sans-serif" font-size="17" font-weight="600" fill="#58a6ff" letter-spacing="3">HARNESS CLAUDE, YOUR WAY.</text>
-
-  <!-- Subtitle -->
-  <text x="603" y="278" font-family="Inter, -apple-system, 'SF Pro Display', 'Segoe UI', Helvetica, Arial, sans-serif" font-size="14" font-weight="300" fill="#8b949e">Local Anthropic API powered by the Claude Agent SDK</text>
 </svg>

package/assets/how-it-works.svg

@@ -1,87 +1,41 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 920 310" fill="none">
-  <style>
-    .title { font-family: 'Inter', -apple-system, sans-serif; font-size: 20px; font-weight: 700; fill: #58a6ff; }
-    .box-label { font-family: 'Inter', -apple-system, sans-serif; font-size: 13px; font-weight: 600; fill: #e6edf3; }
-    .box-sub { font-family: 'JetBrains Mono', 'SF Mono', monospace; font-size: 10px; fill: #58a6ff; }
-    .box-detail { font-family: 'Inter', -apple-system, sans-serif; font-size: 10px; fill: #8b949e; }
-    .tag { font-family: 'Inter', -apple-system, sans-serif; font-size: 9px; font-weight: 600; fill: #6e7681; letter-spacing: 1px; }
-    .step-num { font-family: 'Inter', -apple-system, sans-serif; font-size: 10px; font-weight: 700; }
-    .footer { font-family: 'Inter', -apple-system, sans-serif; font-size: 11px; fill: #6e7681; }
-    .arrow-label { font-family: 'Inter', -apple-system, sans-serif; font-size: 9px; fill: #6e7681; text-anchor: middle; }
-  </style>
-
-  <rect width="920" height="310" rx="16" fill="#0d1117"/>
-  <rect x="0.5" y="0.5" width="919" height="309" rx="15.5" stroke="#30363d" stroke-width="1" fill="none"/>
-
-  <text class="title" x="460" y="38" text-anchor="middle">How it works</text>
-
-  <!-- ═══ STEP 1: YOUR TOOLS ═══ -->
-  <rect x="32" y="64" width="156" height="140" rx="12" fill="#161b22" stroke="#30363d" stroke-width="1"/>
-  <rect x="44" y="54" width="18" height="18" rx="9" fill="#58a6ff"/>
-  <text class="step-num" x="53" y="67" text-anchor="middle" fill="#0d1117">1</text>
-  <text class="box-label" x="110" y="100" text-anchor="middle">Your tools</text>
-  <text class="box-detail" x="110" y="122" text-anchor="middle">OpenCode, Cline</text>
-  <text class="box-detail" x="110" y="136" text-anchor="middle">Continue, Crush, aider</text>
-  <text class="box-detail" x="110" y="150" text-anchor="middle">or any Anthropic client</text>
-  <text class="tag" x="110" y="192" text-anchor="middle">ANTHROPIC API FORMAT</text>
-
-  <!-- ═══ ARROWS 1 ↔ 2 ═══ -->
-  <line x1="200" y1="122" x2="250" y2="122" stroke="#58a6ff" stroke-width="1.5"/>
-  <polygon points="248,118 256,122 248,126" fill="#58a6ff"/>
-  <text class="arrow-label" x="226" y="114">request</text>
-  <line x1="250" y1="142" x2="200" y2="142" stroke="#484f58" stroke-width="1"/>
-  <polygon points="202,138 194,142 202,146" fill="#484f58"/>
-  <text class="arrow-label" x="226" y="162">response</text>
-
-  <!-- ═══ STEP 2: MERIDIAN ═══ -->
-  <rect x="264" y="64" width="156" height="140" rx="12" fill="#161b22" stroke="#58a6ff" stroke-width="1.5"/>
-  <rect x="276" y="54" width="18" height="18" rx="9" fill="#58a6ff"/>
-  <text class="step-num" x="285" y="67" text-anchor="middle" fill="#0d1117">2</text>
-  <text class="box-label" x="342" y="100" text-anchor="middle">Meridian</text>
-  <text class="box-sub" x="342" y="118" text-anchor="middle">localhost:3456</text>
-  <text class="box-detail" x="342" y="140" text-anchor="middle">Local proxy server</text>
-  <text class="box-detail" x="342" y="154" text-anchor="middle">Translates API calls</text>
-  <text class="box-detail" x="342" y="168" text-anchor="middle">to the Claude Agent SDK</text>
-  <text class="tag" x="342" y="192" text-anchor="middle">BRIDGES THE GAP</text>
-
-  <!-- ═══ ARROWS 2 ↔ 3 ═══ -->
-  <line x1="432" y1="122" x2="482" y2="122" stroke="#58a6ff" stroke-width="1.5"/>
-  <polygon points="480,118 488,122 480,126" fill="#58a6ff"/>
-  <text class="arrow-label" x="458" y="114">SDK call</text>
-  <line x1="482" y1="142" x2="432" y2="142" stroke="#484f58" stroke-width="1"/>
-  <polygon points="434,138 426,142 434,146" fill="#484f58"/>
-  <text class="arrow-label" x="458" y="162">result</text>
-
-  <!-- ═══ STEP 3: CLAUDE AGENT SDK ═══ -->
-  <rect x="496" y="64" width="172" height="140" rx="12" fill="#161b22" stroke="#30363d" stroke-width="1"/>
-  <rect x="508" y="54" width="18" height="18" rx="9" fill="#58a6ff"/>
-  <text class="step-num" x="517" y="67" text-anchor="middle" fill="#0d1117">3</text>
-  <text class="box-label" x="582" y="100" text-anchor="middle">Claude Agent SDK</text>
-  <text class="box-sub" x="582" y="118" text-anchor="middle">@anthropic-ai/claude-agent-sdk</text>
-  <text class="box-detail" x="582" y="140" text-anchor="middle">Official Anthropic SDK</text>
-  <text class="box-detail" x="582" y="154" text-anchor="middle">Handles auth + sessions</text>
-  <text class="tag" x="582" y="192" text-anchor="middle">ANTHROPIC'S OWN SDK</text>
-
-  <!-- ═══ ARROWS 3 ↔ 4 ═══ -->
-  <line x1="680" y1="122" x2="726" y2="122" stroke="#58a6ff" stroke-width="1.5"/>
-  <polygon points="724,118 732,122 724,126" fill="#58a6ff"/>
-  <text class="arrow-label" x="704" y="114">API call</text>
-  <line x1="726" y1="142" x2="680" y2="142" stroke="#484f58" stroke-width="1"/>
-  <polygon points="682,138 674,142 682,146" fill="#484f58"/>
-  <text class="arrow-label" x="704" y="162">stream</text>
-
-  <!-- ═══ STEP 4: CLAUDE ═══ -->
-  <rect x="740" y="64" width="140" height="140" rx="12" fill="#161b22" stroke="#30363d" stroke-width="1"/>
-  <rect x="752" y="54" width="18" height="18" rx="9" fill="#58a6ff"/>
-  <text class="step-num" x="761" y="67" text-anchor="middle" fill="#0d1117">4</text>
-  <text class="box-label" x="810" y="100" text-anchor="middle">Claude</text>
-  <text class="box-sub" x="810" y="118" text-anchor="middle">api.anthropic.com</text>
-  <text class="box-detail" x="810" y="140" text-anchor="middle">Fable, Opus, Sonnet</text>
-  <text class="box-detail" x="810" y="154" text-anchor="middle">Haiku, extended thinking</text>
-  <text class="tag" x="810" y="192" text-anchor="middle">YOUR SUBSCRIPTION</text>
-
-  <!-- ═══ BOTTOM ═══ -->
-  <line x1="60" y1="246" x2="860" y2="246" stroke="#30363d" stroke-width="1"/>
-  <text class="footer" x="460" y="274" text-anchor="middle">No API keys needed — authenticates through your existing Claude Code / Max subscription</text>
-
+<svg xmlns="http://www.w3.org/2000/svg" width="920" height="300" viewBox="0 0 920 300" role="img" aria-labelledby="title desc">
+  <title id="title">Two providers, one local bridge</title>
+  <desc id="desc">Clients connect to Meridian, which routes Claude through the Agent SDK and Antigravity through the official agy CLI.</desc>
+  <defs>
+    <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto">
+      <path d="M0 0 10 5 0 10" fill="none" stroke="#8b949e"/>
+    </marker>
+  </defs>
+  <rect width="920" height="300" rx="16" fill="#0d1117"/>
+  <g fill="#161b22" stroke="#30363d">
+    <rect x="32" y="97" width="210" height="106" rx="12"/>
+    <rect x="304" y="97" width="214" height="106" rx="12"/>
+    <rect x="590" y="32" width="298" height="106" rx="12"/>
+    <rect x="590" y="162" width="298" height="106" rx="12"/>
+  </g>
+  <g fill="none" stroke="#8b949e" stroke-width="1.5" marker-end="url(#arrow)">
+    <path d="M242 150h57"/>
+    <path d="M518 150h31V85h36"/>
+    <path d="M549 150v65h36"/>
+  </g>
+  <g font-family="-apple-system,BlinkMacSystemFont,Segoe UI,Helvetica,Arial,sans-serif" text-anchor="middle">
+    <g fill="#e6edf3" font-size="22" font-weight="600">
+      <text x="137" y="137">Your client</text>
+      <text x="411" y="137">Meridian</text>
+      <text x="739" y="68">Claude</text>
+      <text x="739" y="198">Antigravity</text>
+    </g>
+    <g fill="#8b949e" font-size="15">
+      <text x="137" y="164">Pi · OpenCode</text>
+      <text x="137" y="185">and supported clients</text>
+      <text x="411" y="164">Local API &amp; dashboard</text>
+      <text x="411" y="185">Provider-aware routing</text>
+      <text x="739" y="119">Claude account</text>
+      <text x="739" y="249">Signed-in Google account</text>
+    </g>
+    <g fill="#bc8cff" font-size="16">
+      <text x="739" y="94">Official Agent SDK</text>
+      <text x="739" y="224">Official agy CLI</text>
+    </g>
+  </g>
 </svg>

package/assets/providers/README.md

@@ -0,0 +1,10 @@
+# Provider marks
+
+Original provider assets, downloaded September 20, 2026:
+
+- [Claude app icon](https://claude.ai/images/claude_app_icon.png), Anthropic.
+- [Antigravity full-color icon](https://antigravity.google/assets/image/brand/antigravity-icon__full-color.png), Google; [press assets](https://antigravity.google/press).
+
+These marks identify the supported providers. They remain the property of their
+respective owners and are not covered by Meridian’s MIT license. Meridian is an
+independent project.