Agent Bridge
로그인된 여러 AI CLI를 한 작업에서 연결
기존 로그인과 구독 환경을 유지하면서 공통 목표, 결정, 실행·리뷰 기록과 인계 문서를 한 작업 폴더에서 관리하는 오픈소스 CLI입니다.

Problem
왜 만들었는가
Claude Code, Codex, Gemini CLI를 각각 구독하고 로그인해 사용하고 있었지만, 하나의 작업에서 함께 쓰려면 요청과 결과를 터미널 사이에서 직접 옮겨야 했습니다.
API 키를 다시 발급받아 모델 라우터를 구성하는 대신, 각 도구의 기존 인증과 결제 방식을 그대로 유지하면서 한 작업 안에서 선택해 실행하는 방법이 필요했습니다.
My Role
제품 범위와 검증·공개 판단을 책임졌습니다
Agent Bridge가 인증·결제나 API 프록시를 대신하지 않는다는 경계와 작업 폴더 구조, 명령 체계, CLI 어댑터 형식과 완료 기준을 정했습니다.
Codex와 Claude를 활용해 구현·테스트·문서 초안을 만들고, 명령 흐름과 결과 파일을 검토했습니다. 자동 테스트와 실제 로그인된 Codex CLI 실행으로 완료 여부를 확인하고 MIT 공개와 릴리스 범위를 결정했습니다.
Decision
모델을 합치는 대신 작업 기록을 연결했습니다
여러 AI 도구를 하나의 모델처럼 감싸지 않고, 각 CLI를 독립된 로컬 프로세스로 유지했습니다. Agent Bridge는 어떤 도구를 실행했는지와 그 결과만 공통 형식으로 기록합니다.
특정 제공자의 API나 인증 방식에 종속되지 않도록 연결 정보는 JSON 어댑터로 분리했습니다. 프롬프트를 명령 인자나 표준 입력으로 받는 CLI를 같은 방식으로 등록할 수 있습니다.
Architecture
일반 파일로 확인할 수 있는 작업 공간
각 작업은 목표, 공통 맥락, 결정 사항, 실행 결과, 리뷰와 인계 문서를 하나의 작업 폴더에 저장합니다. 별도 데이터베이스 없이 일반 파일을 사용해 사용자가 어떤 내용이 전달됐는지 직접 확인할 수 있습니다.
`ask`는 한 도구의 실행 결과를, `review`는 여러 도구에 같은 요청을 보낸 결과를 기록합니다. `handoff`는 다음 도구가 이어서 작업할 수 있도록 목표와 결정, 최근 실행 내용을 문서로 정리합니다.
Validation
공개 설치부터 실제 CLI 실행과 인계까지 다시 재현했습니다
자동 테스트에서는 가짜 로컬 에이전트를 사용해 유료 API나 실제 AI 도구 없이 작업 생성, 실행 기록, 리뷰와 인계 문서 생성을 재현합니다. 2026년 7월 27일에는 새 임시 작업 공간에서 GitHub 설치부터 작업 생성, 로그인된 Codex CLI 실행과 handoff 생성까지 다시 확인했습니다.
이 과정에서 Codex CLI의 표준 오류에 포함된 사용자 홈 디렉터리 경로가 run과 handoff 문서에 남는 문제를 발견했습니다. Issue로 기록하고 v0.1.1에서 저장 전 `$HOME`으로 마스킹했으며, 프롬프트·명령 인자·stdout·stderr를 포함한 자동 테스트를 추가했습니다.
Result
검증 중 발견한 문제를 v0.1.1 개선으로 연결했습니다
작업 생성, 도구 목록 확인, 단일 실행, 다중 리뷰, 인계 문서와 요약 생성을 CLI 명령으로 제공하며 GitHub에서 바로 설치할 수 있습니다.
저장소에는 실행 화면과 전체 명령 흐름, 설치·사용 방법, 파일 구조, 자체 검증 기록과 지원하지 않는 범위를 한글로 공개했습니다. 홈 경로 마스킹 개선은 Issue, 테스트와 v0.1.1 Release로 남겼습니다.
Limitations
현재는 작업 기록과 인계의 기본 구조에 집중합니다
AI 제공자의 로그인이나 결제를 관리하지 않고, API 호출을 중계하거나 구독을 우회하지 않습니다. 연결할 CLI는 사용자의 로컬 환경에 이미 설치되고 로그인되어 있어야 합니다.
현재 사용자의 홈 경로 외에 프롬프트와 실행 결과에 포함된 임의의 민감정보를 자동으로 판별하지 않습니다. 기록을 공유하거나 커밋하기 전에는 사용자가 직접 확인해야 합니다.
외부 사용자의 반복 사용과 같은 시점의 Claude Code·Gemini CLI 재현은 아직 검증하지 않았습니다. 긴 맥락 자동 압축과 도구별 파일 선별도 현재 범위에 포함되지 않습니다.
Next Step
실제 사용 흐름에서 전달 범위를 더 정교하게 다듬습니다
추가 CLI 어댑터의 재현성을 확인하고, 작업이 길어졌을 때 어떤 맥락을 다음 도구에 전달할지 선택하는 방식을 개선할 계획입니다.
실행 실패와 부분 완료 상태를 더 명확하게 기록해, 다음 도구와 사용자가 현재 작업 상태를 빠르게 판단할 수 있도록 보완할 예정입니다.