CLEO — задачи, доказательства и память для агентов
CLEO
CLI для агентов: задачи с критериями приемки, доказательства готовности, память между сессиями и документация без дублей
- 159 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI меняет файлы проекта, ведет память и документацию и может закрывать задачи и собирать релиз из changeset
- Команда релиза публикует изменения, поэтому ее сначала запускают с флагом --dry-run
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/cleoОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI меняет файлы проекта, ведет память и документацию и может закрывать задачи и собирать релиз из changeset
- Команда релиза публикует изменения, поэтому ее сначала запускают с флагом --dry-run
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CLEO управляет рабочим процессом агента через одну команду `cleo`, и каждый вызов возвращает единый JSON-конверт в stdout, поэтому его читает любая оболочка агента. Работа устроена деревом: сага, эпики, задачи с критериями приемки и зависимостями, а сессии переживают прерывания. Задача считается сделанной, только когда доказаны ее условия: коммиты и файлы, прогон тестов или CI, линтер и проверка типов, привязанные к каждому критерию. Запрос на слияние называет свои задачи строкой `Closes: T003 AC1,AC2`, независимый ревьюер записывает вердикт по каждому критерию, слияние при зеленом CI закрывает задачу. Память BRAIN хранит наблюдения, решения и уроки и ищется между сессиями, команда `cleo briefing` готовит старт новой сессии. Отдельные блоки: документация с одним каноническим местом на каждый документ и проверкой дрейфа, граф символов Nexus с оценкой влияния правки (`cleo nexus impact`), выпуск релиза из changeset одной командой. Адаптеры описывают Claude Code, Codex, Cursor, Gemini, Kimi, OpenCode и другие, а навыки `ct-*` учат агента командам.
Для кого. Разработчикам и командам, которые поручают агентам длинные проекты и хотят видеть доказательства выполнения, а не слова «готово».
Подходит, если
- Проект длится недели, и агент теряет нить между сессиями, а вам нужен стартовый брифинг
- Агент докладывает «готово», а вы хотите привязать закрытие задачи к коммитам, тестам и CI
- Папка docs превращается в груду похожих документов, которые агенты продолжают плодить
- Релиз нужно собирать из changeset одной командой после зеленого CI
Не подходит, если
- Задача на пару файлов: дерево саг, критерии приемки и сессии избыточны для разового исправления
- Вам нужен только граф кода: для одной этой задачи легче взять отдельный инструмент вроде Arbor
- У команды нет привычки работать через запросы на слияние: основной путь CLEO построен на них
Пример запроса к агенту
Покажи, над чем работать дальше, открой фокус на задаче T003 и напомни, какие критерии приемки и какие доказательства для нее нужны.Ограничения
CLEO вводит собственные понятия (саги, эпики, ворота доказательств, BRAIN, Nexus) и дисциплину процесса, и освоение занимает время. Полная справка лежит в `cleo <команда> --help` и в документации репозитория. Для разработки самого проекта нужен Node.js 24.16 или новее и pnpm.
Основной путь закрытия задач связан с запросами на слияние и CI. Без запроса работает вариант с `cleo done --plan` и ручной фиксацией доказательств. Репозиторий очень активен, версии выходят часто, поэтому детали команд стоит сверять с текущей справкой. Лицензия MIT.
Как отключить. Удалите пакет командой npm uninstall -g @cleocode/cleo. Служебные данные проекта лежат в нем самом, при желании удалите их вместе с папкой, созданной командой cleo init.
Частые вопросы
Как начать работать с CLEO?
Поставьте пакет командой `npm install -g @cleocode/cleo`, в проекте выполните `cleo init` и `cleo session start`. Затем создайте сагу (`cleo saga create`), эпики и задачи командой `cleo add`, а следующий шаг подскажет `cleo next`.
Что такое ворота доказательств?
Условия, без которых задача не считается сделанной: коммиты и файлы, прогон тестов или CI, линтер и проверка типов. Каждое привязано к критерию приемки. Команда `cleo done <id> --plan` показывает, какое доказательство нужно каждому воротам.
Как CLEO борется с разрастанием документации?
Каноническое место документа хранится в хранилище, а файлы в `docs/` служат зеркалами. Перед записью новой страницы агент ищет существующую (`cleo docs query`), а команды `cleo docs status`, `cleo docs rot` и `cleo docs doctor` показывают и чинят дрейф.
Работает ли CLEO без запроса на слияние?
Да. Для задач без PR команда `cleo done T003 --plan` показывает, какое доказательство нужно каждому условию, фиксируется оно через `cleo verify`, а закрывает задачу `cleo complete T003`. Обычный путь все же идет через запрос на слияние со строкой `Closes: T003 AC1,AC2`.
Какие агенты поддерживаются?
CLEO отдает ответы одним JSON-конвертом в stdout, поэтому подходит любому окружению. Пакет адаптеров описывает Claude Code, Codex, Cursor, Gemini, Kimi, OpenCode и другие, а пакет навыков `ct-*` учит агента пользоваться командами.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI ee дает агентам постоянную локальную память: правила, решения и антипаттерны с оценками и ссылками на источники
Слой памяти и координации для кодовых агентов: спецификации и задачи лежат в git, а агенты работают параллельно
Compozy ведет сессии Claude Code, Codex и Cursor: доска задач, проверки по расписанию, вызов человека только по делу.
Оркестратор для агентов: рабочий процесс описывается кодом, каждый шаг проверяется, важные места требуют подтверждения человека, а решения пишутся в неизменяемы
CLI читает локальные сессии Claude Code, Codex и Hermes, находит повторяющиеся сбои и готовит правки на ручное ревью
Многоагентная обвязка с проверкой результата по артефактам: стоп-хуки, независимый судья и журнал событий для Claude Code, Codex, Cursor и других
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| CLEO — задачи, доказательства и память для агентов (эта карточка) | нет | 159 | ||
| Taskmaster | нет | не нужна | 28 354 | управление задачами по PRD для агентов, без ворот доказательств и документационной части |
| agentmemory | да | не нужна | 30 314 | отдельная память агента без задач и релизов |
Коротко о README
В README CLEO подан как слой работы, доказательств, памяти и документации для агентов. Таблица по областям, быстрый старт, подробный раздел о документации, список пакетов репозитория и правила разработки закрывают остальное. Лицензия MIT.