코딩 에이전트를 쓰다 보면 어제 정한 걸 오늘 세션에서 다시 설명하게 됩니다.
"테스트는 pytest로", "이 레포는 마이그레이션 손으로 작성", "그 방식은 지난주에
해 봤는데 안 됐음" 같은 것들이요. 에이전트를 바꾸면(Claude Code → Codex)
처음부터 다시입니다.
Heirmos는 이걸 자동으로 이어 주는 기억 레이어입니다.
■ 하는 일
- 세션이 끝나거나 컨텍스트가 압축될 때 대화에서 결정·선호·규칙만 뽑아 저장
- 다음 세션 시작 시 "이 레포에서 전에 정한 것"을 에이전트 컨텍스트에 자동 주입
- 작업 중엔 에이전트가 MCP로 지난 결정을 직접 검색·읽기
- Claude Code에서 저장한 기억을 Codex·Cursor·Claude.ai·ChatGPT에서도 그대로 사용
Claude Code 자체 메모리(CLAUDE.md 등)와의 차이는 에이전트·기기를 가로질러
하나의 기억을 쓴다는 점, 그리고 따로 적지 않아도 쌓인다는 점입니다.
■ 설치 (Claude Code, 약 5분)
- uv tool install heirmos-cli
- https://dashboard.heirmos.com 가입 → /account에서 API 키 발급 → HEIRMOS_API_KEY 환경변수
- /plugin marketplace add team-pneumora/pneumora-plugins
/plugin install heirmos@pneumora-plugins
MCP 서버도 플러그인이 같은 키로 자동 등록합니다(OAuth 없음).
Codex는 AGENTS.md 스니펫 + MCP, Cursor는 rules 파일로 붙습니다.
■ 무엇이 전송되나
- 보내는 것: 내 프롬프트와 Claude 답변 본문만
- 안 보내는 것: 툴 호출·툴 결과·파일 내용·thinking
- API 키·토큰·비밀번호 형태의 문자열은 전송 전에 로컬에서 지움
- 서버에서 추출·요약·임베딩에 OpenAI API(gpt-4o-mini, text-embedding-3-small)를 사용합니다
- 키·네트워크가 없으면 훅은 조용히 넘어가고 세션을 막지 않습니다
■ 솔직한 현재 상태
1인 개발 초기 단계입니다. 추출이 가끔 그날만 의미 있는 내용을 기억으로
남기기도 하고, 이걸 줄이는 중입니다. Windows에서 Codex 훅은 아직 동작하지
않아 AGENTS.md 방식으로 씁니다.
테스트 기간 동안 무료입니다.
■ 부탁
Claude Code와 Codex(또는 Cursor)를 같이 쓰시는 분 5명 정도 2주만 써 보시고
"도움된 순간 / 틀린 걸 말한 순간"을 알려 주시면 큰 도움이 됩니다.
설치가 막히면 메일 주세요. 10분 화면공유로 같이 해 드립니다: [email protected]