rynfar/meridian

Meridian – Local bridge for Claude & Google Antigravity

What it is : A Node‑based server that sits between your local coding‑assistant client (Pi, OpenCode, …​) and two large‑language‑model back‑ends – Anthropic’s Claude (via the official Agent SDK) and Google’s Antigravity (via the signed‑in agy CLI). It lets you run those models from any supported client without each client having to implement the provider‑specific authentication, caching, or tool‑execution logic.

Key capabilities

• Unified local API – Start meridian and point your editor/IDE client at http://127.0.0.1:3456 (Claude) or …:3457 (Antigravity). The server translates the client’s request into the appropriate provider call and returns a response in a common format.
• Provider‑specific features
  • Claude: persistent sessions, prompt caching, multiple account profiles, full Anthropic Messages API.
  • Antigravity: streaming output, tool‑bridge that lets the client invoke its own tools, saved‑answer recovery via a SQLite state file.
• Desktop dashboard (macOS only) – An optional Electron‑based app shows usage limits, cache activity and request history, and lets you switch providers or accounts visually.
• Extensible configuration – Environment variables and a meridian config file control backend selection, port, SQLite path, and whether the Antigravity tool bridge is enabled.
• Deployment options – Run headlessly via npm, Docker, or Nix; the npm package does not bundle Electron, so server‑only use stays lightweight.

What works today

• Full coding loop: incremental text generation, tool calls (including parallel batches), approvals, cancellations, and client‑owned plugins.
• Model selection, forced tool usage, and validation of structured output.
• Attachments: images (raw or HTTPS URLs) and conversion of documents, speech, video to text.
• Conversation continuity: warm session reuse, history replay, and limited recovery of saved answers.
• Provider management UI: separate quota/status for Claude and Antigravity, shared navigation.

What is still missing

• Automatic re‑attachment to in‑flight tasks and robust reconciliation of ambiguous tool results.
• Full Linux/Windows verification for Antigravity.
• Fine‑grained token‑budget, sampling, or native media‑reasoning controls – those remain under the upstream CLI.

Getting started

1. Install Node 22+.
2. npm install -g @rynfar/meridian.
3. For Claude: claude login && meridian.
4. For Antigravity (macOS Apple Silicon only): sign in with the official agy CLI, then run MERIDIAN_BACKEND=antigravity meridian (environment variables shown in the README).
5. Open the local URL in a browser or configure Pi/OpenCode to use that endpoint.

Who it’s for

• Developers who already use AI‑assisted coding tools but want a single, locally‑hosted gateway that handles authentication, caching, and tool‑bridge integration for multiple providers.
• Teams that need to enforce subscription limits or audit usage across Claude and Antigravity without exposing API keys to each client.

License – MIT. The underlying providers (Claude, Antigravity) remain proprietary services.