codex-threadkeeper CLI
Утилита возвращает в Codex пропавшие после смены провайдера диалоги: синхронизирует сессии и SQLite, делает резервные копии.
- 106 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Утилита изменяет служебные файлы и базу SQLite внутри `~/.codex`
- На несовместимой версии Codex правка состояния может дать неверный результат
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/codex-threadkeeperОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Утилита изменяет служебные файлы и базу SQLite внутри `~/.codex`
- На несовместимой версии Codex правка состояния может дать неверный результат
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
После переключения `model_provider` старые диалоги Codex могут остаться на диске, но исчезнуть из Codex CLI и приложения: пропадают проекты в боковой панели, а `codex resume` и приложение показывают разное. Утилита `codex-threadkeeper` синхронизирует то, от чего зависит новая версия Codex: файлы в `~/.codex/sessions` и `~/.codex/archived_sessions`, базу `state_5.sqlite` (основную и запасную), `.codex-global-state.json` и управляемые резервные копии в `~/.codex/backups_state/threadkeeper`. Запуск без установки: `npx codex-threadkeeper sync`. После синхронизации нужно перезапустить Codex, чтобы приложение перечитало индекс. По умолчанию команды `sync` и `switch` чинят боковую панель по текущим метаданным Codex, а старый список закрепленных проектов можно вернуть вручную через `pin-project` и `--restore-pinned-projects`. Совместимость заявлена с `@openai/codex` 0.142.0.
Для кого. Пользователи Codex, которые переключают провайдеров моделей и потеряли из виду историю сессий и проекты в боковой панели.
Подходит, если
- После смены `model_provider` история диалогов в приложении Codex пуста.
- `codex resume` показывает одни сессии, а приложение другие.
- Проекты в боковой панели исчезли после обновления Codex.
- Перед правкой состояния нужна резервная копия сессий и базы.
Не подходит, если
- Версия Codex заметно новее заявленной: структура состояния могла измениться.
- Нужен просто перенос диалогов между машинами, а не исправление индекса.
- Править файлы `~/.codex` нельзя без ручного бэкапа.
Пример запроса к агенту
Используй heyroute-ai/codex-threadkeeper и восстанови историю сессий Codex, затем напомни перезапустить приложение.Ограничения
Утилита правит служебные файлы Codex, поэтому работает только на совместимых версиях: заявлена `@openai/codex` 0.142.0 от 23 июня 2026 года, для более новых проверьте поддержку. Нужен Node.js 24 или новее. Перед запуском закройте Codex, а после синхронизации перезапустите его. В README большой блок рекламирует сторонний сервис API HeyRoute и его цифры скорости, к самой утилите он не обязателен. Документация на китайском с английской версией. Последнее обновление репозитория датировано 24 июля 2026 года, лицензия MIT.
Как отключить. Удалите глобальный пакет командой `npm uninstall -g codex-threadkeeper`, если ставили его. Резервные копии в `~/.codex/backups_state/threadkeeper` остаются, удалите их вручную.
Частые вопросы
Какую проблему решает утилита?
Старые диалоги остаются на диске, но не видны в Codex CLI и приложении после смены `model_provider`; утилита выравнивает индекс.
Что она синхронизирует?
Файлы сессий и архива, базу `state_5.sqlite`, `.codex-global-state.json` и управляемые резервные копии.
Нужна ли установка?
Нет, подойдет `npx codex-threadkeeper sync`. Для частого использования есть `npm install -g codex-threadkeeper`.
Что делать после синхронизации?
Перезапустить Codex, чтобы приложение перечитало обновленный индекс истории.
Обязателен ли HeyRoute?
Нет. Утилита работает с любым провайдером, а блок про HeyRoute в README лишь рекламный.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл для Codex: безопасное обслуживание локального состояния, отчет без записи по умолчанию, бэкап и архив вместо удаления, чистка логов и воркстри
CLI и приложение в меню macOS ведут отдельные профили Codex для личной и рабочей работы, с окнами, проектами и квотой у каждого.
Codex Relay дает следить за сессиями Codex CLI и отвечать агенту с телефона, пока работа остается на компьютере.
Плагин и MCP-инструменты показывают, куда в Codex уходят токены, время, кредиты и деньги, по локальным метаданным сессий.
CLI показывает расход лимитов Codex и число ручных сбросов, а по явному подтверждению тратит один сброс.
Несколько копий настольного Codex рядом: у каждого аккаунта свой значок, вход, чаты и плагины, переключаться не нужно.
Коротко о README
README советует вставить в окно Codex готовую просьбу, по которой агент сам запустит синхронизацию, и перечисляет файлы состояния, которые затрагивает утилита.