fast-resume CLI
Терминальный поиск по истории сессий Claude Code, Codex, OpenCode и других агентов с возвратом в нужный разговор
- 190 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Индекс собирает тексты всех ваших разговоров с агентами, в них бывают приватные данные
- Возобновление запускает процесс исходного агента в каталоге сессии
Установка
- Работает в
Ручная установка
brew tap angristan/tap && brew install fast-resumeСамый простой способ на macOS и Linux. Команда запуска: fr.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Индекс собирает тексты всех ваших разговоров с агентами, в них бывают приватные данные
- Возобновление запускает процесс исходного агента в каталоге сессии
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Команда `fr` строит один полнотекстовый индекс по локальной истории кодинг-агентов. Искать можно по названию сессии, каталогу, сообщениям пользователя и ответам модели. Поиск на Tantivy терпит опечатки и ставит точные совпадения выше. Запуск без флагов открывает интерфейс на Ratatui, где стрелками выбирают сессию, `Ctrl+P` включает предпросмотр, `Ctrl+Y` копирует команду возобновления, а `Enter` передает управление исходному агенту. Фильтры работают из командной строки и прямо в строке поиска: `agent:`, `dir:` и `date:`, например `fr -a codex -d backend "api error"`. Режим `fr --list` печатает результаты без интерфейса, `fr --stats` показывает состояние индекса, `fr --rebuild` пересобирает его. Для агентов есть стабильный JSON: `fr --json --limit 10 "dir:backend authentication bug"` с постраничным чтением через `--offset`. Команда `fr --agent-context` печатает встроенный скилл с правилами безопасного поиска и возобновления.
Для кого. Тем, кто ведет десятки сессий в Claude Code, Codex и OpenCode и теряет нужный разговор среди заголовков в списках возобновления.
Подходит, если
- Неделю назад агент решил похожую ошибку, и нужно найти ту сессию по тексту ответа
- Сессий много в разных каталогах, и поиск надо ограничить проектом и датой
- Работа шла в нескольких агентах, а искать удобнее в одном месте
- Сам агент должен найти прошлую сессию и предложить команду возобновления, не разбирая таблицу в терминале
- Нужна статистика индекса и быстрая пересборка после смены формата хранения
Не подходит, если
- История агента лежит на другой машине: индекс строится только по локальным файлам
- Нужен просмотр истории в браузере с диффами и метриками: fast-resume работает в терминале
- Агент не входит в список поддерживаемых: список адаптеров фиксирован в README
Пример запроса к агенту
Найди через fast-resume сессию Codex в каталоге `backend`, где мы чинили ошибку аутентификации за последние две недели, и покажи команду возобновленияОграничения
- Поддерживаются Antigravity CLI, Claude Code, Codex, Copilot CLI, Copilot в VS Code, Crush, Cursor CLI, fx, Grok Build, Kimi Code, OpenCode, Pi и Vibe. Остальные агенты не индексируются.
- Индекс лежит в `~/.cache/fast-resume/tantivy_index` или в `$XDG_CACHE_HOME`. Он содержит текст ваших разговоров, а в них бывают приватные данные проекта.
- Передача управления агенту запускает его процесс в каталоге сессии. Режим `--yolo` включайте только осознанно.
- Для стабильных результатов JSON агент должен вызывать `fr` с небольшим `--limit` и читать страницы по `meta.next_offset`.
Как отключить. Удалите программу тем же способом, которым ставили: `brew uninstall fast-resume`, `npm uninstall --global fast-resume` или `uv tool uninstall fast-resume`. Индекс лежит в `~/.cache/fast-resume`, его можно стереть вручную.
Частые вопросы
Как поставить fast-resume?
На macOS и Linux проще всего `brew tap angristan/tap && brew install fast-resume`. Работают и `npm install --global fast-resume`, и `uv tool install fast-resume`, и Nix.
Как дать агенту работать с fast-resume самому?
Выполните `fr --agent-context`: команда печатает встроенный скилл. Агент вызывает `fr --json` и читает поля `sessions` и `meta`, таблицу разбирать не нужно.
Какие фильтры есть у поиска?
`agent:`, `dir:` и `date:`, например `agent:claude date:<2d auth`. Те же значения задаются флагами `-a` и `-d` в командной строке.
Где хранится индекс и как его сбросить?
В `~/.cache/fast-resume/tantivy_index` или под `$XDG_CACHE_HOME`. Стереть каталог и выполнить `fr --rebuild`: индекс соберется заново.
Что происходит по Enter?
Программа передает управление исходному агенту и возобновляет выбранную сессию. Команду можно скопировать через `Ctrl+Y` и запустить вручную.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл поиска по прошлым сессиям: полнотекстовый индекс переписок Claude Code, Codex, pi и Grok в одной SQLite-базе
Локальный просмотр, поиск и учет расходов по сессиям Claude Code, Codex и других агентов в одном веб-интерфейсе
Команда /myoffice открывает в браузере «офис», где видно, чем занят каждый агент на машине: думает, ждет вас или закончил.
Менеджер сессий в терминале для Claude Code, Cursor CLI, Kiro CLI и Codex: названия, теги, проекты, поиск и возобновление.
MCP-сервер и CLI, которые находят в сессиях Claude Code и Codex, почему файл стал таким: кто и о чем просил агента, когда и что изменилось
Голосовое управление сессиями Claude Code и Codex на ваших машинах: агент на каждой машине связывает ее с облаком pitupitu.
Коротко о README
Короткий README объясняет задачу: у агентов есть возобновление, но поиск по прошлым сессиям слабый. Затем идут список возможностей, поддерживаемые агенты, установка через Homebrew, Nix, npm и `uv` и быстрый старт с примерами команд. Отдельный абзац посвящен использованию агентами через JSON, дальше ссылки на документацию.