# read-codex-history

Скилл read-codex-history для Codex, Claude Code, Cursor, GitHub Copilot и Gemini CLI, который читает, ищет и экспортирует локальную историю сессий OpenAI Codex без возобновления работы.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 221 установка · ★ 1540 у репозитория
- Автор: daymade
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/daymade/claude-code-skills/tree/HEAD/daymade-claude-code/read-codex-history/SKILL.md
- Обновлён: 2026-11-07
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/read-codex-history

## Что делает

Скилл обращается к нескольким локальным хранилищам Codex: `history.jsonl` с дословным вводом пользователя, `state_*.sqlite` с метаданными сессий, роллаут-файлам `sessions/**/rollout-*.jsonl` и архивным сессиям, а также к `logs_*.sqlite` для диагностики ошибок времени выполнения. Каждое хранилище отвечает за своё: скилл не смешивает источники и не подставляет один вместо другого.

Для поиска сессии по UUID-префиксу запускается `scripts/find_codex_session.py <UUID-prefix>` — он принимает только результат с `status: unique` и `identity_verified: true`. Для инвентаризации последних сессий — `scripts/list_local_history.py --source codex --index-only`, для точного списка пользовательских запросов — `scripts/list_codex_user_inputs.py`. Если нужно полное восстановление одной сессии с родительскими снапшотами, подходит `scripts/read_codex_session.py --session <ID>`.

Скилл читает историю и возвращает доказательства — он не продолжает старую задачу и не меняет проект. Если нужно возобновить работу после чтения, скилл передаёт проверенные данные в `daymade-claude-code:continue-codex-work`. Для истории Claude Code есть отдельный скилл `read-claude-code-history`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add daymade/claude-code-skills --skill read-codex-history -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/read-codex-history/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/read-codex-history/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add daymade/claude-code-skills --skill read-codex-history -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/read-codex-history/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add daymade/claude-code-skills --skill read-codex-history -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/read-codex-history/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install daymade/claude-code-skills daymade-claude-code/read-codex-history/SKILL.md
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/read-codex-history/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add daymade/claude-code-skills --skill read-codex-history -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/daymade/claude-code-skills --path daymade-claude-code/read-codex-history
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/read-codex-history/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add daymade/claude-code-skills --skill read-codex-history -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/daymade/claude-code-skills/tree/HEAD/daymade-claude-code/read-codex-history/SKILL.md

## Когда брать
- найти Session ID по UUID-префиксу из вставленного логa
- восстановить дословный ввод пользователя в конкретной сессии Codex
- определить цепочку форков и родительских снапшотов запуска
- диагностировать ошибки подключения по журналу `logs_*.sqlite`
- проверить, что именно было отправлено агенту перед сбоем

## Примеры запросов агенту
- Покажи все последние сессии Codex с их ID и заголовками
- Найди сессию по UUID-префиксу `a3f9` и верни её полный ID
- Восстанови дословный ввод пользователя из сессии `<session-id>`

## Похожие
- [codex-history-ingest](https://affpapa.org/nevibecode/skills/codex-history-ingest.md) — скилл · 2600 установок
- [session-history](https://affpapa.org/nevibecode/skills/session-history.md) — скилл · 14800 установок
- [claude-history-ingest](https://affpapa.org/nevibecode/skills/claude-history-ingest.md) — скилл · 3000 установок
- [cline-session-history](https://affpapa.org/nevibecode/skills/cline-session-history.md) — скилл · 428 установок
- [walden-history](https://affpapa.org/nevibecode/skills/walden-history.md) — скилл · 770 установок
- [chrome-history](https://affpapa.org/nevibecode/skills/chrome-history.md) — скилл · 234 установки

Из того же набора: [daymade/claude-code-skills](https://affpapa.org/nevibecode/by/daymade/claude-code-skills.md) — 102 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
