Ottili Coder – CLI installieren

Überblick

Ottili Coder lässt sich nicht nur über die Desktop-App und das Dashboard steuern, sondern auch direkt aus dem Terminal. Die Ottili Coder CLI* ist die coder-Befehlsgruppe der einheitlichen `ottili`-Entwickler-CLI* im Repository von Ottili ONE. Damit gibst du Missionen im selben Chat-first-Format auf, das auch Cloud und Desktop nutzen – die CLI ist kein zweites System, sondern ein weiterer Client derselben Engine.

Die CLI ist Teil von Ottili Coder, das öffentlich als Public Beta (BETA)* verfügbar ist. Die coder-Befehle sprechen die Unified API an (lokal unter http://localhost:8100 oder deine ausgerollte API). Cloud-Runs sind in der Beta (BETA)*, die direkte Auslieferung (Deployment) ist geplant (PLANNED)*.

Voraussetzungen

• Python 3.11 oder neuer* (die CLI nutzt click und click-completion).
• Git*, damit Coder in deinem Repository arbeiten kann.
• Zugriff auf die Unified API* (lokal auf Port 8100 oder deine ausgerollte Instanz).
• Ein Workspace* in Ottili ONE, für den Ottili Coder aktiviert ist, sowie ein API-Token.
• Netzwerkzugang für Auth, Queue-Sync, Credits und Audit.

Installation

Die CLI liegt im Repository unter cli/ottili.py. Du brauchst kein separat gepacktes Paket.

1. Repository bereitstellen* – klone oder nutze einen vorhandenen Klon von Ottili ONE und wechsle in das Wurzelverzeichnis.

2. Python-Abhängigkeiten installieren*:

   pip install -r requirements.txt

Mindestens benötigt: click>=8.0.0, click-completion>=0.5.2 und pyyaml>=6.0.

3. Ausführbar machen oder Alias setzen* – direkt aufrufen:

   python3 cli/ottili.py --help

Bequemer als Alias (in deine Shell-RC, z. B. ~/.bashrc oder ~/.zshrc):

   alias ottili='python3 /pfad/zu/ottili_one_v1/cli/ottili.py'

Optional ausführbar machen:

   chmod +x cli/ottili.py

Authentifizierung

Die coder-Befehle senden Anfragen an die Unified API. Es gibt keinen separaten login-Befehl; du konfigurierst die Verbindung über Umgebungsvariablen:

• OTTILI_WORKSPACE_SLUG – der Slug deines Workspace (oder --workspace pro Befehl).
• OTTILI_API_TOKEN (oder OTTILI_CODER_TOKEN) – dein Bearer-Token für die API.
• OTTILI_CLOUD_URL – die Basis-URL der Unified API (Standard: http://localhost:8100).

export OTTILI_WORKSPACE_SLUG="dein-workspace"
export OTTILI_API_TOKEN="dein-token"
export OTTILI_CLOUD_URL="http://localhost:8100"

Umgebung verifizieren

Bevor du den ersten Run startest, prüfst du die Verbindung mit einem Probe-Intake:

ottili coder mission-intake "Füge einen Health-Check-Endpoint hinzu" --workspace dein-workspace

Gibt die CLI eine normalisierte Mission zurück, sind Auth, Workspace und API erreichbar. Mit --json erhältst du das rohe MissionIntake-Wire-Format (identisch zu Cloud und Desktop).

Verfügbare Befehle

• ottili coder mission-intake "<anfrage>" – rohe Anfrage in eine Coder-Mission normalisieren.
• ottili coder mission-refine "<anfrage>" --answer feld=antwort – Mission nach Rückfragen erneut normalisieren.
• ottili coder mission-action <mission-id> --action <clarify|plan|dispatch|cancel|retry|reset> – Lebenszyklus-Aktion ausführen.
• ottili coder mission-generate-plan <mission-id> – prüfbaren technischen Plan erzeugen.
• ottili coder job-dependency-graph <job-id> – validierten, sortierten Task-Abhängigkeitsgraphen anzeigen.
• ottili coder job-dependency-evaluate <job-id> – Abhängigkeitsgraph mit Gate/Barrier-Overrides auswerten (what-if).

Eine Übersicht aller Befehle erhältst du mit ottili coder --help.

Nächste Schritte

• Wie eine [Mission](/docs/coder-missions) zu einem Run wird.
• Die [Modi](/docs/coder-modes) von Ottili Coder.
• [Lokale, Cloud- und hybride Runs](/docs/coder-local-cloud-hybrid-runs).