Immutable. This exact content is served forever at /api/v1/blob/d4dea2e324f9bdbc.
---
name: codex-mnemo
description: Codex CLI 과거 대화를 검색하거나 장기기억을 설정할 때 사용. notify 훅으로 대화 자동 저장, 키워드 태깅, 과거 검색.
triggers:
- "mnemo"
- "므네모"
- "장기기억"
- "memory"
- "기억해"
- "이전에"
- "handoff"
- "핸드오프"
- "핸즈오프"
- "세션 저장"
- "codex 기억"
- "codex memory"
- "codex-mnemo"
auto_apply: false
---
# Codex-Mnemo - Codex CLI 기억 시스템
> 기억의 여신 Mnemosyne에서 유래. Claude Code용 Mnemo를 Codex CLI에 이식.
Codex CLI 세션 간 컨텍스트 유지를 위한 장기기억 시스템입니다.
## 설치
```bash
node skills/codex-mnemo/install.js # 설치
node skills/codex-mnemo/install.js --check # 설치/notify 진단
node skills/codex-mnemo/install.js --uninstall # 제거
```
---
## Claude Code Mnemo와의 차이
| | Claude Code (Mnemo) | Codex CLI (Codex-Mnemo) |
|---|---|---|
| 훅 | 2개 (UserPromptSubmit + Stop) | **1개** (notify: agent-turn-complete) |
| 데이터 전달 | stdin JSON + transcript JSONL 파싱 | **notify payload(JSON)** (argv/stdin/파일경로 모두 처리) |
| 설정 | settings.json (JSON) | **config.toml** (TOML) |
| 규칙 파일 | CLAUDE.md | **AGENTS.md** |
| 저장 경로 | `conversations/*-claude.md` | **`conversations/*-codex.md`** |
| 중복 방지 | 타임스탬프 기반 | **turn-id 기반** (더 정확) |
---
## 핵심 원칙
| 원칙 | 설명 |
|------|------|
| **빠르게** | 기본은 훅에서 AI 호출 금지. 단, Chronos auto-continue는 예외 체인 |
| **단순하게** | 파일 기반, DB 없음 |
| **검색 가능하게** | 키워드 + 동의어 확장 |
---
## 포함 파일
```
codex-mnemo/
├── SKILL.md # 이 파일
├── install.js # 설치/제거 스크립트
├── hooks/
│ ├── save-turn.ps1 # Windows notify 오케스트레이터 (+ Chronos optional chain)
│ ├── append-user.ps1 # User 저장 전담
│ ├── append-assistant.ps1 # Assistant 저장 전담
│ ├── save-turn.sh # Linux/Mac notify 오케스트레이터 (+ Chronos optional chain)
│ ├── append-user.sh # User 저장 전담
│ └── append-assistant.sh # Assistant 저장 전담
├── scripts/
│ └── reconcile_codex_conversations.py # rollout JSONL → conversations/ 복구
└── templates/
└── agents-md-rules.md # AGENTS.md 주입 규칙
```
---
## Reconcile (누락 턴 복구)
Codex의 notify 훅이 한 번이라도 실패하거나 Codex CLI가 강제 종료되면 해당 턴의
`conversations/YYYY-MM-DD-codex.md` 미러링이 유실됩니다. 그러나 rollout JSONL
(`~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl`)은 Codex가 직접 기록하는 source of truth
이므로, `reconcile_codex_conversations.py`가 이를 스캔해 누락된 turn을 자동 복구합니다.
**Dedup 키**: Codex rollout 라인에는 uuid가 없으므로 `sha1(timestamp + role + content[:200])`
조합을 키로 사용하며, `conversations/.mnemo-index.json`의 `codex` 네임스페이스에 저장됩니다.
Claude 인덱스(`claude` 네임스페이스)와 충돌하지 않습니다.
**자동 실행**: Claude Code의 `SessionStart` 훅(`reconcile-conversations.ps1/.sh`)이
오늘자 날짜에 대해 Claude + Codex 두 CLI를 모두 복구합니다.
**수동 실행**:
```bash
python skills/codex-mnemo/scripts/reconcile_codex_conversations.py # 오늘자
python skills/codex-mnemo/scripts/reconcile_codex_conversations.py --all # 전체 기간
python skills/codex-mnemo/scripts/reconcile_codex_conversations.py --dry-run # 시뮬레이션
python skills/codex-mnemo/scripts/reconcile_codex_conversations.py --project-root D:/git/foo
```
---
## 동작 흐름
```
Codex CLI 대화
↓
[notify: agent-turn-complete]
→ JSON 페이로드 수신 (argv/stdin/파일경로)
→ save-turn(오케스트레이터)에서 역할 분리 호출
→ MEMORY.md + memory/*.md scaffold 자동 생성(없을 때만)
→ append-user: User 입력 저장
→ append-assistant: Assistant 응답 저장(전체)
→ conversations/YYYY-MM-DD-codex.md에 append
→ turn-id 기반 중복 방지
→ (optional) auto-continue-loop 설치 시 continue-loop 호출
→ loop-state.md 확인
→ 미완료면 background `codex exec resume --last`
```
---
## 저장 위치
| 파일 | 위치 |
|------|------|
| 대화 로그 | `conversations/YYYY-MM-DD-codex.md` |
| 의미기억 | `MEMORY.md` (프로젝트 루트) |
| 훅 | `~/.codex/hooks/save-turn.ps1\|.sh` |
| 설정 | `~/.codex/config.toml` |
| 규칙 | `~/.codex/AGENTS.md` |
| 핸드오프 | 공통 프로젝트 경로 `docs/handoffs/YYYY-MM-DD-HHMMSS-slug.md` |
> 핸드오프는 CLI별 홈 디렉터리가 아니라 프로젝트 안의 공통 디렉터리 `docs/handoffs/`를 사용합니다.
> Claude, Codex, Gemini가 같은 프로젝트 핸드오프를 이어받기 위한 의도된 동작입니다.