meridian

<p align="center"> <img src="assets/banner.svg" alt="Meridian — Claude and Antigravity, in your tools." width="920" /> </p> <p align="center"> <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> <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>

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.

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.

<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	Pi and OpenCode setup
Headless macOS, Linux and Windows	Authenticated acceptance on macOS arm64; Linux/Windows verification unfinished

Quick start

For the released Claude backend, install Node.js 22+, then:

npm install -g @rynfar/meridian
claude login
meridian

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.
See configuration for API-key protection and Windows
setup, or deployment 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. Run agy to sign in with
your subscription account and disable paid overage credits in its settings.
Then install Meridian:

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

Open http://127.0.0.1:3457/providers and use Connect Pi / OpenCode, or follow
the CLI setup instructions.
For a source build, follow the development guide.
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 records
what is missing, available workarounds and what would close each gap.

Desktop

<p align="center"> <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">_{macOS dashboard preview · Sample data}</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. Download the signed,
notarized DMG or ZIP from GitHub Releases,
or follow the source instructions. To try Antigravity, connect the app to a Meridian 1.74.0+ service configured as shown above.
Older Meridian versions do not include Antigravity.

Headless use remains supported. The npm package does not install Electron;
Docker, Nix and existing service managers can run the same server.

How it works

<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>

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

Guide	Contents
Antigravity setup	Models, client tools, attachments, permissions and setup
Antigravity support & recovery	Feature status, unfinished work and recovery limits
Claude client setup	Compatibility matrix and client configuration
Desktop	Local preview, service ownership and platform status
Configuration	CLI, environment variables and API-key protection
Accounts & profiles	Claude sign-in, multiple accounts and routing
Deployment	Docker, Nix and headless services
Plugins	Official packages and plugin configuration
Monitoring	Usage, request diagnostics and prompt caching
Development	Build, test and programmatic API
Live verification	Tested versions, flows and known failures

Contributing

Report an issue, open a PR or join
Discord. Read AGENTS.md,
ARCHITECTURE.md and E2E.md before changing behavior.
For Antigravity reports, include your OS, agy and client versions, the failing
flow and redacted diagnostics.

Meridian is MIT licensed. Claude and Antigravity are trademarks of
their respective owners. Provider asset credits.