TOD — инструмент командной строки TheOneDev

TOD (TheOneDev) — это мощный инструмент командной строки для OneDev 13+, который оптимизирует ваш рабочий процесс разработки, позволяя запускать CI/CD-задания для локальных изменений, проверять pull-запросы в локальной рабочей директории, запрашивать и редактировать задачи/PR/сборки, а также управлять всем вышеперечисленным с помощью ИИ-агентов через поставляемые файлы навыков (skill files).

Возможности

• Запрос и редактирование сущностей OneDev — задач, pull-запросов и сборок — напрямую из терминала.

• Запуск CI/CD-заданий для локальных изменений, веток или тегов с потоковой передачей логов в реальном времени (tod build run --local, --branch или --tag).

• Проверка pull-запросов локально (tod pr checkout).

• Проверка и миграция .onedev-buildspec.yml до последней версии (tod build check-spec).

• Навыки агента в директории skills/, которые обучают Claude Code, Cursor и другие агенты, поддерживающие SKILL.md, управлять рабочими процессами OneDev через tod.

• Кроссплатформенная поддержка (Windows, macOS, Linux).

Related MCP server: AlibabaCloud DevOps MCP Server

Установка

Чтобы установить tod, поместите бинарный файл в ваш PATH.

Загрузка готовых бинарных файлов

https://code.onedev.io/onedev/tod/~builds?query=%22Job%22+is+%22Release%22

Сборка из исходного кода

Требования: Go 1.22.1 или выше.

git clone https://code.onedev.io/onedev/tod.git
cd tod
go build

Конфигурация

Запустите tod config set для интерактивного создания или обновления файла конфигурации:

tod config set
# OneDev server URL (e.g. https://onedev.example.com): ...
# OneDev personal access token (input is visible): ...

Или передайте все параметры в виде флагов для неинтерактивной настройки:

tod config set \
  --server-url https://onedev.example.com \
  --access-token your-personal-access-token \
  --non-interactive

tod config get выводит активную конфигурацию (с маскированным токеном), tod config get <имя свойства> выводит одно свойство, а tod config set <имя свойства> <значение свойства> обновляет одно свойство. Имена свойств: server-url и access-token. tod config path выводит используемый путь.

Файл конфигурации ищется в следующих местах (первое совпадение побеждает):

1. $XDG_CONFIG_HOME/tod/config

2. ~/.config/tod/config

3. ~/.todconfig (устаревший вариант)

Он использует формат INI и записывается с правами доступа 0600:

server-url=https://onedev.example.com
access-token=your-personal-access-token

Быстрый старт

# Run CI against your uncommitted changes
cd /path/to/onedev-git-repository
tod build run --local ci

# Run ci job against the main branch
tod build run --branch main ci

# Check out pull request PROJ-123 into the current working directory
tod pr checkout PROJ-123

# Query open issues assigned to you
tod issue list --query 'assignee is me and state is "Open"'

# Inspect the most recent failing build for a project
tod build list --query 'successful is false' --count 1
tod build get <ref>
tod build get-log <ref>

См. cli.md для получения полного справочника по командам.

Навыки агента

TOD поставляется с четырьмя универсальными файлами SKILL.md в директории skills/, которые обучают ИИ-агентов управлять общими рабочими процессами OneDev через CLI:

• using-tod — общее руководство для любого взаимодействия с OneDev через tod

• edit-build-spec — создание или редактирование .onedev-buildspec.yml

• investigate-build-problems — отладка неудачной сборки

• review-pull-request — выполнение структурированной проверки pull-запроса

См. skills.md для получения информации о том, как установить их в Claude Code, Cursor или любой другой агент, который читает файлы SKILL.md.

Примечания для локальных CI-запусков

Конфигурация Nginx

Если OneDev работает за Nginx, отключите буферизацию HTTP для потоковой передачи логов:

location /~api/streaming {
    proxy_pass http://localhost:6610/~api/streaming;
    proxy_buffering off;
}

Подробности см. в документации по настройке Nginx для OneDev.

Вопросы безопасности

Если задание обращается к секретам задания, убедитесь, что поле авторизации очищено, чтобы разрешить все задания. Установки авторизации для разрешения всех веток недостаточно — локальные изменения отправляются во временную ссылку (ref), которая не принадлежит ни к одной ветке.

Советы по производительности

1. Большие репозитории — используйте соответствующую глубину клонирования (clone depth) на этапах оформления заказа вместо полной истории.

2. Внешние зависимости — используйте кэширование для загрузок и промежуточных файлов.

3. Оптимизация сборки — кэшируйте промежуточные файлы, которые долго генерируются.

Участие в разработке

TOD является частью экосистемы OneDev. Для предложений, сообщений об ошибках и запросов функций посетите проект OneDev.

Лицензия

См. license.txt.