Возможности
Creo — опенсорсный AI-агент для разработки. Ниже — полный список возможностей с точки зрения пользователя.
Модели и провайдеры
- Любая OpenAI-совместимая модель. OpenAI, DeepSeek, GLM, vLLM, Together, Fireworks — всё, что поддерживает OpenAI
Chat Completions API. Достаточно указать
base_urlи API-ключ. - Локальная Ollama. Подключение к локальному Ollama-серверу без облачных ключей. Полная поддержка Ollama-специфичных
параметров (
top_k,repeat_penalty). - Несколько моделей одновременно. Можно настроить сколько угодно моделей в конфиге и мгновенно переключаться между
ними командой
/modelили через агента в чате. - Настройка параметров генерации. Temperature, top_p, top_k, frequency_penalty, presence_penalty, repeat_penalty — индивидуально для каждой модели.
- Ручной лимит контекста. Поле
context_lengthпереопределяет значение, получаемое от API провайдера — полезно, когда провайдер не отдаёт корректный размер контекста. - Мастер конфигурации при первом запуске. Интерактивный wizard последовательно запрашивает тип провайдера, модель, API-ключ, base URL и отображаемое имя — конфиг готов в 6 шагов.
- Управление конфигурацией через агента. Попросите в чате «поменяй текущую модель на default» или «установи locale в
en» — агент прочитает или изменит
config.jsonчерез инструментupdate_config. API-ключи маскируются как***при чтении — агент видит, что ключ задан, но не может его прочитать.
Dual-model архитектура
- Две модели для разных задач.
current— для интерактивных сессий с пользователем.mini— для фоновых задач: автоименование сессий, dreaming-ревизия, компактизация контекста. - Оптимизация стоимости. Используйте дорогую мощную модель для кодинга и дешёвую — для рутинных фоновых задач. Например: GPT-4o для работы и GPT-4o-mini для фоновой ревизии.
- Локальная + облачная. Локальная Ollama для интерактивной работы (бесплатно, приватно) и облачная модель для фоновых задач которые требуют качества — или наоборот.
- Независимая настройка. Каждая модель имеет свои параметры генерации, провайдера, API-ключ. Переключение
currentчерез/modelне влияет наmini. - Автоименование через
mini. Мини-модель автоматически генерирует краткое описание сессии по транскрипту. Обновляется каждые 20 диалоговых сообщений. Ручное переименование через/rename— автоматическое никогда не перезапишет.
Самообучение агента
Creo — самообучающийся агент. Он ревизирует свои прошлые сессии в фоне, извлекает знания в память, создаёт навыки и накапливает проектные инструкции. С каждым использованием агент становится умнее.
- Память между сессиями. Агент «помнит» факты о пользователе (предпочтения, стиль работы) и проекте (конвенции, архитектура, договорённости). Скажите «запомни, что я предпочитаю tab-size 4» — и агент не забудет это в следующей сессии. Факты загружаются в каждый новый контекст автоматически.
- Dreaming — фоновая ревизия. Каждые 30 минут планировщик обрабатывает до 5 необработанных сессий через мини-модель. Ревьюер анализирует: что было сделано, что получилось, что можно улучшить.
- Автоскиллы. В результате ревизии агент создаёт или улучшает собственные навыки на основе обнаруженного опыта. Навык «как мы деплоим в этом проекте» или «какие команды линтера мы используем» — формируется автоматически, без ручного написания.
- Проектные инструкции (.creo/AGENTS.md). Dreaming накапливает проектные конвенции в
.creo/AGENTS.md— этот файл загружается в системный промпт ПОСЛЕ корневогоAGENTS.md, дополняя но не переопределяя правила пользователя. build-команды, lint-настройки, архитектурные паттерны — всё что агент узнал о проекте. - Безопасный ревьюер. Ревьюер работает с урезанным набором инструментов: только чтение файлов, память, skill-creator и projectrules. Не может изменять файлы проекта или запускать команды.
- Тихий режим. Ревизия не отображается в основном чате — результаты накапливаются в памяти, навыках и проектных инструкциях. Вы просто замечаете, что агент со временем лучше понимает ваш проект.
- Ручной запуск. Команда
/dreamingзапускает ревизию текущей сессии прямо в TUI — не нужно ждать 30 минут.
Checkpoint-based undo
Каждое изменение файлов агентом автоматически снимается как git-снимок. Откат в один клик. Это не просто «git integration» — это safety net, который делает YOLO-режим безопасным.
- Автоматические чекпоинты. Каждое действие агента с файлами (write, edit, terminal-команда) снимается как git-snapshot tracked файлов. Не нужно думать об откате заранее — чекпоинты создаются сами.
- Откат к любому чекпоинту. Агент может показать все доступные чекпоинты (
checkpoint_list) и откатиться к любому, не только к последнему. Команда/rollbackоткатывает к последнему. - Вне проекта. Чекпоинты хранятся в
.creo/checkpoints/— не загрязняют репозиторий, не попадают в git-историю (засчёт расположенного в.creoфайла.gitignore). - Защита от потери данных. Если в проекте есть
.creo/директория — все операции изменения файлов внутри проекта защищены чекпоинтами. Статус защиты отображается в сайдбаре. - Делает YOLO безопасным. YOLO-режим (авто-аппрув всех вызовов) безопасен благодаря чекпоинтам — даже если агент
сломал код, один
/rollbackвозвращает всё обратно. - Pre-rollback snapshot. Перед откатом автоматически создаётся снимок текущего состояния — откат обратим, можно «откатить откат».
Поиск по прошлым сессиям
- Полнотекстовый поиск (FTS5). Агент может искать по содержимому всех прошлых сессий — всех когда-либо проведённых диалогов, вызовов инструментов и результатов — как в текущем проекте, так и跨-проектно.
- Булевы операторы.
AND(неявный),OR,NOT. Примеры:auth AND token,bug OR fix AND "user input",config AND NOT database. - Prefix matching.
config*найдёт «configuration», «configure», «config». - Фразовый поиск.
"git reset"— точное совпадение фразы. - Комбинирование.
bug OR fix AND "user input"— булевы операторы и фразы вместе. - Bookends. Результаты включают первые 2 и последние 2 сообщения сессии — видна цель и результат работы из начала и конца диалога.
- Контекст вокруг совпадения. ±3 сообщения вокруг найденного фрагмента с маркером
>>>на совпадении — сразу понятно, в каком контексте упоминалось. - Browse mode. Без поискового запроса — последние сессии хронологически, с заголовками и ID.
- Scope.
project— только сессии текущего проекта.all— все проекты в общей БД. - Автоматическое использование. Агент сам обращается к поиску когда пользователь спрашивает «что мы делали с X» или «найди сессию где мы обсуждали Y» — без явной команды.
BTW — вопросы без загрязнения контекста
- Побочный вопрос. Команда
/btw <question>задаёт вопрос LLM на основе текущего контекста сессии — но ответ не попадает в историю. Контекст остаётся чистым. - Без инструментов. BTW-ответ генерируется без вызова инструментов — это чистый LLM-ответ, быстро и дёшево.
- Для быстрых уточнений. «Какой флаг у git push для force?», «что означает это предупреждение линтера?» — спросил, получил ответ, продолжил работу. Мусор не накапливается.
- Отдельный стиль. BTW-ответы отображаются с отдельным лейблом
ⓘ BTW— визуально отделены от основного диалога.
Запланированные автономные задачи
- Внутренний планировщик. Работает внутри процесса TUI — не требует внешнего cron. Запускается автоматически при старте.
- Отложенные задачи. Агент может запланировать выполнение промпта через инструмент
schedule: «через 2 часа проверь тесты», «каждый понедельник в 9:00 ревью open issues». - Повторы. Разовые (
30m,2h,1d), интервальные (1h,6h), ежедневные (daily:14:00), еженедельные (weekly:09:00:mon). - Выполнение в новых сессиях. Запланированные задачи создают новую сессию с полным доступом к инструментам и авто-аппрувом. Результаты видны в дереве сессий (группа «⏰ Планировщик»).
- Автономность. Задача выполнится даже если вы закрыли TUI — другой экземпляр
creoперехватит её через 15 минут. По сути CI/CD для AI-задач. - Multi-instance. Несколько экземпляров
creoникогда не выполнят одну задачу дважды — атомарный захват через БД.
Мульти-инстанс с общим мозгом
- Общая БД. Одна SQLite-база на все проекты и все экземпляры
creo. Сессии, память, чекпоинты — всё в одном месте. - Одновременная работа. Несколько процессов
creoмогут работать параллельно — каждый в своём проекте или даже в одном проекте. Блокировки предотвращают конфликты записи. - Зеркальная синхронизация. Если сессия заблокирована другим процессом, TUI всё равно показывает изменения в реальном времени — новые сообщения подгружаются из БД.
- Очередь сообщений. Если сессия занята (агент работает), новые сообщения ставятся в очередь и автоматически обрабатываются, когда агент освобождается.
- Heartbeat-блокировки. Heartbeat каждые 2 секунды продлевает блокировку. Если процесс упал — другой может перехватить сессию (takeover).
- Stale-восстановление. Если процесс
creoупал во время выполнения запланированной задачи — другой экземпляр перехватит её через 15 минут.
Кросс-экосистемная совместимость
Creo работает с навыками и командами из других экосистем AI-агентов — можно переключиться на Creo, не потеряв инвестиции в существующие навыки.
- Agent Skills. Поддержка навыков из
.claude/skills/и.opencode/skills/— как проектных, так и глобальных. - Команды. Поддержка команд из
.claude/commands/,.kilo/commands/,.opencode/commands/. - Прозрачно. Creo автоматически обнаруживает навыки и команды из чужих экосистем при сканировании. Они появляются в
autocomplete и
/skillsнаравне с нативными. - Без миграции. Не нужно ничего копировать или конвертировать — достаточно чтобы директория существовала в проекте или в глобальном конфиге.
Детерминированные вычисления
Встроенные инструменты для точных вычислений без обращения к LLM — агент не «угадывает» результат, а вычисляет его.
- Калькулятор. Инструмент
calculateвычисляет математические выражения: тригонометрия, логарифмы, степени, корни, проценты, константы (pi, e). Агент использует его вместо попытки посчитать в уме — результат точный, без галлюцинаций. - Lua-движок. Инструмент
luaвыполняет sandboxed Lua-программы для детерминированных вычислений, обработки строк, табличных операций, batch-преобразований. Полноценный язык программирования внутри агента. - Sandbox. Lua выполняется в изолированной среде — нет доступа к файловой системе, сети, os.execute. Безопасно.
- Бесплатно. Вычисления не расходуют API-токены — результат генерируется локально, мгновенно.
- Для чего. Подсчёт размеров, смещений, координат, процентов, пропорций, дата-математика, проверка вычислений LLM, обработка и трансформация строк, генерация последовательностей.
Многоагентная оркестрация
Creo поддерживает параллельную многоагентную оркестрацию — основной агент (parent) может порождать независимых под-агентов (children) со своими ролями, моделями и наборами инструментов, а затем координировать их через шину событий.
- Параллельные под-агенты. Агент запускает нескольких детей одновременно через инструмент
agent— каждый работает в отдельной сессии со своим контекстом, моделью и набором инструментов. До 10 одновременно. - Ролевая специализация. Роли определяются JSON-файлами в директориях
./agents/,./.creo/agents/(проектные) или~/.config/creo/agents/(глобальные). Напримерreviewer.json,tester.json. Каждый файл задаёт системный промпт, модель, рекомендуемые навыки и набор инструментов для авто-разрешения. Проектные роли перебивают глобальные при совпадении имени. - Координация через
agent_manage. Блокирующий инструмент: parent ждёт завершения turn'а любого из детей, видит их статусы («Работает» / последнее сообщение) и может отправлять сообщения конкретным агентам. Дети не общаются напрямую — только через родителя. - Crash recovery. Состояние оркестрации хранится в БД. При перезапуске Creo и команде
«продолжи» — parent вызывает
agent_manage, который находит незавершённых детей и перезапускает их с сохранением контекста. - Остановка ненужных агентов. Инструмент
agent_abortявно останавливает указанных детей, если их результаты больше не нужны. - Живой поток в TUI. Каждый child отображается в нижней панели и сайдбаре в реальном времени — стриминг, вызовы инструментов, подтверждения пробрасываются через родительскую сессию.
- Один уровень вложенности. Children не могут порождать своих детей — защита от бесконечной рекурсии.
- Отмена. При прерывании родительского хода (
Esc) все дети автоматически отменяются.
Goal Engine
Goal Engine — подсистема автоматической декомпозиции цели на верифицируемые шаги, исполнения, валидации и отслеживания прогресса. Эволюция инструмента todo: вместо простого списка — управляемый цикл «цель → план → шаги → валидация → результат».
- Автоматическое планирование. Planner (LLM, основная
currentмодель) декомпозирует цель в JSON-план: шаги с критериями успеха, описанием и назначением под-агентов. - Аппрув плана. При
approve_plan=true(по умолчанию) — TUI показывает модальное окно со списком шагов. Пользователь одобряет, редактирует или отменяет. - Исполнение шагов. Шаги выполняются по стратегии (sequential по умолчанию). Шаги с
assigned_agentделегируются под-агентам через многоагентную оркестрацию. - Валидация результатов. После каждого шага Validator проверяет критерии: тесты (
test), линтер (linter), diff-анализ (diff), покрытие (coverage). Провал → retry (доmax_retries). - Pause/Resume. Цель можно приостановить и возобновить — новые шаги не запускаются при
paused. - Прогресс в TUI. Сайдбар показывает блок Goals с прогресс-барами для каждой активной цели. Bus events обновляют в реальном времени.
- Отчёт. При завершении цели формируется отчёт: сколько шагов completed/failed/skipped.
- Ограничения v1. Sequential по умолчанию, до
max_stepsшагов (20), под-агенты один уровень вложенности.
Интерфейс (TUI)
- Потоковый вывод в реальном времени. Текст появляется по мере генерации — не нужно ждать завершения ответа.
- Reasoning/thinking. Мысли модели (reasoning tokens) отображаются отдельным приглушённым стилем — видно, как модель рассуждает.
- Карточки инструментальных вызовов. Каждый вызов инструмента (чтение файла, запуск команды, редактирование) отображается как сворачиваемая карточка с описанием и результатом. Цветовая палитра различает инструменты.
- Мини-режим.
TabилиCtrl+Mпереключают компактный режим: иконка + имя тулзы + краткий заголовок + результат в одну строку. Sidebar и нижняя панель скрываются. Thinking заменяется на «Размышления (N символов)». Состояние сохраняется в конфиге (tui.mini). - Подсказки «Знали ли вы?». В пустом поле ввода показывается случайная подсказка — совет, горячая клавиша или неочевидная возможность. Обновляется при каждом обновлении экрана.
- Сайдбар с git-статусом. Ветка, количество изменённых/ staged/ untracked файлов, список файлов с diff-статистикой (+N / -N), количество чекпоинтов, статус защиты.
- Нижняя панель. Окна терминала и сабагентов в нижней части экрана — виден живой вывод команд и поток работы фоновых
агентов. Переключается
Ctrl+Y. - Дерево сессий. Команда
/sessionsоткрывает интерактивное дерево: сессии сгруппированы по проектам, со статистикой (сообщения, токены, время последней активности), статусом (активна/занята), корзиной удалённых. Сворачиваемые группы. - Автокомплит команд. При вводе
/открывается выпадающий список с fuzzy-поиском по всем командам (встроенные, пользовательские, скиллы). Недавно использованные команды наверху. - Цветовые темы. 7 встроенных тем (OneDark, Dracula, Gruvbox, Catppuccin, Alabaster, Sobrio, Classic256) + создание
собственных JSON-файлов в
~/.config/creo/themes/. Переключение командой/theme(пикер) или/theme <name>. Тема применяется мгновенно без перезапуска. - Многоязычность (i18n). Интерфейс локализован (русский, английский). Язык определяется автоматически при первом запуске, переключается в настройках.
- Мышь. Поддержка мыши для кликов по сайдбару, карточкам, окнам. Переключается
F9— когда выключена, терминал обрабатывает мышь нативно (выделение текста без Shift). - Горячие клавиши.
Enter— отправить,Alt+Enter/Ctrl+J— новая строка,Esc/Ctrl+C— прервать ход,Ctrl+Q— выйти,PgUp/PgDn— прокрутка,Tab/Ctrl+M— мини-режим,Ctrl+B— сайдбар,Ctrl+Y— нижняя панель,Ctrl+O— быстрое переключение между двумя сессиями,Ctrl+Z— приостановить процесс,Alt+,— открыть настройки. - Виртуальный курсор. Видимый курсор в поле ввода, корректно отслеживающий позицию даже при длинном тексте.
- Индикатор компактизации. При автоматическом сжатии контекста отображается прогресс-индикатор.
- Индикатор YOLO-режима. При включённом YOLO-режиме в заголовке отображается
⚠ YOLO MODE. - Отслеживание токенов. После каждого сообщения отображается количество входных/выходных токенов и время генерации. В сайдбаре — суммарный контекст и лимит.
Сессии
- Полная история диалога. Каждое сообщение, вызов инструмента и результат сохраняются в локальную SQLite-базу. Ничего не теряется между перезапусками.
- Возобновление сессий. Команда
creo continue— продолжить последнюю сессию.creo continue <session-id>— открыть конкретную. Команда/resume— интерактивный выбор из списка. - Типы сессий. Обычные интерактивные, сессии планировщика (
scheduler), сессии ревизии (dreaming) — отображаются в отдельных группах дерева сессий. - Управление через агента. Агент может сам списывать, удалять, восстанавливать и переключать сессии — просто попросите в чате: «удали сессии старше 3 дней» или «переключись на сессию X».
- Soft-delete и восстановление. Удалённые сессии помечаются как удалённые, но остаются в БД. Можно восстановить через агента или команду. Корзина видна в дереве сессий.
- Авто-очистка. Soft-deleted сессии старше N дней (по умолчанию 30, настраивается через
scheduler.retention_days) физически удаляются из БД при старте — корзина не разрастается бесконечно.
Безопасность и контроль
- Подтверждение деструктивных действий. По умолчанию каждое действие, изменяющее файлы или запускающее команды, требует подтверждения. Подтверждение запрашивается только если действие не покрыто git-чекпоинтом или выходит за пределы проекта.
- Гибкие области подтверждения.
- Yes/No — одноразово для конкретного вызова.
- Always/Never — для всей сессии (одобрить или отклонять все вызовы этого инструмента).
- Approve all for MCP server — все инструменты конкретного MCP-сервера до конца сессии.
- Approve all for subagent — все вызовы конкретного сабагента.
- YOLO-режим. Команда
/yoloотключает все подтверждения — каждый вызов инструмента выполняется автоматически. Индикатор в заголовке. Повторный/yoloвозвращает обычный режим. - Авто-аппрув MCP-серверов. Флаг
autoApprove: trueвmcp.jsonполностью отключает подтверждения для конкретного сервера — независимо от YOLO. - Управление разрешениями. Команда
/permissionsоткрывает пикер со всеми инструментами — можно индивидуально включить/выключить авто-аппрув для каждого. - API-ключи в безопасности. Ключи маскируются при чтении конфига через агента. Запись ключа возможна, но чтение значения — нет.
Инструменты агента
Creo поставляется с богатым набором встроенных инструментов, доступных агенту:
Работа с файлами
- read — чтение файлов (текст, PDF, DOCX, XLSX, PPTX, ODT, ODS, ODP, CSV). Поддержка постраничного чтения больших файлов.
- write — запись файлов (создание новых или полная перезапись).
- edit — точечное редактирование: замена фрагмента текста с проверкой уникальности.
- glob — поиск файлов по glob-паттернам (например,
**/*.go), с сортировкой по времени изменения. - grep — поиск по содержимому файлов с поддержкой regex, фильтров по типу, режимов вывода.
Git (без системного git)
Все git-операции работают через встроенную Go-библиотеку go-git — системный git не требуется:
- git_status — статус рабочего дерева (staged, unstaged, untracked).
- git_diff — unified diff (staged или unstaged).
- git_log — история коммитов.
- git_add — stage файлов.
- git_commit — коммит с сообщением.
- git_branch — list/create/checkout веток.
- git_restore — restore файлов из index или HEAD.
- git_tag — list/create/delete тегов.
- git_show — детали коммита (автор, дата, diff).
- git_blame — построчное авторство файла.
- git_clean — удаление untracked файлов.
- git_remote — list/add/remove remotes.
- git_ls_files — список tracked файлов.
- git_merge — fast-forward merge ветки.
Терминал
- terminal — выполнение произвольных shell-команд с таймаутом. Живой вывод в нижней панели TUI в реальном времени.
Вычисления
- calculate — вычисление математических выражений (тригонометрия, логарифмы, степени, корни).
- lua — выполнение sandboxed Lua-программ для детерминированных вычислений, обработки строк, табличных операций.
Взаимодействие с пользователем
- ask_user — агент задаёт пользователю вопросы с вариантами ответа (2-4 опции). Интерактивный пикер в TUI.
- todo — управление списком задач текущей сессии: создание, обновление, отметка выполнения. Список персистится в БД, переживает компактизацию контекста.
Конфигурация
- update_config — чтение и модификация
config.jsonчерез агента: смена модели, темы, локали, параметров генерации, добавление/удаление моделей.
Управление сессиями
- sessions — list/delete/restore/switch сессий через агента.
- search_sessions — полнотекстовый поиск по всем прошлым сессиям через SQLite FTS5. Поддержка булевых операторов
(AND, OR, NOT), prefix matching (
config*), фразового поиска ("git reset"). Результаты включают bookends (первые и последние сообщения сессии) и контекст вокруг совпадения. - schedule — планирование отложенных задач: создать, список, отменить, обновить. Задачи выполняются в новых сессиях с авто-аппрувом.
Чекпоинты
- rollback — откат рабочего дерева к указанному чекпоинту (или к последнему).
- checkpoint_list — список всех доступных чекпоинтов с метаданными.
Память и состояние
- memory — сохранение и извлечение персистентных фактов о пользователе (profile) и проекте (environment). Факты загружаются в каждый новый контекст сессии, позволяя агенту «помнить» предпочтения и договорённости между сессиями.
- kv — постоянное key-value хранилище для operational state: курсоры, last-processed IDs, чекпоинты обработки.
Переживает все сессии (включая фоновые). Фоновая сессия проверки почты хранит ID последнего письма — следующая
начинает с него. Ключи глобальные, namespaced (
email:last_id,sync:cursor).
Навыки
- skill — активация навыка (Agent Skill) по имени. Загружает полные инструкции в контекст.
- skill-creator — создание, редактирование, удаление и слияние навыков, которые агент пишет сам (автоскиллы). Поддержка файлов ресурсов (references/, templates/, scripts/).
- skillhub — поиск, просмотр и установка навыков из публичных реестров (ClawHub, SkillsDB) прямо в чате.
Многоагентная оркестрация
- agent — запуск дочерних агентов: одного или нескольких параллельно. Каждый child получает свою сессию, роль, модель и набор инструментов. Возвращает список детей с их статусами.
- agent_manage — блокирующий оркестратор: ждёт завершения turn'а любого из детей, возвращает статусы всех агентов (работает / результат / вопрос) и принимает сообщения для передачи конкретным агентам. Parent LLM в обычном цикле видит статусы, рассуждает и решает кому ответить.
- agent_abort — явная остановка указанных дочерних агентов через abort-сигнал.
Goal Engine
- goal — управление целью: create (создать + запланировать), status (статус), pause, resume, cancel, list, approve (апрув плана).
- goal_step — управление шагом цели: retry (повторить провалившийся), skip (пропустить), update (обновить описание/критерии).
MCP (Model Context Protocol)
- Подключение через диалог. Просто попросите агента: «подключи MCP-сервер filesystem» — агент запишет конфигурацию, подключится и зарегистрирует все инструменты сервера.
- Два scope'а. Глобальный (
~/.config/creo/mcp.json) — действует во всех проектах. Проектный (.creo/mcp.json) — только в текущем, можно коммитить в git. Проектный перекрывает глобальный. - Два транспорта.
stdio— локальный процесс с аргументами и env-переменными.http— удалённый endpoint с кастомными заголовками (для авторизации). - Асинхронная загрузка. MCP-серверы подключаются в фоне — не блокируют запуск TUI. Инструменты появляются по мере подключения.
- Авто-аппрув. Флаг
autoApprove: trueдля конкретного сервера — инструменты никогда не запрашивают подтверждение. - Примеры. Context7 (актуальная документация библиотек), gopls (языковой сервер Go), filesystem, GitHub API, произвольные HTTP-серверы.
Agent Skills
- Открытый стандарт. Навык — это папка с
SKILL.md(YAML frontmatter + инструкции), опционально с скриптами и ресурсами. - Progressive disclosure. Агент видит только имя и краткое описание каждого навыка в системном промпте. Полные инструкции загружаются только при релевантной задаче — экономия контекста.
- Четыре уровня размещения.
- Встроенные — поставляются с Creo, неизменяемы.
- Глобальные —
~/.config/creo/skills/, доступны во всех проектах. - Проектные —
.creo/skills/в корне проекта, можно коммитить. - Автоскиллы — создаются самим агентом в результате dreaming-ревизии.
- Сторонние реестры. Поиск и установка навыков из ClawHub и SkillsDB через инструмент
skillhub— прямо в чате. - Активация через слэш-команду.
/skill-nameзагружает навык как сообщение. Автокомплит показывает все доступные навыки. - Команда
/skills— список всех обнаруженных навыков с областью и описанием. - Команда
/reload-skills— пересканировать директории навыков без перезапуска.
Пользовательские команды
- Markdown-файлы как команды. Создайте
.mdфайл в.creo/commands/(проект) или~/.config/creo/commands/(глобально) — и вызывайте через/<filename>. - Приоритет. Встроенные команды зарезервированы и не могут быть перекрыты пользовательскими. Проектные команды приоритетнее глобальных.
- Аргументы. Команды принимают аргументы:
/my-command arg1 arg2. - Автокомплит. Пользовательские команды появляются в выпадающем списке вместе со встроенными.
Контекст и компактизация
- Автоматическая компактизация. При превышении лимита контекста агент автоматически сжимает старые сообщения через суммаризацию. Новые сообщения сохраняются дословно, старые заменяются компактным саммари.
- Ручная компактизация. Команда
/compactпринудительно сжимает контекст. - Итеративная суммаризация. При повторной компактизации предыдущее саммари передаётся модели для обновления, а не генерируется с нуля.
- Fallback-саммари. Если LLM-вызов для суммаризации не удался — генерируется детерминированное саммари из структуры сообщений.
- Защита от thrashing. Эффективность компактизации отслеживается — если сжатие не уменьшило контекст хотя бы на 10%, повторная компактизация не запускается.
- Точный подсчёт токенов. Реальный размер контекста вычисляется на основе usage-дельт от LLM, а не приблизительной оценки.
Обработка ошибок и устойчивость
- Автоматический retry. При временных ошибках стриминга (rate limit, network) — автоматический повтор с countdown-таймером.
- Защита от циклов. Детектирование повторяющихся ответов между итерациями — если агент начал «зацикливаться», ход останавливается.
- Прерывание хода.
EscилиCtrl+Cмгновенно прерывает текущий ход. Частичный вывод сохраняется в историю. - Сохранение partial. При прерывании или ошибке уже сгенерированный текст сохраняется в сессии — не теряется.
IDE-интеграция (ACP)
Creo работает как AI-ассистент внутри IDE через Agent Client Protocol (ACP) — открытый стандарт для интеграции AI-агентов с редакторами кода.
- Запуск. Команда
creo acpзапускает Creo как stdio-сервер — IDE подключается через stdin/stdout. Диагностика пишется в stderr. - Тот же агент, другой фронтенд. ACP-сервер использует тот же агентский движок, что и TUI — инструменты, скиллы, MCP, память, поиск по сессиям, планировщик — всё доступно.
- Управление сессиями. IDE-клиент может создавать новые сессии, загружать существующие с replay истории, листать список с фильтром по проекту, отменять ход.
- Делегирование файловых операций. Чтение, запись и терминал проксируются через IDE-клиент — агент использует ACP RPC
(
fs/read_text_file,fs/write_text_file,terminal/create) для доступа к файлам и выполнения команд. - Любой ACP-клиент. Протокол универсальный — любой редактор или IDE с поддержкой ACP может подключиться.
- Ограничения. Локальные инструменты
edit,glob,grepи всеgit_*недоступны через ACP — файловые операции делегируются IDE. Терминал синхронный (без живого стриминга). TUI-специфичные фичи (слэш-команды, мини-режим, темы, сайдбар, интерактивный ask_user-пикер) недоступны.
Файловая система и хранение
- XDG-совместимость. Все данные хранятся вне проекта:
- Конфигурация:
~/.config/creo/ - БД сессий:
~/.local/share/creo/sessions.db - Логи и чекпоинты:
~/.local/state/creo/
- Конфигурация:
- Единая БД. Одна SQLite-база на все проекты — фильтрация по рабочей директории. Сессии можно искать и листать跨 -проектно.
- Чекпоинты по проектам.
~/.local/state/creo/checkpoints/<путь_проекта>/— отдельная директория на проект. - Не загрязняет проект. Данные Creo не появляются в рабочей директории (кроме
.creo/для проектных настроек, которая обычно в.gitignore).
Проектные инструкции (AGENTS.md)
- Автоматическая загрузка. При запуске в проекте с
AGENTS.mdфайл загружается в системный промпт агента — агент следует вашим правилам и конвенциям. - Поддержка длинных файлов. Файлы до 16KB загружаются полностью, больше — обрезаются с предупреждением в логах.
CLI-команды
| Команда | Описание |
|---|---|
creo |
Запуск интерактивного TUI в текущей директории. |
creo continue |
Продолжить последнюю сессию. |
creo continue <id> |
Открыть конкретную сессию по ID. |
creo acp |
Запуск как ACP-сервер (stdio) для IDE-интеграции. |
Слэш-команды (в TUI)
| Команда | Алиасы | Описание |
|---|---|---|
/help |
Список всех доступных команд. | |
/new-session |
/clear, /reset, /new |
Начать новую пустую сессию. |
/resume |
Переключиться на другую сессию (интерактивный пикер). | |
/sessions |
Дерево всех сессий с группировкой по проектам. | |
/cd <path> |
Сменить рабочую директорию. | |
/copy [N] |
Скопировать N-й последний ответ ассистента в буфер обмена. Если есть несколько code-блоков — пикер выбора. | |
/btw <question> |
Побочный вопрос без загрязнения контекста — быстрый ответ от LLM без инструментов. | |
/compact |
Сжать контекст через суммаризацию. | |
/model |
Переключить активную модель (пикер). | |
/theme |
Переключить цветовую тему (пикер или /theme <name>). |
|
/settings |
Открыть страницу настроек. | |
/permissions |
Управление авто-аппрувом для отдельных инструментов. | |
/yolo |
Включить/выключить YOLO-режим (авто-аппрув всех вызовов). | |
/mini |
Включить/выключить мини-режим (компактное отображение). | |
/skills |
Список обнаруженных навыков (Agent Skills). | |
/reload-skills |
Пересканировать директории навыков и команд. | |
/rename [name] |
Переименовать сессию. Без аргумента — авто-генерация через LLM. | |
/rollback |
Откатить рабочее дерево к последнему чекпоинту. | |
/goal |
Управление целями Goal Engine: new, list, show, pause, resume, cancel, retry. | |
/stop |
Прервать текущий ход агента. | |
/exit |
/quit |
Выйти из CLI. |
Открытость и расширяемость
- Открытый исходный код. GPL-3.0, код доступен на GitVerse.
- Без vendor lock-in. Любая OpenAI-совместимая модель или локальная Ollama — нет привязки к конкретному провайдеру.
- Без системных зависимостей. Git-операции через встроенную Go-библиотеку — системный git не требуется.
- MCP-экосистема. Любой MCP-сервер из растущей экосистемы подключается одной командой.
- Кросс-платформенность. Linux, macOS, Windows. Следует XDG Base Directory спецификации. На Windows для
терминала используется PowerShell (настраивается через
tui.shell:powershellилиcmd). Состояние видимости sidebar и нижней панели сохраняется между запусками.