alt
Entwicklerdokumentation

Entwicklerdokumentation

CLI

Richten Sie Alt-Integrationen mit einem interaktiven Einrichtungsassistenten im Terminal ein.

Die altalt CLI führt durch die Einrichtung von MCP, REST API und Webhooks, ohne bestehende Konfigurationen zu ersetzen. Führe sie im Verzeichnis des zu verbindenden Projekts aus:

npx
npx altalt

Erfordert Node.js 18 oder neuer. npx lädt das aktuelle CLI-Paket für diesen Lauf; eine globale Installation ist nicht nötig.

Was der Einrichtungsassistent erledigt

  1. 1

    MCP verbinden

    Erkennt Claude Code und Codex, bietet die Cursor-Einrichtung an und verbindet den gehosteten Alt-MCP-Server per Browser-OAuth. Manuelle Konfiguration: MCP.

  2. 2

    API und Webhooks prüfen

    Öffnet die Account-Konsole, validiert den eingefügten API-Key, speichert ihn im aktuellen Projekt und kann nach Bestätigung ein Testevent an einen gewählten Webhook-Endpunkt senden.

  3. 3

    Implementierung übergeben

    Übergibt nach Bestätigung dem Coding-Agent einen Prompt auf Basis der maschinenlesbaren Entwicklerdokumentation. Ohne unterstützten Agent wird der Prompt zum Einfügen ausgegeben.

Modi und Flags

--mcp-onlyDie Einrichtung auf MCP per Browser-OAuth begrenzen und danach die Agent-Übergabe anbieten.
--api-onlyDie Einrichtung auf REST-API- und Webhook-Prüfung begrenzen und danach die Agent-Übergabe anbieten.
--print-promptDen Prompt für den Coding-Agent ausgeben und beenden.
--devDen Entwicklungs-Stack verwenden. Nur für QA vor Releases.
--versionDie installierte CLI-Version ausgeben.
--helpBefehlsverwendung und verfügbare Flags ausgeben.

Konfigurations- und Key-Sicherheit

  • Die CLI prüft den Key vor Änderungen an einer Umgebungsdatei und speichert ihn als ALT_API_KEY im aktuellen Projektverzeichnis.
  • Bestehende Alt-MCP-Konfigurationen werden weder gelöscht noch überschrieben. Bei Bedarf wird OAuth parallel als alt-oauth hinzugefügt.
  • Agent-Übergabe und Webhook-Testversand erfordern eine ausdrückliche Bestätigung. Beachte vor dem Deployment die Key-Hinweise unter Sicherheit.

Aktuelle Verfügbarkeit

Das CLI-Paket ist öffentlich, aber produktives OAuth und die Ausgabe von API-Keys sind während des Dogfoodings auf Alt-Administratoren beschränkt. Bestehende MCP-Verbindungen per API-Key bleiben unterstützt. Gibt die Konsole 404 zurück oder ist keine OAuth-Zustimmung möglich, ist dein Account noch nicht freigeschaltet.