rynfar/meridian

Meridian – Claude 및 Google Antigravity용 로컬 브리지

개요: 로컬 코딩 어시스턴트 클라이언트(Pi, OpenCode, …)와 두 개의 대규모 언어 모델 백엔드(공식 Agent SDK를 통한 Anthropic의 Claude, 로그인된 agy CLI를 통한 Google의 Antigravity) 사이에 위치하는 Node 기반 서버입니다. 각 클라이언트가 공급자별 인증, 캐싱 또는 도구 실행 로직을 구현할 필요 없이 지원되는 모든 클라이언트에서 이러한 모델을 실행할 수 있습니다.

주요 기능

• 통합 로컬 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 지원 코딩 도구를 사용하고 있지만 여러 공급자의 인증, 캐싱 및 도구 브리지 통합을 처리하는 단일 로컬 호스팅 게이트웨이를 원하는 개발자.
• 각 클라이언트에 API 키를 노출하지 않고 Claude와 Antigravity 간의 구독 제한을 적용하거나 사용량을 감사해야 하는 팀.

라이선스 – MIT. 기반 공급자(Claude, Antigravity)는 독점 서비스입니다.