여러 AI 에이전트 CLI를 하나로 통합하는 'oneagent(oa)' 공개

실용적 조언

여러 에이전트를 동시에 사용한다면 brew install 1broseidon/tap/oa 명령어로 도구를 설치하여 통합 관리가 가능하다.
JSON 설정 파일을 수정하여 Claude, Codex 외에 다른 CLI 기반 에이전트 백엔드를 직접 추가할 수 있다.

섹션별 상세

에이전트 CLI 간의 파편화 문제 해결: 현재 Claude Code나 Codex 같은 에이전트들은 각자 독립된 환경(Silo)에서 작동하여 대화 맥락을 공유하거나 유닉스 도구처럼 파이프라인으로 연결하기 어렵다. 'oneagent(oa)'는 이를 하나의 인터페이스로 정규화하여 특정 에이전트에서 시작한 작업을 다른 에이전트에서 이어받아 처리할 수 있는 '휴대용 스레드(Portable Threads)' 기능을 제공한다.

bash

oa -t auth-fix "investigate the failing auth tests"
oa -b codex -t auth-fix "now patch the bug"
oa -b claude -t auth-fix "summarize what changed"

동일한 스레드 ID를 유지하면서 서로 다른 백엔드(Codex, Claude)를 호출하여 작업을 이어가는 예시

유닉스 철학 기반의 워크플로우 통합: 표준 입출력을 지원하여 git diff 결과를 에이전트에게 전달하거나, 테스트 실패 로그를 파이프로 넘겨 즉시 수정을 요청하는 등 기존 개발 워크플로우에 자연스럽게 녹아든다. oa -b codex -t auth-fix "patch the bug"와 같이 백엔드를 명시적으로 지정하면서 동일한 스레드 ID를 유지함으로써 에이전트 간 협업을 스크립트화할 수 있다.

bash

git diff | oa "review these changes"
go test ./... 2>&1 | oa "fix these failures"

유닉스 파이프를 통해 시스템 명령어의 출력을 에이전트에게 전달하는 예시

경량 래퍼 구조와 확장성: ACP(Agent Communication Protocol)와 달리 프로토콜 수준의 복잡한 구현 대신, 이미 인증된 로컬 CLI를 호출하는 얇은 래퍼(Thin Wrapper) 방식을 채택했다. 별도의 API 키 관리나 SDK 설치 없이 JSON 설정 파일만으로 새로운 에이전트 백엔드를 추가할 수 있어 유지보수가 용이하다.

Go 라이브러리로서의 활용: CLI 도구뿐만 아니라 Go 언어용 라이브러리로도 제공되어, 개발자가 직접 구축하는 에이전트 도구에 스레드 엔진과 세션 관리 기능을 이식할 수 있다. 작성자는 이를 활용해 텔레그램 봇의 디스패치 레이어로 사용하며 작업 성격에 따라 적절한 에이전트에게 작업을 할당하는 사례를 제시했다.

import "github.com/1broseidon/oneagent/pkg/oneagent"

oneagent를 Go 프로젝트의 라이브러리로 임포트하여 세션 관리에 활용하는 방법

용어 해설

JSON 라인(JSONL): — 각 줄이 유효한 JSON 객체인 텍스트 형식으로, 데이터 스트림이나 로그 저장에 주로 사용된다. 여러 AI 에이전트가 대화 기록을 저장하는 표준적인 방식으로 활용되어 데이터 이식성을 높이는 기초가 된다.
유닉스 파이핑(Unix Piping): — 한 프로그램의 출력을 다른 프로그램의 입력으로 직접 연결하는 유닉스 운영체제의 메커니즘이다. AI 에이전트 CLI를 파이프로 연결하면 코드 변경 사항이나 테스트 결과를 즉시 에이전트에게 전달하여 자동화된 워크플로우를 구축할 수 있다.
스레드 이식성(Thread Portability): — 특정 AI 모델이나 도구에서 시작된 대화 맥락(스레드)을 다른 도구로 그대로 옮겨와 이어갈 수 있는 능력이다. 이를 통해 사용자는 특정 에이전트의 폐쇄적인 환경(Silo)에 갇히지 않고 필요에 따라 모델을 교체하며 작업을 지속할 수 있다.
오픈 인증(OAuth): — 애플리케이션이 사용자의 비밀번호를 노출하지 않고 다른 서비스의 데이터에 접근할 수 있도록 권한을 부여하는 개방형 표준 프로토콜이다. Anthropic의 OAuth 접근 제한 정책 변화는 로컬 CLI 도구들의 상호운용성 필요성을 자극하는 계기가 됐다.

언급된 도구

oneagent (oa)추천링크

여러 AI 에이전트 CLI를 통합하고 스레드를 공유하는 인터페이스

Claude Code중립

Anthropic의 공식 에이전트 CLI

Codex중립

에이전트 CLI 백엔드 중 하나

언급된 리소스

GitHuboneagent GitHub Repository