Repository verbinden

Überblick

Ottili Coder arbeitet in deinem bestehenden Git-Repository* – er legt keinen zweiten Code-Speicher an und behält deine Historie. Damit Coder einen Run ausführen kann, verbindest du das Repository einmalig mit deiner Coder-Runtime* (Projekt). Danach greift Coder über den konfigurierten Remote* des Repositorys auf den Code zu – es ist kein separater GitHub- oder GitLab-Connector nötig.

Ottili Coder ist öffentlich als Public Beta (BETA)* verfügbar. Das Verbinden eines Repositorys ist Teil dieses Laufs und als verfügbar (AVAILABLE)* gekennzeichnet; Cloud-Runs (bei denen dein Repository in einen verwalteten Workspace in Ottili Cloud* gesendet wird) sind in der Beta (BETA)*, die direkte Auslieferung (Deployment) ist geplant (PLANNED)*. Wie Ottili ONE Reifestatus öffentlich kennzeichnet, beschreibt der Artikel [Feature-Status-Labels verstehen](/docs/understand-feature-status-labels); das Beta-Modell erklärt [Öffentliche und private Beta – das Modell von Ottili ONE](/docs/product-lifecycle-and-feature-status).

Was du brauchst

• Ein Git-Repository* mit einem konfigurierten Remote (HTTPS oder SSH).
• Zugriff auf die Unified API* von Ottili ONE (lokal auf Port 8100 oder deine ausgerollte Instanz) und einen API-Token für deinen Workspace.
• Optional die Ottili Coder CLI* (siehe [CLI installieren](/docs/cli-installation)).

Jede Verbindung ist firmengebunden*: das Repository wird auf genau ein Unternehmen (company_id) aufgelöst und über Ottili Core* mandantenisolierig abgesichert. Ein Repository, das du verbindest, ist für andere Unternehmen nicht sichtbar.

Repository verbinden

Du verbindest ein Repository über die Coder-CLI oder über die Coder-Oberfläche (Dashboard/Desktop). In beiden Fällen landet die Verbindung unter derselben kanonischen Coder-REST-Adresse POST /api/v1/coder/repositories/connect der Unified API.

Über die CLI

Die repositories-Gruppe der coder-Befehle spricht die Unified API an:

ottili coder repositories connect "<quelle>" \
  --remote-url https://github.com/organisation/repo.git \
  --branch main

Als <quelle> (raw) kannst du angeben:

• einen lokalen Pfad* zu einem bereits ausgecheckten Klon,
• eine GitHub-/GitLab-URL* (oder eine URL eines selbstgehosteten Remotes),
• eine Archivdatei* (ZIP),
• oder ottili:// für einen von Ottili verwalteten Quelltyp.

Nützliche Optionen:

• --local-path – lokaler Checkout-Pfad für die tiefe Analyse.
• --remote-url – explizite Remote-URL (GitHub, GitLab, Bitbucket, selbstgehostet).
• --branch – Default-Branch, auf dem Coder arbeitet.
• --project-id – Zuordnung zu einem Coder-Projekt.
• --mission-id – Zuordnung zu einer [Mission](/docs/coder-missions) (Mission → Plan-Flow).
• --idempotency-key – Schlüssel für sichere Wiederholungen (idempotent).

Nach dem Verbinden antwortet Coder mit dem ermittelten source_type, einer Repository-id und einem status (z. B. connected).

Über Dashboard oder Desktop

In der Coder-Oberfläche (Dashboard oder Desktop) verbindest du ein Repository und gibst dieselbe Quelle an (lokaler Pfad, Remote-URL, Archiv oder ottili://). Die Oberfläche sendet dieselbe Anfrage an die Unified API; es entsteht kein zweites, verwaistes Repository.

Unterstützte Repository-Anbieter

Coder nutzt den konfigurierten Remote* deines Repositorys. Unterstützt sind unter anderem:

• GitHub*
• GitLab*
• Bitbucket*
• selbstgehostete* Remotes (über HTTPS- oder SSH-URL)

Weil Coder den Remote des Repositorys verwendet, brauchst du keinen plattformspezifischen Connector – du verbindest dein Repository so, wie du es auch für deine bestehenden Tools konfiguriert hast.

Authentifizierung

Coder greift über die bereits konfigurierten Zugangsdaten deines Remotes* zu (z. B. OAuth-App, Personal Access Token oder SSH-Schlüssel, die du für GitHub/GitLab/Bitbucket hinterlegt hast). Es gibt keinen separaten Coder-Login für Git: Coder nutzt die gleiche Authentifizierung wie dein lokales git. Die API-Zugangsdaten für die Unified API (Token deines Workspaces) steuerst du über Umgebungsvariablen – siehe [CLI installieren](/docs/cli-installation).

Alle Zugriffe sind firmengebunden* und werden über Ottili Core* mandantenisolierig protokolliert.

Verbundene Repositories verwalten

Nach dem Verbinden kannst du die Verbindung über dieselbe CLI-Gruppe verwalten:

• ottili coder repositories list – verbundene Repositories des Unternehmens auflisten.
• ottili coder repositories show <id> – ein Repository mit vollem Kontext anzeigen.
• ottili coder repositories context <id> – nur den analysierten Repository-Kontext anzeigen.
• ottili coder repositories refresh <id> – Kontext neu berechnen und zusammenführen.
• ottili coder repositories disconnect <id> – Verbindung trennen (idempotent, sicher wiederholbar).

Lokal, Cloud und hybrid

Sobald ein Repository verbunden ist, verhält sich die Git-Integration konsistent über die Coder-Modi:

• Lokaler Run* – Coder arbeitet direkt auf deinem Arbeits-Repository.
• Cloud-Run* – dein Repository und der Task-Kontext werden in einen verwalteten Workspace in Ottili Cloud* gesendet; Branch und Pull Request kehren zum selben Repository und Remote* zurück (Beta).
• Hybrid-Run* – Aufgaben werden je nach Kontext lokal und in der Cloud verteilt; die Git-Ergebnisse laufen im selben Repository zusammen.

Details dazu in [Git- und GitHub-Integration](/docs/coder-git) und den [Coder-Modi](/docs/coder-modes).

Berechtigungen und Freigaben

Risky Git-Schritte (z. B. Force-Push, Änderungen an geschützten Branches oder das Überschreiben von Tags) unterliegen demselben Berechtigungs- und Freigabe-Modell wie andere Coder-Aktionen. Welche Werkzeuge ein Run nutzen darf und wo eine Freigabe nötig ist, steuert der Artikel [Werkzeuge und Berechtigungen](/docs/coder-security). Die Prüfung selbst läuft über [Testing- und Validierungs-Loops](/docs/coder-validation), bevor eine Aufgabe als erledigt gilt.

Reifestatus

Verwandte Artikel

• [Ottili Coder – Überblick](/docs/ottili-coder)
• [Ask Plan Build Fix Review – Coder-Modi](/docs/coder-modes)
• [Git- und GitHub-Integration](/docs/coder-git)
• [Ottili Coder – CLI installieren](/docs/cli-installation)
• [Missionen](/docs/coder-missions)
• [Werkzeuge und Berechtigungen](/docs/coder-security)
• [Feature-Status-Labels verstehen](/docs/understand-feature-status-labels)
• [Öffentliche und private Beta – das Modell von Ottili ONE](/docs/product-lifecycle-and-feature-status)