Я работаю с OpenAI Codex в двух режимах. Дома — за мощным ПК с двумя экранами и в поездках на дачу/отдых/по работе — с ноутбука.

И довольно быстро столкнулся с неожиданной проблемой:
контекст, сессии и история Codex не синхронизируются между устройствами. OpenAI этого просто не предусмотрели!

В чём проблема

Если вы активно используете Codex, у вас постепенно накапливаются:

  • сессии (диалоги с агентом)

  • промежуточные состояния

  • контекст проекта

  • заметки и саммари

И всё это:

  • нельзя просто "подтянуть" с другого устройства

  • нельзя удобно объединить

  • нельзя нормально почистить (только архив)

В итоге:

Начал задачу на ПК → продолжить на ноутбуке уже нельзя

Почему так устроено

Судя по наблюдениям, Codex хранит состояние локально:

  • файлы сессий

  • служебные данные

  • возможно SQLite

Это даёт:

  • скорость

  • приватность

Но ломает мульти-девайс сценарий.

Простая идея решения

Вместо того чтобы бороться с Codex — можно принять его модель и работать поверх неё.

Идея максимально простая:

Синхронизировать папку состояния Codex между устройствами

Что я сделал

Я сделал небольшой CLI-инструмент — codexSync:

  • находит нужные папки Codex

  • синхронизирует их между устройствами

  • работает через любую папку (облако, NAS)

  • не лезет внутрь Codex

GitHub: https://github.com/kroxiksut/codexSync

PyPI: https://pypi.org/project/codexsync/

Как это работает

Схема максимально простая:

  1. Вы указываете:

    • где лежит состояние Codex

    • куда его синхронизировать

  2. Перед работой:

    • подтягиваете актуальное состояние

  3. После работы:

    • отправляете изменения

Минимальная инструкция для старта 

python -m codexsync init-config
или
python -m codexsync init-config --output D:\codexSync\config.toml

Отредактируйте файл конфига, укажите пути до директории .codex и директорию, в которая будет рабочей для утилиты. Можно настроить и другие параметры под себя в конфиг файле или оставить их по умолчанию.

Проверить правильность конфига можно командой

python -m codexsync -c config.toml validate

Далее можно посмотреть план, что утилита собирается сделать, сделать тестовый прогон без реальной записи и синхронизировать изменения


python -m codexsync -c config.toml plan
python -m codexsync -c config.toml sync --dry-run
python -m codexsync -c config.toml sync --apply

Почему не просто облако

Можно сказать:

"Закинь папку в Dropbox и всё"

Но на практике:

  • легко поймать конфликт файлов

  • нет контроля изменений

  • можно сломать состояние

codexSync добавляет:

  • предсказуемость

  • dry-run (plan)

  • контроль

Ограничения

Важно понимать:

  • это не официальное решение

  • нет realtime синка

  • нужно закрывать Codex перед синхронизацией, в том числе закрывая фоновый процесс. Если Codex не закрыт, сценарий синхронизации выполняться не будет. Если остался фоновый процесс - утилита предложит сама его завершить.

Помощь с тестированием

Хочу проверить, как инструмент ведёт себя в разных конфигурациях:

  • macOS ↔ macOS

  • macOS ↔ Windows

Если у вас есть возможность протестировать — буду очень благодарен за любой фидбек.

Остались вопросы, предложения, замечания, есть идеи по доработке? Пишите комментарии или в личку