CLI

keon ist ein Drop-in-Client im neonctl-Stil für die Kisenon-Plattform.

Installation auf macOS / Linux

curl -fsSL https://kisenon.com/install.sh | bash

Erkennt Ihre Plattform, lädt das passende keon-<os>-<arch>-Binary herunter, verifiziert den sha256 gegen /dl/latest/manifest.json und installiert nach /usr/local/bin (oder ~/.local/bin).

Installation auf Windows

Der primäre Kanal ist winget:

winget install Seiraiyu.Keon

Oder führen Sie das Installationsskript direkt aus:

iwr -useb https://kisenon.com/install.ps1 | iex

Erste Anmeldung

keon login
keon me

keon login führt einen Loopback-OAuth-Flow aus — kein Einfügen von Schlüsseln. Es startet einen lokalen Listener auf einem zufälligen Port, öffnet Ihren Browser zur Authorize-Seite der Konsole und wartet auf den Redirect. Nachdem Sie autorisiert haben, tauscht die CLI den Einmal-Code bei POST /v1/cli/exchange gegen einen langlebigen API-Schlüssel mit nsk_-Präfix, beschränkt auf Ihre aktive Organisation.

Der Schlüssel wird unter ~/.config/keon/credentials.json mit Modus 0600 persistiert. Die CLI behält nur den resultierenden Schlüssel — niemals den OAuth-Code, State oder ein Provider-Token. keon logout widerruft den Schlüssel serverseitig und entfernt die Datei; Sie können ihn auch jederzeit über Einstellungen → API-Schlüssel widerrufen. Siehe Auth für den vollständigen Flow.

Gängige Befehle

keon projects list
keon branches list --project <id>
keon connection-string <branch> --project <id>

Das Löschen eines Projekts löscht auch seine Branches und Endpoints — übergeben Sie --cascade, oder die API gibt 409 has_branches zurück:

keon projects delete <id> --cascade

Dasselbe --cascade-Flag gilt für keon branches delete <id>.

Agent-Workflows

keon deckt die agentensichere Oberfläche ab, nicht nur Projekte und Branches:

• keon sandbox — agenten-Sandboxes antreiben: ephemere, Capture-and-Promote-Datenbankumgebungen für Agenten.
• keon ledger — das Promote-Ledger lesen und Capture-/Promote- Attestierungen verifizieren.
• keon ip-allow — die IP-Zulassungsliste eines Projekts verwalten.

Weitere Top-Level-Befehle umfassen orgs, endpoints, databases, roles, snapshots, operations, usage und audit. Führen Sie keon --help für den vollständigen Satz aus.

Ausgabeformat

Standard ist JSON. Für Tabellen: keon config set output table oder geben Sie --output table pro Befehl an.

Den Claude-Skill installieren

keon install --skills

Legt eine SKILL.md + Referenzdokumente in ./.claude/skills/keon/ ab, sodass ein Claude-Agent die CLI ohne Einrichtungsschritt antreiben kann.

Fehlerbehebung

macOS: „developer cannot be verified"

Passiert nur, wenn das Binary über einen Browser mit gesetztem Gatekeeper-Attribut heruntergeladen wurde. Entfernen Sie es:

xattr -d com.apple.quarantine $(which keon)

Windows: SmartScreen-Warnung

Klicken Sie auf „More info" → „Run anyway". Einmal pro Rechner. Die Installation über winget install Seiraiyu.Keon vermeidet die Aufforderung. (Die macOS-Binaries sind signiert und notarisiert; die SmartScreen-Reputation für Windows-Builds baut sich mit der Zeit auf.)

Einen Bug melden

github.com/Seiraiyu/seiraiyu-neon/issues