agent-archive로 코딩 에이전트 간 대화를 이어간다

agent-archive는 Claude Code, Codex, Cursor에서 진행한 대화 기록을 보관하고, 한 코딩 에이전트의 세션을 다른 에이전트에서 이어가도록 돕는 CLI 도구다. 세션을 검색·열람하고 사용량과 예상 비용도 확인할 수 있다.

agent-archive handoff를 실행하면 세션을 골라 대화 맥락을 다른 에이전트로 가져올 수 있다. Claude Code나 Codex에 이전 세션을 이름으로 불러오도록 요청하는 기능도 제공한다. 사용자가 요청한 자체 S3 또는 R2 버킷을 연결하면 세션을 자동 백업하고 다른 컴퓨터에서도 이용할 수 있다. 세션 이어가기 안내

agent-archive list는 에이전트별 세션을 모아 보여주며 주제, 프로젝트, 브랜치, PR 번호로 필터링할 수 있다. 대화 내용은 로컬 비공개 색인에서 검색하고, agent-archive stats로 에이전트·모델·프로젝트별 세션 수, 토큰 사용량, 예상 비용을 확인한다. 세션 탐색 안내 · 검색 안내 · 사용량 안내

설치 후 agent-archive setup을 실행해 앱과 저장소를 설정한다. 자동 보관은 선택 사항이며, S3 또는 R2 버킷을 연결해야 백업과 다른 컴퓨터에서의 접근을 사용할 수 있다. 설치 바이너리는 macOS(Intel 및 Apple Silicon)와 Linux(x86-64 및 arm64)를 지원한다. 설치 명령은 다음과 같다.

curl -fsSL https://raw.githubusercontent.com/wangjohn/agent-archive/v0.2.2/install.sh | AGENT_ARCHIVE_VERSION=v0.2.2 sh

설정 과정에서 각 앱의 훅 설정을 수정하고 백그라운드 작업을 추가한다. macOS에서는 LaunchAgent, Linux에서는 systemd 사용자 타이머를 사용하며, Claude Code와 Codex·Cursor용 스킬 파일도 작성한다. agent-archive setup --no-skills를 쓰면 스킬 파일 작성은 건너뛴다. 버킷의 오래된 세션은 기본적으로 90일 뒤 삭제된다. 설정이 변경하는 항목은 설치 안내, 저장소 선택은 버킷 안내, 여러 컴퓨터에서 쓰는 방법은 다중 기기 안내에서 확인할 수 있다.

그 밖에 sync는 대기 중인 세션을 수집·업로드하고, pause와 resume은 수집·업로드·정리를 멈추거나 다시 시작한다. 기존 세션을 가져오기 전에 미리 살펴보려면 agent-archive backfill --dry-run을 사용할 수 있다. 전체 옵션은 CLI 참조와 문서를 참고하면 된다. 개인정보 처리 방식은 개인정보 안내에 공개돼 있다.