How rynfar/meridian works
Meridian is a local API bridge that lets supported coding clients use Claude and Antigravity subscriptions, with web-based provider management and usage monitoring plus an optional Mac desktop app. The main workflow is client request handling, client-format translation, provider/account selection, and generation through the corresponding provider runtime; telemetry records activity for dashboard views. The README documents the broader Antigravity tool, media, and conversation-continuity capabilities, reflected here at the subsystem level. Source excerpts were limited, so uncertain internal call links are omitted.
Main entry points: server.ts API server · main.ts Desktop shell · manager.ts Service manager · routes.ts Telemetry API
Components 20
Request Bridge
- API server
src/proxy/server.ts - Client adapters
src/proxy/adapters - Request transforms
src/proxy/transforms/registry.ts - Profile routing
src/proxy/routing.ts - Session continuity
src/proxy/sessionStore.ts
Provider Runtimes
- Claude runtime
src/proxy/query.ts - Antigravity runtime
src/proxy/backends/antigravityRuntime.ts
Provider Management
- Account profiles
src/proxy/profiles.ts - Provider setup
src/telemetry/providerSetup.ts - Plugin loading
src/proxy/plugins/loader.ts
Usage and Diagnostics
- Telemetry stores
src/telemetry/index.ts - Telemetry API
src/telemetry/routes.ts - Usage dashboard
src/telemetry/dashboard.ts
Desktop App
- Desktop shell
apps/desktop/src/main.ts - Service manager
apps/desktop/src/manager.ts - Desktop interface
apps/desktop/src/renderer.ts - Client setup
apps/desktop/src/clientSetup.ts
Other components
- Coding clients
- Official agy CLI
- Anthropic Agent SDK
Connections 20
- Coding clients → API server: send requests
- API server → Client adapters: dispatch formats
- Client adapters → Request transforms: translate requests
- API server → Profile routing: select profiles
- API server → Session continuity: resume sessions
- API server → Claude runtime: invoke Claude
- Claude runtime → Anthropic Agent SDK: generate
- API server → Antigravity runtime: invoke Antigravity
- Antigravity runtime → Official agy CLI: run CLI
- Profile routing → Account profiles: read profiles
- API server → Telemetry stores: record activity
- Telemetry API → Telemetry stores: read metrics
- Telemetry API → Usage dashboard: serve dashboard
- Desktop shell → Service manager: dispatch actions
- Desktop interface → Desktop shell: invoke actions
- Service manager → API server: query service
- Service manager → Telemetry API: fetch provider status
- Client setup → Provider setup: build setup command
- Desktop shell → Client setup: copy client setup
- API server → Plugin loading: load plugins