Разработчики выпустили инструмент CodeAlmanac — живую вики прямо в репозитории, которую ведут AI-агенты. Это не ещё один сервис в облаке, а обычные Markdown-файлы в папке almanac/, которые индексируются локально и живут в Git наравне с кодом. Вики хранит то, что не видно из кода: почему система устроена так, а не иначе, что ломалось раньше, какие инварианты важны, как воркфлоу пересекают файлы и сервисы.
Работает на macOS с Codex или Claude Code, нужен Python 3.12+. Установка одной командой через uv tool install codealmanac@latest, дальше codealmanac setup. После инициализации в репозитории (codealmanac init) появляется структура almanac/ с topics.yaml, папками architecture/, decisions/, guides/ и README-файлами для каждой секции. Читать вики можно из терминала (codealmanac search, codealmanac show) или через локальный веб-вьюер (codealmanac serve).
Главная фишка — фоновые задачи на launchd. Sync каждые 5 часов сканирует недавние диалоги с Codex и Claude, извлекает из них полезное знание и добавляет в вики. Garden раз в сутки чистит вики: убирает устаревшие страницы, дубликаты, слабые связи. Update раз в сутки обновляет CLI, если это безопасно. Всё работает локально, никакого облака.
Для записи (команды ingest, garden) нужен аутентифицированный AI-раннер — Codex или Claude. Setup может установить агентские инструкции для обоих, у них переиспользуются существующие OAuth-сессии. Жизненные циклы агентов работают через публичный Yoke SDK, доверие к ним такое же, как к локальному инструменту — граница вики соблюдается инструкциями и коммит-политикой, а не OS-песочницей.
Телеметрия по умолчанию включена, но шлёт только обезличенные данные: что команда выполнилась или упала, случайный UUID установки. Никакого кода, путей, промптов, транскриптов или креда. Отключить можно на setup флагом --no-telemetry или в конфиге.
Старая npm-версия codealmanac больше не поддерживается — миграция на PyPI. Если стояла, надо удалить глобальный пакет и переустановить через uv. Все старые almanac/ в репозиториях остаются как есть, они не часть CLI.
Пока это только локальный инструмент. Никакого хостинга, SDK, MCP-пакета или альтернативных корней вики. Расширения в будущем возможны, но текущий релиз — чисто про локальную Markdown-вики, которую ведут сами AI-агенты.