Начало работы

Установка скриптом (Linux / macOS) 

1curl -fsSL https://gitverse.ru/api/repos/creocode/creo/raw/branch/master/scripts/install.sh | sh

Скрипт определит ОС и архитектуру, скачает последний релиз и установит бинарник в ~/.local/bin (или /usr/local/bin при запуске через sudo).

Релизы на GitVerse — скачайте архив для своей платформы, распакуйте и переместите бинарник в директорию из PATH.

1go install gitverse.ru/creocode/creo/cmd/creo@latest

Требуется Go 1.26.5 или новее.

1creo --version

Перейдите в директорию проекта и запустите creo:

1cd my-project
2creo

Если config.json ещё не существует, запустится интерактивный мастер конфигурации. Он последовательно запросит параметры модели.

Шаг 1. Тип провайдера. Два варианта:

  • openai — OpenAI-совместимый API. Подходит для OpenAI, DeepSeek, GLM, vLLM, Together, Fireworks и любых endpoint'ов, поддерживающих Chat Completions API.
  • ollama — локальная Ollama. Бесплатно, приватно, без облачных ключей.

Шаг 2. Для openai:

Параметр Описание Пример
Base URL Базовый URL API. Пустое значение — официальный OpenAI (https://api.openai.com/v1) https://api.deepseek.com/v1
API Key Ключ доступа sk-...
Имя модели Идентификатор модели в API gpt-4o, deepseek-chat, glm-4

Шаг 3. Для ollama:

Параметр Описание По умолчанию
URL Ollama Адрес локального сервера http://localhost:11434
Имя модели Идентификатор модели llama3, qwen2.5

Шаг 4. Отображаемое имя. Как модель будет называться в конфиге. По умолчанию — default.

После завершения мастер сохраняет config.json и использует эту модель как для основных сессий (current), так и для фоновых задач (mini).

Запустите creo в директории проекта. Откроется TUI — терминальный интерфейс с полем ввода внизу.

Введите запрос и нажмите Enter. Агент прочитает кодовую базу, отредактирует файлы, запустит команды — всё с вашего подтверждения.

Примеры запросов:

Изучи структуру проекта и объясни архитектуру
Добавь функцию валидации email в internal/validators/
Найди все места где используется устаревший API и предложи замену
Запусти тесты и исправь падающие

История диалога сохраняется автоматически. Чтобы продолжить последнюю сессию:

1creo continue

Конкретную сессию:

1creo continue <session-id>

Внутри TUI команда /resume открывает интерактивный список сессий.

Конфигурация хранится в config.json в стандартном каталоге конфигов ОС:

ОС Путь
Linux ~/.config/creo/config.json
macOS ~/.config/creo/config.json (или ~/Library/Application Support/creo/config.json)
Windows %AppData%\creo\config.json

Файл можно редактировать вручную или через агента — попросите в чате: «Поменяй текущую модель на default» или «Установи locale в en».

Подробно о конфигурации — в разделе Модели и провайдеры.

Creo хранит все данные за пределами проекта, чтобы не загрязнять рабочую директорию:

Назначение Путь Переменная
Конфигурация ~/.config/creo/ XDG_CONFIG_HOME
БД сессий (SQLite) ~/.local/share/creo/sessions.db XDG_DATA_HOME
Логи и чекпоинты ~/.local/state/creo/ XDG_STATE_HOME

Чекпоинты (git-снапшоты для отката) — в ~/.local/state/creo/checkpoints/<путь_проекта>/, по одной директории на проект.

В самой рабочей директории создаётся только .creo/ для проектных настроек — навыков, команд, memory. Эта директория обычно добавляется в .gitignore.