Coding Agent Session Search (cass) CLI
CLI и TUI для поиска по локальной истории сессий Claude Code, Codex, Cursor, Gemini CLI и других агентов, с режимом --robot для самих агентов
- 1 196 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Читает локальную историю сессий всех агентов, а в ней бывают код, пути и секреты
- Строит индекс на диске, а команда cass `doctor` --fix перестраивает производные данные
- Синхронизирует сессии с других машин по SSH и rsync и скачивает модель с Hugging Face, но только по вашей команде
Установка
- Работает в
Ручная установка
brew install dicklesworthstone/tap/cassHomebrew-тап ставит готовые архивы для Linux и Apple Silicon macOS. Для Windows есть Scoop: scoop bucket add dicklesworthstone https://github.com/Dicklesworthstone/scoop-bucket, затем scoop install dicklesworthstone/cass.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает локальную историю сессий всех агентов, а в ней бывают код, пути и секреты
- Строит индекс на диске, а команда cass `doctor` --fix перестраивает производные данные
- Синхронизирует сессии с других машин по SSH и rsync и скачивает модель с Hugging Face, но только по вашей команде
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
cass — программа на Rust, которая собирает локальную историю сессий разных ИИ-агентов в один индекс и ищет по нему. В список источников входят Codex, Claude Code, Gemini CLI, Cline, OpenCode, Amp, Cursor, ChatGPT, Aider, GitHub Copilot, Goose и другие агенты из README. Форматы хранения у агентов разные (JSONL, SQLite, `markdown`), cass приводит их к общей схеме и показывает единой лентой. Человек работает в интерактивном TUI, агент вызывает `cass search ... --robot` и получает JSON, где у каждого попадания есть source_path и line_number для команды `cass view`. Источником истины служит SQLite, поисковый индекс при повреждении перестраивается из нее. Семантический поиск включается отдельной командой `cass `models` install`.
Для кого. Для разработчиков, которые работают с несколькими агентами и хотят находить прошлые решения, и для агентов, которым нужна справка из прошлых сессий проекта.
Подходит, если
- Нужно вспомнить, как две недели назад в Cursor решили похожую проблему, а сейчас вы работаете в Claude Code
- Агенту перед задачей нужна справка из прошлых сессий этого проекта: поиск с --workspace и --days
- Нужна текущая или последняя сессия рабочего каталога: `cass sessions --current --json`
- Надо искать по истории с ноутбука, настольного компьютера и серверов через SSH
- Шумного агента нужно убрать из индекса: `cass sources agents exclude openclaw`
Не подходит, если
- Нужна память проекта, которую агент пишет сам во время работы: cass только ищет по готовой истории
- Агент запускает команды без флагов: голый cass открывает интерактивный TUI и блокирует сессию
- Вы работаете на Intel macOS и не хотите собирать из исходников: готовые бинарники собраны для Linux и Apple Silicon
- Вы сотрудник OpenAI или Anthropic: лицензия не дает прав этим компаниям и действующим от их имени лицам
Пример запроса к агенту
Найди в истории моих сессий по этому проекту за последнюю неделю, как мы чинили регрессию производительности, и покажи место в сессииОграничения
Автор помечает статус проекта как `alpha`, а рецепт для агентов проверен на версии 0.8.0: на старых сборках флага --no-maintenance может не быть. Лицензия — MIT с оговоркой (rider): она не дает прав OpenAI, Anthropic, их аффилированным лицам и действующим от их имени людям без письменного разрешения автора. Готовые бинарники для Linux требуют `glibc` 2.28 и новее, на Intel macOS ставят скриптом с --from-source. Пока строится первый индекс, поиск идет только по словам без семантики. История сессий часто содержит код, пути и секреты, поэтому не отдавайте результаты поиска третьим сторонам. Для некоторых починок индекса нужна утилита sqlite3.
Как отключить. Удалите бинарник cass: после установки через Homebrew это `brew uninstall cass`. Каталог данных с индексом и базой SQLite (data_dir, описан в README) удаляется вручную.
Частые вопросы
Как искать по истории Claude Code и Codex через cass?
Установите cass и вызовите поиск с флагом --robot, например cass search "`performance` regression" --workspace /path/to/project --days 7 --mode `lexical` --robot. Ответ приходит в JSON, а нужное место открывает cass view с путем и номером строки из попадания.
Почему агенту нельзя запускать cass без флагов?
Голый cass запускает интерактивный TUI, который блокирует терминал сессии. Для агентов README требует --robot или --json: тогда stdout содержит только данные, а диагностика уходит в stderr.
Отправляет ли cass историю в сеть?
README заявляет, что все остается локально и ничего не уходит наружу. Сеть нужна только по вашей команде: cass `models` install скачивает модель с Hugging Face, а cass sources подключается по SSH и rsync к хостам, которые вы указали.
Какие агенты поддерживает cass?
Список в README длинный: Codex, Claude Code, Gemini CLI, Cline, OpenCode, Amp, Cursor, ChatGPT, Aider, GitHub Copilot Chat и CLI, OpenClaw, Goose, Hermes, Kimi Code, Qwen Code, OpenHands, Antigravity, Kiro CLI, Continue и другие.
Можно ли использовать cass в компании OpenAI или Anthropic?
Нет без письменного разрешения автора. Лицензия MIT дополнена оговоркой, которая лишает прав OpenAI, Anthropic, их аффилированные лица и людей, действующих от их имени.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI для мгновенного поиска по истории сессий кодинг-агентов на вашей машине, как git blame для сессий
CLI и скилл собирают историю сессий кодовых агентов в одну базу SQLite, по которой агент ищет прошлые решения
Локальный поиск по всей истории сессий Claude Code: решения, команды, значения переменных и уже написанный код через 13 MCP-инструментов
continues переносит сессию из Claude Code, Codex, Cursor и еще 13 агентов в любой другой: сообщения, правки файлов и команды уходят в новый агент
Индексирует сохраненные на диске сессии агентов (Claude Code, Codex, Cursor и еще 35 инструментов) и отдает нужное текущему агенту
CLI на Rust строит граф знаний о коде и решениях и через хуки Claude Code подает агенту нужный срез по ходу работы
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Coding Agent Session Search (cass) (эта запись) | нет | 1 196 | |
| Claude Code History Viewer | нет | 2 289 | настольное приложение для просмотра и анализа истории разговоров, без режима для агентов |
| Recall | нет | 764 | локальная память проекта для Claude Code: лог сессий и сжатое резюме, а не поиск по истории разных агентов |
| continues | нет | 1 584 | continues переносит сессию из Claude Code |
Коротко о README
README открывается установкой (скрипт для Linux, macOS и Windows, Homebrew, Scoop) и разделом «быстрый старт для агентов» с режимом --robot и примерами поиска. Дальше идут обоснование проекта, возможности, справочник по языку запросов и горячим клавишам, устройство индекса и его восстановление, синхронизация источников по SSH и справочник команд. Заканчивается README требованиями к системе, переменными окружения и разделом про диагностику.