claude-history CLI
claude-history ищет и открывает прошлые диалоги Claude Code, Codex и Pi в терминале и дает Claude скилл для чтения истории
- 542 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает все локальные файлы сессий агентов, где могут быть ключи и приватный код
- Умеет удалять диалоги, а delete-empty и удаление в интерфейсе стирают файлы без корзины
Установка
- Работает в
Ручная установка
brew install raine/claude-history/claude-historyДля macOS и Linux. Альтернативы: cargo install claude-history и скрипт install.sh.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает все локальные файлы сессий агентов, где могут быть ключи и приватный код
- Умеет удалять диалоги, а delete-empty и удаление в интерфейсе стирают файлы без корзины
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
claude-history — терминальная программа на Rust для работы с историей диалогов. Запущенная из папки проекта, она находит локальные сессии Claude Code, Codex, Pi и Oh My Pi и показывает их списком по свежести. Ввод ищет по всем транскриптам: нечеткое совпадение с оценкой по полям, учет границ слов и индексация вывода инструментов. Переключатель `Ctrl+T` включает смысловой поиск, который ранжирует диалоги целиком по значению запроса. Выбранный диалог открывается во встроенном просмотрщике с прокруткой, поиском, навигацией по сообщениям и разметкой Markdown. Из списка и просмотрщика сессию возобновляют (`Ctrl+R`), ответвляют (`Ctrl+F`), экспортируют в файл, копируют в буфер, переименовывают или удаляют (`Ctrl+X`). Ответвление работает и между проектами, что удобно с git worktree. Команда `claude-history delete-empty` по умолчанию только показывает транскрипты без сообщений, а удаляет их с флагом `--yes`. Отдельно в репозитории лежит скилл, благодаря которому Claude Code сам ищет и читает прошлые разговоры: подкоманды agent возвращают результат агенту, а найденный текст скилл велит считать недоверенными данными.
Для кого. Тем, кто ведет много сессий в Claude Code, Codex или Pi и хочет быстро находить прежние решения, возобновлять и ветвить разговоры.
Подходит, если
- Нужно найти диалог, где обсуждалась инвалидация кэша, и открыть его без ручного поиска по JSONL
- Сессию надо продолжить в другой папке или ветке git worktree через кросс-проектное ответвление
- Вы работаете одновременно с Claude Code и Codex и хотите искать по обоим в одном списке
- Claude Code должен сам вспомнить, что обсуждалось ранее, и процитировать отрывок
Не подходит, если
- Нужно общее хранилище истории для команды: программа читает только локальные файлы вашего компьютера
- Вы работаете в агенте, которого нет в списке: поддерживаются Claude Code, Codex, Pi и Oh My Pi
- Нужна сквозная выгрузка диалогов в заметки Obsidian: у программы есть экспорт в файл, но не синхронизация
Пример запроса к агенту
Найди в прошлых сессиях, как мы чинили нестабильное переподключение, и покажи название диалога и датуОграничения
- Предсобранные релизы есть для macOS на Apple silicon и Intel и для Linux x86_64. На других платформах ставится через Cargo.
- Удаление диалога стирает файл сессии: для Codex команда delete с флагом --force удаляет все версии rollout потока, для Oh My Pi еще и папку артефактов.
- Смысловой поиск не охватывает вспомогательные потоки Codex, они ищутся только лексически.
- Найденные подкомандами agent фрагменты истории могут содержать чужие инструкции, поэтому скилл требует считать их данными.
Как отключить. Через Homebrew выполните brew uninstall claude-history, через Cargo cargo uninstall claude-history. Скилл удаляется из папки скиллов Claude Code. Файл настроек лежит в ~/.config/claude-history/config.toml, его можно удалить вручную. Сами диалоги программа не трогает, пока вы не удалите их из интерфейса.
Частые вопросы
Как найти старый диалог в Claude Code?
Запустите `claude-history` из папки проекта и начните вводить запрос: поиск идет по всем транскриптам. `Ctrl+T` переключает нечеткий поиск на смысловой, который находит диалог по значению, например нестабильное переподключение.
Как поставить claude-history?
Через Homebrew командой `brew install raine/claude-history/claude-history`, через Cargo командой `cargo install claude-history` или скриптом install.sh из репозитория. Обновление выполняет `claude-history update`.
Работает ли claude-history с Codex?
Да, несмотря на название. Программа читает потоки Codex из каталога $`CODEX_HOME` или ~/.codex, помечает их CX и умеет возобновлять и ветвить через Codex CLI. Поддерживаются также Pi и Oh My Pi.
Как дать Claude Code доступ к истории диалогов?
Положите скилл из skills/claude-history в папку скиллов. Он вызывает подкоманды claude-history agent, находит диалог и пересказывает нужное место. Скилл прямо требует считать найденный текст недоверенными данными, а не инструкциями.
Как удалить пустые транскрипты?
Выполните `claude-history delete-empty`: команда покажет, что удалит, и ничего не тронет. Добавьте `--yes`, чтобы удалить, или `--local`, чтобы ограничиться текущим проектом.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыClaude Code History Viewer
claude-code-history-viewer
Настольное приложение для просмотра, поиска и анализа истории разговоров из Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, Aider и других агентов
MCP-сервер для поиска по истории разговоров Claude Code: прошлые решения, ошибки, планы и история изменений файлов.
Архив сессий Claude Code в SQLite с MCP-сервером, терминальным и веб-интерфейсом для поиска прошлых разговоров.
Python-CLI превращает транскрипты Claude Code из JSONL в читаемые HTML и Markdown с поиском, фильтрами и временной шкалой.
Claude Conversation Extractor — экспорт разговоров Claude Code
Claude Conversation Extractor
CLI на Python без зависимостей: находит журналы Claude Code в ~/.claude/projects, ищет по ним и сохраняет разговоры в Markdown, JSON или HTML
CLI собирает историю сессий Claude Code и Codex в локальный граф, ищет по ней и превращает повторяющиеся ошибки в правки
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| claude-history (эта карточка) | нет | 542 | |
| Claude Code History Viewer | нет | 2 314 | отдельный просмотрщик истории, а здесь терминальный интерфейс со смысловым поиском и скиллом для агента |
| Coding Agent Session Search (cass) | нет | 1 205 | индексирует сессии многих агентов, а claude-history добавляет возобновление, ветвление и скилл для Claude |
Коротко о README
README объясняет, что программа охватывает четыре агента, и перечисляет возможности. Затем идут установка тремя способами, работа с сессиями Pi, Oh My Pi и Codex, таблицы горячих клавиш, фильтры по времени и раздел о смысловом поиске.