코딩 에이전트 세션, 도구 갈아타도 그대로 옮긴다

코딩 에이전트를 여러 개 번갈아 쓰는 사람에게 가장 성가신 제약은 지금까지 나눈 대화가 그 도구 안에 갇혀 있다는 점이었다. 오픈소스 도구 세션 마이그레이트(session-migrate)는 이 벽을 겨냥한다. 클로드 코드(Claude Code)에서 진행하던 작업 세션을 코덱스(Codex)로 옮겨 같은 맥락 그대로 이어 쓰는 식이다. 개발자 xhluca가 깃허브(GitHub)에 MIT 라이선스로 공개했다.

무슨 일인가 / 배경

코딩 에이전트의 대화 기록은 도구마다 제 나름의 형식으로 로컬에 쌓인다. 그래서 도구를 바꾸는 순간, 지금까지 설명해둔 프로젝트 구조와 결정 사항, 시행착오가 통째로 사라진다. 실질적으로는 세션 기록이 잠금장치 노릇을 해온 셈이다.

세션 마이그레이트는 이 형식들을 서로 읽고 쓰는 어댑터를 붙여 문제를 정면으로 다룬다. 현재 지원 목록은 클로드 코드, 코덱스 CLI, 파이(Pi), 오픈코드(OpenCode), 깃허브 코파일럿 CLI(GitHub Copilot CLI), 안티그래비티 CLI(Antigravity CLI), 커서 에이전트(Cursor Agent), 미스트랄 바이브(Mistral Vibe) 여덟 종이다. 여덟 형식 모두가 출발지이자 목적지가 될 수 있어, 문서가 밝힌 이동 경로는 64가지에 이른다. 같은 형식끼리 옮겨 새 세션으로 다시 쓰는 경로도 여기 포함된다.

설치는 uv 도구 설치 명령 한 줄(uv tool install session-migrate)로 끝나고, uv가 없으면 단독 설치 스크립트나 pipx를 써도 된다. 실행 명령은 session-migrate, 짧은 별칭은 smigrate다. 다만 현재 요구 사항은 파이썬 3.11 이상과 리눅스 환경으로 못박혀 있다.

핵심 짚어보기

쓰는 방식은 세 갈래다. 첫째 smigrate inspect는 트랜스크립트 파일의 구조만 확인하고 대화 본문은 화면에 뿌리지 않는다. 로그가 남는 환경이나 화면 공유 중에 세션을 점검해야 할 때 의미가 큰 설계다.

둘째 smigrate transfer는 세션 식별자와 출발·도착 형식, 작업 디렉터리를 받아 새 세션 식별자를 돌려준다. 그다음 도착지 도구에서 이어가기 명령을 실행하면 된다. 셋째 카탈로그 기능은 식별자를 모를 때 쓴다. 목록을 새로 만든 뒤 기억나는 단어를 던지면 되는데, 대소문자를 가리지 않고 단어 순서도 상관없다. 다만 검색 대상은 세션의 제목·이름·식별자이지 대화 본문이 아니다. 형식별·보관 상태별·기간별 필터도 붙는다. 목록 갱신 범위는 기본 경로와 환경이 지정한 경로, 등록된 경로 안으로 제한되며 디스크 전체를 훑지는 않는다.

무엇이 살아남는지도 문서에 표로 정리돼 있다. 사용자와 어시스턴트가 주고받은 메시지는 모든 경로에서 순서까지 보존된다. 반면 도구 호출과 그 결과는 양쪽 어댑터가 같은 형태를 지원할 때만 온전히 넘어가고, 아니면 일부만 남는다. 옮긴 결과물은 원본의 복사본이 아니라 독립된 새 세션이며 실시간 동기화도 아니다.

1인기업 실전 적용 포인트

• 구독을 갈아탈 때 진행 중인 작업을 버리지 않아도 된다. 해지 버튼을 누르기 전에 살아 있는 세션을 다른 하네스로 먼저 옮겨두면 이관 비용이 사실상 0이 된다.
• 사용 한도에 걸려 작업이 멈추는 상황에서 대피로가 생긴다. 한도가 남은 다른 도구로 세션을 넘겨 그날 마감을 지키는 운용이 가능하다.
• 지난 세션을 검색 가능한 자산으로 관리할 수 있다. 목록을 주기적으로 갱신해두고 결제 연동, 배포 오류 같은 키워드로 두 달 전 작업 맥락을 다시 꺼내 쓰는 습관을 들일 만하다.
• 도입 전 확인할 것은 환경이다. 리눅스와 파이썬 3.11 이상이 전제이므로, 윈도우를 쓴다면 WSL 안에서 돌리는 구성을 먼저 잡아야 한다.

전망 / 주의점

이 프로젝트는 스타 14개, 커밋 157개 수준의 초기 단계다. 무엇보다 각 도구 제조사가 공식 지원하는 가져오기 기능이 아니라, 저장 형식을 해석해 다시 쓰는 방식이라 도구가 형식을 바꾸면 언제든 깨질 수 있다. 커서 어댑터는 특정 리눅스 빌드에 고정된 실험 단계이며 텍스트만 옮긴다고 스스로 밝히고 있다.

옮기기 전에 한 가지는 반드시 확인하자. 세션 기록에는 작업 중 붙여넣은 키나 개인정보가 남아 있을 수 있다. 다른 도구로 복제하는 순간 그 흔적도 같이 늘어난다.

출처: GitHub (https://github.com/xhluca/session-migrate)