Типичная проблема человека, который активно работает с несколькими ИИ-агентами локально: проекты разбросаны по разным машинам, инструкции для агентов хранятся в разных форматах, а актуальная версия файлов неизвестна. Автор ИИ Workspace System описывает собственный сценарий — MacBook Air M4 в поездках и стационарный ПК под Ubuntu 24.04 дома, плюс одновременно открытые 6–10 окон Claude Code и Codex в терминале. До появления системы синхронизация шла через зип-архивы в Избранном Telegram.
ИИ Workspace System — это не новая IDE и не платформа для оркестрации агентов. Это тонкий слой инфраструктуры поверх Git и GitHub: набор shell-скриптов, соглашений об именовании файлов и Markdown-документации. Главная идея — все проекты видны из одного интерактивного списка, инструкции для агентов устроены одинаково, а синхронизация безопасна по умолчанию.
Центральный элемент — команды ИИ-launch codex и ИИ-launch claude. При запуске агент не стартует в случайной директории: сначала появляется список проектов из PROJECT_ROOTS с пунктами «New project» и «No project» вверху. Первый создаёт новый репозиторий по шаблону с базовыми README.md, AGENTS.md, CLAUDE.md, workspace.yaml и.gitignore. Второй запускает агента без проектного контекста — для разовых вопросов.
Единый launcher ИИ-launch codex / ИИ-launch claude показывает интерактивный список проектов с возможностью создать новый по шаблону.
Для инструкций агентам принят единый формат: AGENTS.md — канонический файл с общими правилами проекта, CLAUDE.md импортирует его через директиву @AGENTS.md и содержит только специфику Claude Code. Это позволяет переиспользовать одни и те же инструкции в разных агентах без дублирования.
Особого внимания заслуживает логика синхронизации. workspace-sync намеренно консервативен: он делает fetch, подтягивает только чистые worktree и пушит только уже закоммиченные изменения. Репозитории с незакоммиченными изменениями пропускаются. Это принципиально: агент может оставить проект в промежуточном состоянии, и автоматический scheduled sync не должен публиковать этот черновик. Плановая синхронизация настроена через user-level systemd timer на 13:00, 19:00 и 23:50.
Система также разграничивает собственные репозитории и внешние upstream. Если origin принадлежит аккаунту или организации пользователя на GitHub, scheduled sync может туда пушить. Если origin внешний — например, репозиторий стороннего сайта — автоматический пуш идёт только в отдельный backup-remote. Пуш в upstream требует явного действия. Автор приводит практический пример: он работает с контентом сайта cozystack.io, хранящегося в репозитории cozystack/website, и держит инструкции для агента (правила структурирования анонсов, оформления врезок, расстановки изображений) отдельно от самого репозитория сайта.
Для первичной инвентаризации существующих проектов предусмотрен отдельный промпт discover-and-normalize-local-projects.md. Его можно передать Codex или Claude Code: агент проведёт инвентаризацию домашней директории, классифицирует каталоги, предложит план переноса и после подтверждения добавит базовые файлы документации и инициализирует Git там, где это уместно. Секреты, кэши, логи и сессии агентов при этом не трогаются.
Проект опубликован под лицензией Apache 2.0, принимает форки и issues. Автор честно оговаривается: часть документации написана GPT, а сама система — переизобретённый велосипед, который тем не менее решает конкретную задачу для непрограммистов, активно использующих ИИ-агенты в редакторской, маркетинговой и менеджерской работе.
