@rynfar/meridian weekly downloads statistics

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