Trellis CLI

Установка

Работает в

• Claude Code
• Cursor
• Codex
• OpenCode
• GitHub Copilot
• Gemini CLI
• Kiro
• Google Antigravity

npx skillfoxx add cli/trellis

Что делает

Trellis ставится из npm командой `npm install -g @mindfoldhq/trellis@latest`, после чего `trellis init` в корне репозитория создает папку `.trellis/` и файлы для выбранных агентов. В `.trellis/spec/` лежат правила проекта, в `.trellis/tasks/` задачи с требованиями и контекстом для реализации и проверки, в `.trellis/workspace/` личные журналы сессий каждого разработчика. Для Claude Code, Cursor, Codex, OpenCode и еще 18 платформ `trellis init` добавляет слэш-команды, скиллы, субагентов и хуки, а флаги вроде `--cursor` и `--codex` ограничивают список. Работа идет в четыре фазы. Скилл `trellis-brainstorm` задает по одному вопросу, пока требования не станут ясными, и пишет `prd.md`, а к реализации не переходит, пока пользователь не ответит хотя бы раз. Субагент `trellis-implement` пишет код, получая нужные правила из списков `implement.jsonl` и `check.jsonl`. Субагент `trellis-check` сверяет изменения со спецификациями, запускает линтер, проверку типов и тесты и сам правит найденное. Команда `/trellis:finish-work` архивирует задачу и дописывает журнал, а `trellis-update-spec` переносит новые выводы обратно в `.trellis/spec/`. В Claude Code хуки на python3 срабатывают при старте, очистке и сжатии сессии и перед запуском субагента: они подставляют контекст. Рядом идут служебные команды: `trellis mem` ищет по истории разговоров в Claude Code, Codex, OpenCode и Pi, `trellis channel` запускает рабочих агентов отдельными локальными процессами с журналом событий, `trellis update` обновляет файлы после выхода новой версии.

Для кого. Для разработчиков и команд, которые работают с несколькими ИИ-агентами в одном репозитории и хотят хранить правила, задачи и память сессий рядом с кодом.

Пример запроса к агенту

Хочу добавить в проект выгрузку отчета в PDF. Начни с брейншторма, задавай вопросы по одному и переходи к коду только после моего согласия

Ограничения

Лицензия AGPL-3.0. Нужны Node.js от 18 и Python от 3.9.

• Журналы и архив задач скрипты коммитят в git сами. Чтобы отключить это, поставьте `session_auto_commit: false` в `.trellis/config.yaml`.
• Папка `.trellis` может хранить чувствительный текст задач и спецификаций. Команда `trellis ablate` кладет копию ее содержимого вне проекта и держит ее до успешного `trellis restore`.
• Если файл, которым управляет Trellis, изменили, пока проект «разобран», `trellis restore` отказывается писать, пока вы не разрешите конфликт.
• Набор файлов зависит от платформы: для Copilot создаются хуки, для Pi и Oh My Pi расширения, а для остальных платформ команды или скиллы. Полный список выводит `trellis platforms`.
• Версия 0.x: формат файлов меняют миграции, `trellis update --migrate` применяет их.

Как отключить. Переменная `TRELLIS_HOOKS=0` отключает только хуки. `trellis ablate` временно убирает все файлы Trellis из проекта для сравнения, `trellis restore` возвращает прежнее состояние. `trellis uninstall` насовсем удаляет файлы платформ и `.trellis/`; сначала запустите его с `--dry-run`, чтобы увидеть список.

Коротко о README

Описание есть на английском и китайском. Сначала таблица возможностей, потом требования, три команды быстрого старта и четыре шага работы. Дальше схема цикла из четырех фаз, таблица ссылок на документацию на сайте docs.trytrellis.app и раздел вопросов, где разобраны отличия от файлов с правилами и временное отключение Trellis. В репозитории рядом с пакетом лежат проект самого Trellis с его собственными спецификациями и задачами, набор тестов на vitest и журнал миграций по версиям.