rynfar/meridian

Meridian – Claude 与 Google Antigravity 的本地桥接

它是什么：一个基于 Node 的服务器，位于你的本地编程助手客户端（Pi、OpenCode、……）与两个大型语言模型后端之间——Anthropic 的 Claude（通过官方 Agent SDK）和 Google 的 Antigravity（通过已登录的 agy CLI）。它让你从任何支持的客户端运行这些模型，而无需每个客户端各自实现提供商特定的认证、缓存或工具执行逻辑。

主要功能

• 统一的本地 API – 启动 meridian，然后将你的编辑器/IDE 客户端指向 http://127.0.0.1:3456（Claude）或 …:3457（Antigravity）。服务器会将客户端请求转译为适当的提供商调用，并以通用格式返回响应。
• 提供商特定功能
  • Claude：持久会话、提示缓存、多账户配置文件、完整的 Anthropic Messages API。
  • Antigravity：流式输出、工具桥接（让客户端调用自己的工具）、通过 SQLite 状态文件恢复已保存的回答。
• 桌面仪表板（仅限 macOS） – 一个可选的基于 Electron 的应用，显示使用限制、缓存活动和请求历史记录，并让你以可视化方式切换提供商或账户。
• 可扩展的配置 – 环境变量和 meridian 配置文件控制后端选择、端口、SQLite 路径，以及是否启用 Antigravity 工具桥接。
• 部署选项 – 可通过 npm、Docker 或 Nix 以无界面方式运行；npm 包不包含 Electron，因此仅服务器使用时保持轻量。

目前可用的功能

• 完整的编程循环：增量文本生成、工具调用（包括并行批次）、批准、取消，以及客户端拥有的插件。
• 模型选择、强制工具使用，以及结构化输出验证。
• 附件：图片（原始或 HTTPS）以及文档、语音、视频转换为文本。
• 对话连续性：热会话重用、历史记录重播，以及已保存回答的有限恢复。
• 提供商管理 UI：Claude 和 Antigravity 各自的配额/状态，共享导航。

仍然缺少的功能

• 自动重新附加到进行中的任务，以及对不明确工具结果的稳健调和。
• Antigravity 的完整 Linux/Windows 验证。
• 细粒度的令牌预算、采样或原生媒体推理控制——这些仍属于上游 CLI 的范畴。

开始使用

1. 安装 Node 22+。
2. npm install -g @rynfar/meridian。
3. 若使用 Claude：claude login && meridian。
4. 若使用 Antigravity（仅限 macOS Apple Silicon）：使用官方 agy CLI 登录，然后运行 MERIDIAN_BACKEND=antigravity meridian（环境变量显示于 README 中）。
5. 在浏览器中打开本地 URL，或配置 Pi/OpenCode 使用该端点。

适用对象

• 已经使用 AI 辅助编程工具，但想要一个单一、本地托管的网关来处理多个提供商的认证、缓存和工具桥接集成的开发人员。
• 需要在 Claude 和 Antigravity 之间强制执行订阅限制或审计使用情况，而不向每个客户端暴露 API 密钥的团队。

许可证 – MIT。底层提供商（Claude、Antigravity）仍为专有服务。