CLI-Überblick

Die suya-CLI ist die primäre Schnittstelle zu Subaya — gleichermaßen für Menschen, KI-Agenten und CI. Alles, was Sie über die Plattform tun können, beginnt hier; die Web-Konsole unter subaya-dev.com dient für Ergebnisse, Wellenformen, Berichte und Reviews. Siehe Kernkonzepte für das mentale Modell und den Schnellstart, um von der Installation bis zu einer erfolgreichen Simulation zu gelangen.

Globale Flags

Diese Flags funktionieren bei jedem Befehl:

Flag	Beschreibung
--host <url>	Ziel-API-Host. Standard ist https://subaya-dev.com.
--token <token>	Verwendet einen expliziten Auth-Token für diesen Aufruf.
--json	Gibt maschinenlesbare JSON-Ausgabe aus.
--pretty	Formatiert die Ausgabe lesbar für Menschen.
-q, --quiet	Unterdrückt nicht wesentliche Ausgaben.
-v, --verbose	Gibt zusätzliche Diagnosedetails aus.

--json passt gut zu Agenten und CI; --pretty ist der freundliche Standard für ein Terminal.

Projektkonfiguration — .subaya/config.toml

Die meisten projektbezogenen Befehle lesen ihr Standard---project aus einer lokalen .subaya/config.toml-Datei. Sobald ein Projekt in einem Verzeichnis initialisiert ist (siehe suya project), arbeiten Befehle wie suya project show, suya sim run und suya repo status mit diesem Projekt, ohne dass Sie jedes Mal --project übergeben müssen. Übergeben Sie --project <project-id> explizit, um dies zu überschreiben.

Authentifizierung

Zwei Modi werden gegen dieselbe API aufgelöst — alle Details unter Authentifizierung & API-Schlüssel und in der suya auth-Referenz:

• SUBAYA_API_KEY — eine Umgebungsvariable für Agenten und CI. Kein Browser.
• suya auth login — OAuth-Browser-Flow für menschliche Entwickler.

export SUBAYA_API_KEY="sk_..."
suya auth whoami

Befehlsgruppen

Gruppe	Was sie tut
suya auth	Anmelden, abmelden und Ihre Identität einsehen.
suya project	Projekte und Phasen erstellen, auflisten und verwalten.
suya sim	Cloud-Simulationen ausführen und Ergebnisse einsehen.
suya hw	Hardware-Validierungsläufe und Agentenverwaltung (BitCrucible).
suya rag	Die Wissensdatenbank durchsuchen und lesen.
suya plan	Planungsdokumente, Arbeitspakete und Diagramme.
suya repo	Ein GitHub-Repo für ein Projekt erstellen oder verbinden.
suya device	Den Gerätekatalog durchsuchen und ein Gerät zuweisen.
Sitzung	suya attach / suya detach für Ihren Sitzungs-Pod.

Weitere Befehlsgruppen

Diese Gruppen runden die Oberfläche ab:

• suya arch — Architektur- und Embedded-Pin-Planung (Module, Pin-Pläne, Peripherie-/Takt-Konfiguration, validate, generate, .ioc-Commit).
• suya req — Anforderungen eines Projekts hinzufügen und auflisten (suya req add, suya req list).
• suya review — Code- und Design-Reviews (create, show, list, comment, reply, resolve, approve und mehr).
• suya diagram — Mermaid-Diagramme erstellen und nach SVG/PNG rendern (create, update, show, list, export, render, delete).

Top-Level-Befehle

Befehl	Beschreibung
suya version	Gibt Versionsmetadaten aus.
suya update [--check]	Aktualisiert auf die neueste Version; --check meldet nur die Verfügbarkeit.
suya install [--skills] [--path <p>] [--force]	Installiert Subaya-Integrationen (suya-cli + Planner-Skill-Bundles).
suya completion <shell>	Gibt die Shell-Autovervollständigung für die angegebene Shell aus.