CatchUp CLI
CLI передает контекст сеанса между кодовыми агентами: сессию Claude Code можно продолжить в Codex, Cursor, OpenCode и других.
- 83 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Инструмент читает журналы сессий агентов с вашего диска, в них бывают секреты и личные данные
- `catchup fork` запускает другого агента с расшифровкой прежней сессии
Установка
- Работает в
Ручная установка
brew install wilbeibi/tap/catchupДополнительно: `curl -fsSL https://catchup.pages.dev/install.sh | sh` или `go install github.com/wilbeibi/catchup@latest`. Затем `catchup install-skill` для скилла.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент читает журналы сессий агентов с вашего диска, в них бывают секреты и личные данные
- `catchup fork` запускает другого агента с расшифровкой прежней сессии
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
catchup читает локальную сессию агента в чистый Markdown, а команда `catchup fork` продолжает работу в том же агенте или в другом. Типичный случай: у Claude Code кончился лимит, и `catchup fork --into codex` запускает Codex с расшифровкой прежней сессии. Поддерживаются Claude Code, Codex, Copilot CLI, Cursor, Cline, Kimi, Antigravity, OpenCode, Pi Agent, ZCode, Grok Build, Grok Bot, DeepSeek Harness и Amp. Для вас есть `catchup --list` со списком недавних сессий всех агентов и `catchup --all-dirs -q "cache"` для поиска по проектам. Для агентов внутри сессии есть режим `--agent` с провалившимися вызовами инструментов, ключи `--last 4` и `--since-compact`, а также вывод в JSON и HTML. Команда `catchup install-skill` ставит скилл, и агент сам читает прошлую работу по просьбе «вспомни последнюю сессию».
Для кого. Тем, кто переключается между Claude Code, Codex, Cursor и другими агентами и не хочет заново объяснять задачу.
Подходит, если
- Агент упирается в лимит использования, и работу надо подхватить в другом агенте с тем же контекстом
- Контекст сессии забит, а работа не закончена: нужен перезапуск с урезанной расшифровкой через `--since-compact`
- Надо найти старую работу по ключевому слову во всех проектах и агентах
- Нужна чистая запись того, что происходило в сессии, в Markdown или HTML
Не подходит, если
- Нужно слить истории нескольких агентов в одну: инструмент работает с одним агентом за раз и не объединяет истории
- Нужно сохранить внутреннее состояние при переходе между разными агентами: кросс-агентный `fork --into` передает только расшифровку
- Нужна работа с Amp, Kimi, ZCode или DeepSeek Harness как цель запуска: их нельзя открыть интерактивно, расшифровку сохраняют и открывают вручную
Пример запроса к агенту
Вспомни последнюю сессию Claude Code в этой папке и продолжи ее: что уже сделано, что осталось и какие команды падали.Ограничения
Инструмент читает локальные журналы сессий и только читает, кроме команды `fork`. Расшифровка не содержит успешных вызовов инструментов и рассуждений, остаются лишь вызовы, которые журнал пометил как неудачные. Для Cursor доступны история CLI и IDE, но границы уплотнения и сигналы остановки API недоступны. У Amp читается только локальный кэш, облачные потоки без кэша не видны. Для Grok Bot нет локального каталога проекта, а кэш может опускать старые сообщения.
Как отключить. Удалите бинарный файл `catchup`: `brew uninstall catchup` либо вручную, в зависимости от способа установки. Скилл, поставленный командой `catchup install-skill`, лежит в каталоге скиллов агента и удаляется оттуда.
Частые вопросы
Как установить catchup?
Через Homebrew: `brew install wilbeibi/tap/catchup`. Либо готовый бинарный файл командой `curl -fsSL https://catchup.pages.dev/install.sh | sh`, либо `go install github.com/wilbeibi/catchup@latest`. Для Windows есть сборки на странице релизов.
Как передать сессию Claude Code в Codex?
Выполните `catchup fork claude --into codex`. Codex стартует с расшифровкой сессии Claude. Без указания агента берется тот, у которого самая свежая сессия в этой папке.
Чем fork отличается от fork --into?
`fork` продолжает работу тем же агентом и сохраняет его родное состояние сессии. `fork --into` запускает другого агента с расшифровкой или того же агента с чистым контекстом, если указать `--last` или `--since-compact`.
Как найти старую работу?
Команда `catchup --all-dirs -q "cache"` ищет по проектам и агентам, а `catchup --list` показывает недавние сессии. Результат выбирают по рангу или по стабильному идентификатору через `--id`.
Меняет ли инструмент мои сессии?
Нет, кроме `fork`: все остальное только читает локальные журналы. Расшифровки и вывод в Markdown не содержат успешных вызовов инструментов и рассуждений.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI на fzf показывает сессии Claude Code, Codex и еще шести агентов по всем проектам и возобновляет выбранную в ее каталоге.
CLI превращает сессию кодинг-агента в страницу с разговором, инструментами и патчем, которую можно передать коллеге.
Agent Standup показывает сессии Claude Code, Codex и Mistral Vibe как живой созвон команды: кто работает, кто ждет.
Закладки на сессии кодовых агентов: сохранить под названием проекта, найти позже и получить команду возврата с папкой.
Локальный поиск по всем сессиям кодинг-агентов с возвратом в нужный CLI и статистикой расхода токенов.
Плагин для Claude Code вместо автосжатия пишет передаточную записку, очищает сессию и продолжает работу с нее
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| CatchUp (эта карточка) | нет | 83 | |
| agent-manager | нет | 691 | TUI на tmux, который держит агентов в одном списке со статусами, а не переносит контекст между ними |
| Table Skills: project-handoff | нет | 463 | скилл сохраняет цели, решения и следующий шаг в PROJECT_STATE.md без чтения журналов сессий |
Коротко о README
Страница показывает два сценария: после упора Claude Code в лимит одна команда передает сессию Codex, а для старой работы поиск по ключевому слову открывает нужную. Далее установка, использование для человека и для агентов, особенности каждого поддерживаемого агента, границы инструмента и рецепт отображения квоты.