에이전트 3종 스킬, 링크 하나로 동기화

클로드 코드(Claude Code)·오픈AI 코덱스(OpenAI Codex)·구글 안티그래비티(Google Antigravity)를 함께 쓰는 사용자를 겨냥한 오픈소스 도구 에이전트브리지(AgentBridge)가 공개됐다. 세 도구가 각자 다른 폴더에 따로 보관하던 스킬·MCP 서버·프로젝트 규칙을 한 곳으로 모으고, 운영체제 수준의 링크로 각 도구에 연결하는 방식이다. 저장소는 MIT 라이선스로 깃허브(GitHub)에 올라와 있다.

무슨 일인가 / 배경

코딩 에이전트를 두 개 이상 병행하는 순간 드러나는 문제는 단순하다. 세 도구는 각각 ~/.claude, ~/.codex, ~/.gemini라는 자기 폴더에 설정을 숨겨두고, 저장 형식도 제각각이며, 서로의 존재를 모른다. 스킬 하나를 새로 만들면 나머지 도구에는 보이지 않아 매번 손으로 복사해야 한다. 도구를 하나 늘릴 때마다 관리 비용이 더해지는 게 아니라 곱해지는 구조다.

에이전트브리지는 ~/.agentbridge/skills라는 공용 허브를 하나 만들고, 각 에이전트의 스킬 폴더가 이 허브를 직접 가리키도록 심볼릭 링크(윈도우에서는 정션)를 건다. 상주 데몬도, 주기적 감시도, 관리자 권한도 필요 없다는 점을 개발자는 설계의 핵심으로 내세운다.

핵심 짚어보기

구조는 네 갈래다. 첫째, 스킬은 링크로 공유되므로 허브에 한 번 넣으면 세 도구에서 즉시 보인다. 둘째, MCP 서버 설정은 병합해서 뿌리는데 클로드와 안티그래비티는 JSON, 코덱스는 TOML로 형식이 달라 각각에 맞춰 기록한다. 셋째, 프로젝트 규칙은 AGENTS.md를 정본으로 두고 CLAUDE.md·GEMINI.md·CODEX.md·.cursorrules·.github/copilot-instructions.md로 내보낸다. 넷째, 진단 명령이 허브와 세 에이전트를 훑어 끊어진 링크를 찾아내고 복구 옵션으로 고친다.

안전장치 쪽 설계도 눈여겨볼 만하다. 쓰기가 일어나는 모든 경로(스킬 연결·MCP 동기화·규칙 동기화)는 실행 전 자동 백업을 남기고, 되돌리기용 스냅샷을 따로 보관한다. 시크릿은 같은 값을 담은 운영체제 환경변수가 이미 있으면 평문으로 저장하지 않는다. 파일 변경을 지켜보는 감시 모듈은 규칙 동기화만 지연 처리해 자동으로 돌린다. 허브 자체는 링크로 이미 살아 있으므로 스킬은 다시 복사할 필요가 없다.

1인기업 실전 적용 포인트

• 에이전트를 두 개 이상 쓴다면 규칙 정본을 AGENTS.md 하나로 정하고 나머지 파일은 전부 '생성물'로 취급하라. 사람이 손으로 고치는 규칙 파일이 두 개가 되는 순간 지시가 갈라진다.
• 자주 쓰는 스킬(발행 체크리스트·수집 절차·보고 양식)을 허브 한 곳에 모아라. 스킬 20개를 도구 3개에 수동 배포하면 갱신 한 번에 60번의 복사가 필요하다. 링크 방식은 이 숫자를 0으로 만든다.
• 도입 전에 빈 폴더로 백업·복구 동작을 먼저 시험하라. 링크는 실수로 지우면 원본까지 함께 날아갈 수 있는 구조다.
• MCP 설정에 API 키가 들어 있다면 값을 환경변수로 빼둔 뒤 동기화하라. 이 도구도 환경변수가 존재할 때만 평문 저장을 피한다.

전망 / 주의점

아직 커밋 100여 개, 별 2개 수준의 초기 프로젝트다. 그래서 더 중요한 건 도구 자체가 아니라 아이디어다. 링크 기반 공용 허브는 셸 명령 몇 줄로도 흉내 낼 수 있고, 이 저장소는 거기에 백업·진단·형식 변환을 얹은 셈이다. 다만 링크는 폴더 삭제·이동에 취약하고, 각 도구가 설정 폴더 규약을 바꾸면 그날로 깨진다. 도입한다면 허브 폴더 자체를 깃(Git)으로 버전 관리해 두는 편을 권한다. 어떤 방식을 쓰든 결론은 같다. 규칙과 스킬의 원본은 한 곳에만 있어야 한다.

출처: 해커뉴스 (https://github.com/Helter5/agentbridge)