TOD – Das OneDev CLI-Tool

TOD (TheOneDev) ist ein leistungsstarkes Befehlszeilen-Tool für OneDev 13+, das Ihren Entwicklungsworkflow optimiert. Es ermöglicht Ihnen, CI/CD-Jobs für lokale Änderungen auszuführen, Pull Requests in ein lokales Arbeitsverzeichnis auszuchecken, Issues/PRs/Builds abzufragen und zu bearbeiten sowie all dies über KI-Agenten mithilfe bereitgestellter Skill-Dateien zu steuern.

Funktionen

• Abfrage und Bearbeitung von OneDev-Entitäten — Issues, Pull Requests und Builds — direkt aus der Shell.

• Ausführung von CI/CD-Jobs für lokale Änderungen, Branches oder Tags mit Echtzeit-Log-Streaming (tod build run --local, --branch oder --tag).

• Auschecken von Pull Requests lokal (tod pr checkout).

• Überprüfung und Migration von .onedev-buildspec.yml auf die neueste Version (tod build check-spec).

• Agent-Skills unter skills/, die Claude Code, Cursor und andere SKILL.md-fähige Agenten anleiten, OneDev-Workflows über tod zu steuern.

• Plattformübergreifende Unterstützung (Windows, macOS, Linux).

Related MCP server: AlibabaCloud DevOps MCP Server

Installation

Um tod zu installieren, fügen Sie das Binary zu Ihrem PATH hinzu.

Herunterladen vorgefertigter Binaries

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

Aus dem Quellcode erstellen

Voraussetzungen: Go 1.22.1 oder höher.

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

Konfiguration

Führen Sie tod config set aus, um die Konfigurationsdatei interaktiv zu erstellen oder zu aktualisieren:

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

Oder übergeben Sie alles als Flags für nicht-interaktive Setups:

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

tod config get gibt die aktive Konfiguration aus (wobei das Token maskiert ist), tod config get <Eigenschaftsname> gibt eine einzelne Eigenschaft aus und tod config set <Eigenschaftsname> <Eigenschaftswert> aktualisiert eine Eigenschaft. Die Eigenschaftsnamen sind server-url und access-token. tod config path gibt den verwendeten Pfad aus.

Die Konfigurationsdatei wird an folgenden Orten gesucht (der erste Treffer zählt):

1. $XDG_CONFIG_HOME/tod/config

2. ~/.config/tod/config

3. ~/.todconfig (Legacy-Fallback)

Sie verwendet das INI-Format und wird mit dem Modus 0600 geschrieben:

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

Schnellstart

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

Siehe cli.md für die vollständige Befehlsreferenz.

Agent-Skills

TOD liefert vier tool-agnostische SKILL.md-Dateien unter skills/, die KI-Agenten beibringen, wie sie gängige OneDev-Workflows über die CLI steuern können:

• using-tod — allgemeiner Leitfaden für jede OneDev-Interaktion über tod

• edit-build-spec — Erstellen oder Bearbeiten von .onedev-buildspec.yml

• investigate-build-problems — Debuggen eines fehlerhaften Builds

• review-pull-request — Durchführen eines strukturierten Pull-Request-Reviews

Siehe skills.md für Informationen zur Installation in Claude Code, Cursor oder jeden anderen Agenten, der SKILL.md-Dateien liest.

Hinweise für lokale CI-Läufe

Nginx-Konfiguration

Wenn OneDev hinter Nginx läuft, deaktivieren Sie das HTTP-Buffering für das Log-Streaming:

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

Weitere Details finden Sie in der OneDev Nginx-Setup-Dokumentation.

Sicherheitshinweise

Wenn der Job auf Job-Secrets zugreift, stellen Sie sicher, dass das Autorisierungsfeld gelöscht ist, um alle Jobs zuzulassen. Die Autorisierung auf alle Branches zu beschränken reicht nicht aus — lokale Änderungen werden auf eine temporäre Referenz gepusht, die zu keinem Branch gehört.

Performance-Tipps

1. Große Repositories — verwenden Sie eine geeignete Clone-Tiefe in Checkout-Schritten anstelle der vollständigen Historie.

2. Externe Abhängigkeiten — verwenden Sie Caching für Downloads und Zwischendateien.

3. Build-Optimierung — cachen Sie langsam zu generierende Zwischendateien.

Mitwirken

TOD ist Teil des OneDev-Ökosystems. Für Beiträge, Probleme und Funktionsanfragen besuchen Sie das OneDev-Projekt.

Lizenz

Siehe license.txt.