Современные AI-кодинговые инструменты, такие как Codex (десктопное приложение и CLI от OpenAI), значительно ускоряют разработку. Однако при интенсивном использовании — длинные чаты, множественные репозитории, открытые терминалы, dev-серверы и работа над несколькими проектами одновременно — локальное состояние приложения накапливает «тяжесть». Это проявляется в замедлении интерфейса, росте баз данных чатов, накоплении worktree, логов и устаревших ссылок в конфигурации.
Репозиторий keep-codex-fast (автор: vibeforge1111) предлагает специализированный skill (навык) для Codex, который решает эту проблему безопасным, «backup-first» способом. Основная идея — не удалять, а архивировать, предварительно создавая handoff-документы (документы передачи контекста), чтобы ничего важного не потерять.
Этот навык превращает очистку в скучную еженедельную рутину, а не в стрессовый аварийный ремонт.
Проблема, которую решает навык
При долгой работе в Codex:
- Чаты растут в сотни тысяч токенов.
- Worktree (рабочие деревья) множатся.
- Логи (logs_2.sqlite*) занимают гигабайты.
- Появляются «мёртвые» записи в config.toml.
- На Windows возникают проблемы с длинными путями (\\?\C:\...).
- Приложение становится медленнее, менее отзывчивым, иногда «хрупким».
Навык диагностирует эти узкие места, предлагает план действий и выполняет очистку только после явного подтверждения пользователя. По умолчанию он работает в режиме report-only (только отчёт).
Основной принцип: "Make handoffs first. Archive, don't delete."
Это ключевое правило навыка. Перед любой архивацией старых чатов создаётся handoff-документ — компактный файл с continuity (непрерывностью работы).
Что включает хороший handoff:
- Путь к репозиторию и ветка.
- Текущая цель проекта.
- Что уже сделано.
- Ключевые файлы, которые трогали.
- Выполненные команды и тесты.
- Известные ошибки и warnings.
- Открытые решения и open questions.
- Ограничения, предпочтения пользователя, «do-not-touch» зоны.
- Следующие 3–7 конкретных шагов.
- Reactivation prompt — готовый промпт для запуска свежего чата.
Такой подход разделяет роли:
- Чаты — для исполнения (execution).
- Handoff-документы — для памяти (memory).
- Архивы — для истории.
- Свежие треды — для скорости.
Как работает keep-codex-fast
1. Установка
Install the keep-codex-fast skill from https://github.com/vibeforge1111/keep-codex-fast
Или склонируйте репозиторий в директорию skills Codex.
2. Быстрый старт
Просто спросите Codex:
Use $keep-codex-fast to inspect my Codex local state and recommend a safe cleanup plan.
3. Рекомендуемый workflow
- Запустите отчёт (report-only).
- Создайте handoff-документы для активных репозиториев, которые планируете продолжать.
- Просмотрите отчёт и решите, что архивировать.
- Закройте Codex перед применением изменений.
- Выполните безопасную очистку:Use $keep-codex-fast to apply safe cleanup.
- Проверьте результат повторным отчётом.
- Настройте еженедельный/раз в две недели report-only reminder.
Что именно очищает навык
- Старые не-закреплённые (non-pinned) сессии → перемещаются в ~/.codex/archived_sessions/.
- Устаревшие worktree → в ~/.codex/archived_worktrees/.
- Большие лог-файлы (logs_2.sqlite*) → ротация в архив.
- Мёртвые/временные записи проектов в config.toml.
- Проблемы с расширенными путями на Windows в SQLite.
Важно: ничего не удаляется навсегда. Создаются бэкапы (в ~/Documents/Codex/codex-backups/), манифесты и скрипты восстановления.
Безопасность и лучшие практики
Навык следует строгим правилам безопасности:
- Всегда бэкап перед изменениями.
- Архивация вместо удаления.
- Не трогает auth-файлы.
- Не убивает процессы Node/dev-серверов (только сообщает).
- Mutating-операции только после закрытия Codex.
- Автоматизация только report-only (нельзя надёжно проверить наличие handoff’ов в авто-режиме).
Рекомендуемая частота: еженедельно при тяжёлом использовании, раз в две недели при умеренном.
Преимущества и нюансы
Плюсы:
- Значительное ускорение работы приложения.
- Сохранение всего важного контекста.
- Формирование полезной привычки документирования.
- Снижение риска потери данных.
- Работает как на десктопе, так и с CLI.
Возможные нюансы и edge-кейсы:
- Для критически важных долгоживущих проектов handoff нужно делать вручную или с помощью навыка.
- На очень больших рабочих пространствах первый отчёт и очистка могут занять время.
- Пользователи Windows получат дополнительную пользу от нормализации путей.
- Автоматизация мутирующей очистки не рекомендуется — лучше оставлять под человеческим контролем.
Заключение: Почему это важно в эпоху AI-кодинга
По мере роста мощности моделей локальное состояние становится основным bottleneck. Keep-codex-fast учит не просто «чистить», а управлять контекстом осознанно. Переход от гигантских чатов к свежим тредам + durable handoff-документам делает работу с AI более масштабируемой, предсказуемой и приятной.
Этот навык — отличный пример «meta-инструмента»: он помогает самому инструменту (Codex) оставаться эффективным в долгосрочной перспективе.
Ссылка на репозиторий: https://github.com/vibeforge1111/keep-codex-fast