Ambient Project Layer — плагин
Пока идет работа в Codex, задачи, баги и решения сами попадают в Plane, а статусы меняются из панели прямо в диалоге.
- 86 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Плагин ставит хуки в Codex, которые выполняются на каждом шаге работы.
- Токен Plane с правом записи открывает изменение рабочих элементов проекта.
Установка
- Работает в
Ручная установка
codex plugin marketplace add "<RELEASE_DIR>"Сначала скачайте архив релиза под свою платформу и распакуйте. Затем `codex plugin add ambient-project-layer@ambient` и `codex plugin list`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин ставит хуки в Codex, которые выполняются на каждом шаге работы.
- Токен Plane с правом записи открывает изменение рабочих элементов проекта.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ambient Project Layer — плагин для Codex. Он выбирает из текущего хода работы события, важные для проекта: задачи, баги, решения, идеи, угрозы проекту, этапы, планы, прогресс и завершение. Сначала событие записывается в локальный Outbox на SQLite, затем асинхронно уходит в Plane. При первом входе в каталог проекта плагин показывает реальные проекты Plane, и человек сам выбирает привязку. В Codex открывается легкая панель: до пяти связанных рабочих элементов, фильтр по статусам Backlog, Todo, In Progress и Done и смена статуса меню или перетаскиванием. Полное управление проектом остается в Plane. Полные разговоры, исходный код, вывод терминала и ключ API плагин не сохраняет.
Для кого. Командам, которые ведут проект в Plane и работают с Codex, но не хотят вручную переносить задачи и решения из разговоров.
Подходит, если
- После длинной сессии в Codex остались баги и решения, которые надо занести в Plane.
- Нужно видеть в Codex ближайшие рабочие элементы проекта и менять их статус, не открывая браузер.
- Plane развернут у вас самостоятельно в Community Edition, и данные нельзя отдавать внешним трекерам.
- Сеть нестабильна, а события работы не должны теряться до синхронизации.
Не подходит, если
- Задачи ведутся не в Plane: плагин работает только с этим трекером.
- Работа идет не в Codex: плагин рассчитан только на него.
- Хук-скрипты нельзя доверять: без доверия хукам синхронизация не запустится.
Пример запроса к агенту
Покажи ближайшие рабочие элементы проекта в Plane и отметь баг про сохранение профиля как In Progress.Ограничения
Нужны Plane Cloud или собственный экземпляр, slug рабочего пространства и персональный токен с правом чтения и записи в целевом проекте. Токен хранится в пользовательском `~/.codex/config.toml` и передается серверу при запуске. После установки или обновления надо вручную проверить и доверить пять хуков: `SessionStart`, `UserPromptSubmit`, `PostToolUse`, `Stop` и `SessionEnd`. Статус плагина `enabled` не означает, что хуки доверены. Релиз скачивают под свою платформу, Windows ARM64 пока не поддерживается. Панель повторяет стиль Plane, но это не официальный компонент.
Как отключить. Удалите плагин командой Codex для плагинов и MCP-сервер `ambient-project`, а токен Plane отзовите в настройках Plane. Локальную базу `ambient.sqlite` удалите вручную.
Частые вопросы
Как установить Ambient Project Layer в Codex?
Скачайте архив релиза под свою платформу, распакуйте и выполните `codex plugin marketplace add "<RELEASE_DIR>"`, затем `codex plugin add ambient-project-layer@ambient`.
Нужно ли отдельно ставить Node.js?
Нет, пакет каждой платформы содержит собственный Node.js 22.22.1. Ставить Node, pnpm или bun не требуется.
Где хранится токен Plane?
В пользовательском `~/.codex/config.toml`: Codex подставляет его при запуске MCP-сервера `ambient-project`. Файл `.env` проекта плагин не читает.
Что делать, если хуки показаны как modified?
Откройте управление хуками Codex и заново доверьте каждый из пяти хуков. Статус `enabled` у плагина доверия не заменяет.
Что плагин сохраняет из моих разговоров?
События с ценностью для проекта в локальный SQLite Outbox. Полные разговоры, исходный код и вывод терминала не сохраняются.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныЛокальная доска задач с CLI taskctl и скиллом для Codex, Claude Code и других агентов: заводит issue, двигает статусы и хранит комментарии по правилам
Каркас проекта для Claude Code и Codex: задачи в файлах, роли разработчика и QA, ручное одобрение и общее состояние.
Скилл для Codex: безопасное обслуживание локального состояния, отчет без записи по умолчанию, бэкап и архив вместо удаления, чистка логов и воркстри
Несколько копий настольного Codex рядом: у каждого аккаунта свой значок, вход, чаты и плагины, переключаться не нужно.
Панель Claude Code для нескольких проектов: статусы, решения кнопками, Git, PR, CI и расход лимитов в одном окне.
CLI и приложение в меню macOS ведут отдельные профили Codex для личной и рабочей работы, с окнами, проектами и квотой у каждого.
Коротко о README
Платформы релизов: macOS на Apple Silicon и Intel, Linux x86_64 и ARM64, Windows x64. README доступен на китайском и английском.