wallfacer CLI
Менеджер сессий в терминале для Claude Code, Cursor CLI, Kiro CLI и Codex: названия, теги, проекты, поиск и возобновление.
- 117 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Подкоманда `rm --purge` удаляет сессию навсегда.
- Программа читает все файлы сессий агентов, а в них лежат ваши запросы и фрагменты кода.
Установка
- Работает в
Ручная установка
brew tap pradipta/wallfacer https://github.com/pradipta/wallfacer
brew install pradipta/wallfacer/wallfacerПервый вариант Install из README для macOS и Linux. Альтернатива: `go install github.com/pradipta/wallfacer@latest`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Подкоманда `rm --purge` удаляет сессию навсегда.
- Программа читает все файлы сессий агентов, а в них лежат ваши запросы и фрагменты кода.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
wallfacer собирает в одном списке все сессии четырех CLI-агентов: Claude Code, Cursor CLI, Kiro CLI и Codex. Claude Code хранит разговоры безымянными JSONL-файлами в `~/.claude/projects/`, остальные агенты прячут их по своим папкам. wallfacer читает эти файлы без изменений, а названия, теги и проекты ведет в своей локальной базе SQLite. Команда `wallfacer` без аргументов открывает полноэкранный браузер сессий с фильтрами по проекту, тегу и агенту. Те же действия есть подкомандами: `new`, `resume`, `list`, `search`, `show`, `rename`, `tag`, `project` и `rm`. У `list` есть флаг `--json` для скриптов, а `rm` отправляет сессию в корзину, и только `--purge` удаляет ее навсегда.
Для кого. Пользователям, у которых накопились десятки безымянных сессий Claude Code или Codex и нужен способ найти и продолжить нужную.
Подходит, если
- Через пару недель работы в терминале не удается найти разговор, где чинили тесты авторизации.
- Сессии возобновляют из разных каталогов, и хочется одного входа вместо `cd` и поиска вручную.
- Скрипт перечисляет сессии проекта в формате JSON.
- Claude Code и Codex работают параллельно, и история обоих нужна в общем списке.
Не подходит, если
- Сессии надо синхронизировать между компьютерами: база хранится локально.
- Работа идет в агенте без адаптера: opencode пока только в планах.
- Нужен поиск по тексту всего разговора: wallfacer ищет по названиям, первым запросам, каталогам, проектам и тегам.
Пример запроса к агенту
Покажи в JSON сессии проекта api с тегом auth и открой ту, где мы чинили нестабильные тесты авторизации.Ограничения
Поддерживаются четыре агента: Claude Code, Cursor CLI, Kiro CLI и Codex, адаптер opencode остается в планах. Названия, теги и проекты лежат в локальной SQLite-базе wallfacer и на другой компьютер не переносятся. Установка через Go требует Go 1.22 или новее. Формула Homebrew хранится прямо в репозитории, поэтому адрес тапа указывают явно. Если вывод идет не в терминал, голая команда `wallfacer` печатает справку вместо браузера.
Как отключить. Удалите программу тем же способом, каким ставили: через Homebrew или Go. Локальную базу с названиями и тегами удалите отдельно. Файлы сессий агентов wallfacer не меняет.
Частые вопросы
Меняет ли wallfacer файлы сессий агентов?
Нет, индексация только читает их. Названия, теги и проекты хранятся в собственной базе SQLite.
Как возобновить сессию по названию?
Выполните `wallfacer resume "fix flaky auth tests"` или передайте префикс идентификатора. Сессия откроется в исходном каталоге.
Что происходит при удалении сессии?
`wallfacer rm <ref>` отправляет ее в корзину. Безвозвратно удаляет только флаг `--purge`.
Как найти нужную сессию?
В браузере нажмите `/` для нечеткого фильтра или выполните `wallfacer search auth`. Поиск идет по названиям, первым запросам, каталогам, проектам и тегам.
Какие агенты поддерживает wallfacer?
Claude Code, Cursor CLI, Kiro CLI и Codex. Агента выбирают при запуске новой сессии, потом по нему можно фильтровать список. Адаптер opencode остается в планах.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТерминальный поиск по истории сессий Claude Code, Codex, OpenCode и других агентов с возвратом в нужный разговор
tmux-claude-hatch — Claude Code во всплывающем окне tmux
tmux-claude-hatch
Плагин tmux запускает сессию Claude Code во всплывающем окне на каждый проект и показывает статус всех агентов в списке fzf
Терминальный менеджер сессий Claude Code: статус каждой сессии, расход токенов по моделям и проектам, сводки сразу после выхода.
Панель и JSON-CLI следят за сессиями Claude Code, Codex, Cursor Agent и Pi: кто ждет разрешения, кто работает, кто простаивает.
Скилл поиска по прошлым сессиям: полнотекстовый индекс переписок Claude Code, Codex, pi и Grok в одной SQLite-базе
Локальный просмотр, поиск и учет расходов по сессиям Claude Code, Codex и других агентов в одном веб-интерфейсе
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| wallfacer (эта карточка) | нет | 117 | |
| fast-resume | нет | 190 | fast-resume ищет по истории сессий и возвращает в разговор; wallfacer добавляет названия, теги, проекты и подкоманды с `--json` |
| Coding Agent Session Search (cass) | нет | 1 200 | cass строит поиск по истории сессий; wallfacer ведет собственные названия, теги и проекты и запускает новые сессии |
Коротко о README
Один бинарный файл с двумя интерфейсами: полноэкранный браузер и подкоманды для скриптов. Оба работают с одним индексом, поэтому тег из браузера сразу виден в `wallfacer list --tag`. Агенты подключаются адаптерами, как добавить новый, описано в `docs/adding-an-agent.md`.