아직 완전한건 아니고 대충 제가 쓰기에 쓸만한 상태가 되었기에 업그레이드 공유드립니다.
전에 올렸던 agent-work-mem을 확장해서 이에 tmux로 묶어서 동작할 수 있게 했습니다.
유사한 프로젝트로 cmux가 있는데, 가장 큰 차이점은 핸드오프 문서 이력이 남는다는 겁니다. 원래의 agent-work-mem의 장점은 그대로 가지고 있습니다. 오직 프롬프트로만 구성되어 있습니다. tmux 안쓰시는 분들을 위해 lazy-loading기법이 들어가 안쓰시면 컨텍스트에 안올라갑니다.
대략 설계 이념은 다음과 같습니다.
요즘 Claude Code, Codex, Gemini, OpenCode 같은 AI 코딩 에이전트를 이것저것 같이 써보고 있는데요.
각각 장점은 확실히 있고 토큰이 모자라다니 , 여러 개를 같이 쓰게 되더군요. 그러다 보면 제일 불편한 게 “작업 맥락 공유”였습니다.
예를 들면 이런 상황입니다.
- Codex가 설계를 했는데 Claude에게 다시 설명해야 함
- Claude가 리뷰한 내용을 OpenCode에게 또 복붙해야 함
- 이전 세션이 뭘 했는지 다음 에이전트가 모름
- 테스트를 돌렸는지, 그냥 돌렸다고 말한 건지 기록이 애매함
- tmux에 여러 에이전트를 띄워도 서로 실제로 이어서 일하진 못함
그래서 agent-work-mem이라는 걸 만들어보고 있습니다. (이미 여기까지는 전에 소개드렸었죠)
간단히 말하면, 프로젝트 폴더 안에 AIMemory라는 공유 작업 기억을 만들고,
여러 AI 에이전트가 그 안의 markdown 파일을 읽고 쓰면서 작업을 이어받는 방식입니다.
서버나 DB가 있는 건 아니고, 그냥 프로젝트 안에 markdown 파일들이 생깁니다.
대략 이런 흐름입니다.
1. 빈 폴더에 agent-work-mem 설치
2. Codex가 “로그인만 되는 웹사이트” 설계
3. Claude가 설계를 피어리뷰
4. Codex가 리뷰 내용을 반영
5. OpenCode가 구현 handoff를 받아서 개발 시작
tmux를 쓰면 Codex / Claude / Gemini / OpenCode를 한 화면에 pane으로 띄워두고,
“이 설계 Claude pane으로 리뷰 넘겨줘”
“리뷰 반영한 뒤 OpenCode pane으로 구현 넘겨줘”
같은 식으로 쓸 수 있습니다.
중요한 점은 tmux가 기록 저장소는 아니고, 그냥 전달 채널이라는 점입니다.
실제 기록은 프로젝트 안의 AIMemory/work.log와 handoff_*.md에 남습니다.
그래서 pane이 닫히거나 세션이 바뀌어도, 다음 에이전트가 다시 읽고 이어갈 수 있습니다.
아직은 제가 쓰면서 다듬는 중이라 거창한 제품이라기보다는,
여러 AI 코딩 에이전트를 같이 쓸 때 생기는 “맥락 전달 피로”를 줄이기 위한 작은 프로토콜에 가깝습니다.
GitHub:
https://github.com/daystar7777/agent-work-mem
3분짜리 데모 영상도 만들어봤습니다.
영상에서는 빈 폴더에 설치한 뒤, Codex가 설계하고 Claude가 리뷰하고 OpenCode가 구현을 이어받는 과정을 보여줍니다.
비슷하게 여러 에이전트 같이 쓰시는 분들께 도움이 될까 해서 공유해봅니다.
의견이나 개선 아이디어 주시면 감사하겠습니다.
PS. 아직 tmux+awm은 완전하진 않습니다. 하지만 써보시면 몇개의 에이전트던 띄워놓고 하나의 에이전트에서 컨트롤이 가능합니다. 저는 4개를 가지고 주로 피어리뷰랑 구현검증 뭐 이렇게 쓰다보니 동영상처럼 사용하는데 적절한 구조로 개발하고 있습니다. 쓰다보니 gemini-cli가 가지고 있는 요상한 버그도 알게되었고 뭐... 그런거 피해서 계속 쓰고 개발하고 있습니다. 쓰시다 버그 보이면 바로 말씀주셔요. 수동으로 핸드오프하는 건 여전히 잘됩니다. 수동 핸드오프가 미세조정에 유리하기 때문에 저도 자주 씁니다.
PS2. 한글 설치 및 도움말 >> https://github.com/daystar7777/agent-work-mem/blob/main/README.ko.md
PS3. 한글로 된 tmux와 함께 사용하는 법 >> https://github.com/daystar7777/agent-work-mem/blob/main/tmux-usage.ko.md
감사합니다. 좋은 주말되세요~ ^^ 즐코딩!