TOD - Herramienta CLI de TheOneDev

TOD (TheOneDev) es una potente herramienta de línea de comandos para OneDev 13+ que agiliza su flujo de trabajo de desarrollo permitiéndole ejecutar trabajos de CI/CD sobre cambios locales, extraer solicitudes de extracción (pull requests) a un directorio de trabajo local, consultar y editar incidencias/PRs/compilaciones, y dirigir todo lo anterior desde agentes de IA mediante archivos de habilidades incluidos.

Características

• Consultar y editar entidades de OneDev — incidencias, solicitudes de extracción y compilaciones — directamente desde la terminal.

• Ejecutar trabajos de CI/CD sobre cambios locales, ramas o etiquetas con transmisión de registros en tiempo real (tod build run --local, --branch, o --tag).

• Extraer solicitudes de extracción localmente (tod pr checkout).

• Comprobar y migrar .onedev-buildspec.yml a la última versión (tod build check-spec).

• Habilidades de agente bajo skills/ que enseñan a Claude Code, Cursor y otros agentes compatibles con SKILL.md a dirigir flujos de trabajo de OneDev mediante tod.

• Soporte multiplataforma (Windows, macOS, Linux).

Related MCP server: AlibabaCloud DevOps MCP Server

Instalación

Para instalar tod, coloque el binario en su PATH.

Descargar binarios precompilados

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

Compilar desde el código fuente

Requisitos: Go 1.22.1 o superior.

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

Configuración

Ejecute tod config set para crear o actualizar el archivo de configuración de forma interactiva:

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

O pase todo como indicadores (flags) para configuraciones no interactivas:

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

tod config get imprime la configuración activa (con el token redactado), tod config get <nombre de propiedad> imprime una sola propiedad, y tod config set <nombre de propiedad> <valor de propiedad> actualiza una propiedad. Los nombres de las propiedades son server-url y access-token. tod config path imprime la ruta que se está utilizando.

El archivo de configuración se busca en las siguientes ubicaciones (la primera coincidencia es la que cuenta):

1. $XDG_CONFIG_HOME/tod/config

2. ~/.config/tod/config

3. ~/.todconfig (reserva heredada)

Utiliza formato INI y se escribe con el modo 0600:

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

Inicio rápido

# 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>

Consulte cli.md para obtener la referencia completa de comandos.

Habilidades de agente

TOD incluye cuatro archivos SKILL.md independientes de la herramienta bajo skills/ que enseñan a los agentes de IA cómo dirigir flujos de trabajo comunes de OneDev a través de la CLI:

• using-tod — guía general para cualquier interacción con OneDev mediante tod

• edit-build-spec — crear o editar .onedev-buildspec.yml

• investigate-build-problems — depurar una compilación fallida

• review-pull-request — realizar una revisión estructurada de una solicitud de extracción

Consulte skills.md para saber cómo instalarlos en Claude Code, Cursor o cualquier otro agente que lea archivos SKILL.md.

Notas para ejecuciones de CI locales

Configuración de Nginx

Si OneDev se ejecuta detrás de Nginx, deshabilite el almacenamiento en búfer HTTP para la transmisión de registros:

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

Consulte la documentación de configuración de Nginx de OneDev para obtener más detalles.

Consideraciones de seguridad

Si el trabajo accede a secretos del trabajo, asegúrese de que el campo de autorización esté borrado para permitir todos los trabajos. Establecer la autorización para permitir todas las ramas no es suficiente: los cambios locales se envían a una referencia temporal que no pertenece a ninguna rama.

Consejos de rendimiento

1. Repositorios grandes — utilice una profundidad de clonación adecuada en los pasos de extracción (checkout) en lugar del historial completo.

2. Dependencias externas — utilice caché para descargas y archivos intermedios.

3. Optimización de compilación — almacene en caché los archivos intermedios que tardan mucho en generarse.

Contribución

TOD es parte del ecosistema OneDev. Para contribuciones, problemas y solicitudes de funciones, visite el proyecto OneDev.

Licencia

Consulte license.txt.