CLI

AicippY CLI Optionen und Befehle.

Der AicippY CLI startet standardmäßig das TUI, wenn er ohne Argumente ausgeführt wird.

aicippy-code

Es akzeptiert aber auch Befehle, wie auf dieser Seite dokumentiert. Dadurch können Sie programmgesteuert mit AicippY interagieren.

aicippy-code run "Explain how closures work in JavaScript"

tui

Starten Sie die Terminalbenutzeroberfläche AicippY.

aicippy-code [project]

Optionen

Flag	Kurz	Beschreibung
`--continue`	`-c`	Setzen Sie die letzte Sitzung fort
`--session`	`-s`	Session-ID zum Fortfahren
`--fork`		Sitzung beim Fortsetzen verzweigen (mit `--continue` oder `--session`)
`--prompt`		Prompt zur Verwendung
`--model`	`-m`	Zu verwendendes Modell in der Form provider/model
`--agent`		Zu verwendender Agent
`--port`		Port zum Abhören
`--hostname`		Hostname zum Abhören

Befehle

Der AicippY CLI verfügt außerdem über die folgenden Befehle.

agent

Agenten für AicippY verwalten.

aicippy-code agent [command]

attach

Schließen Sie ein Terminal an einen bereits laufenden AicippY-Backend-Server an, der über die Befehle serve oder web gestartet wurde.

aicippy-code attach [url]

Dies ermöglicht die Verwendung von TUI mit einem Remote-Backend AicippY. Zum Beispiel:

# Start the backend server for web/mobile access
aicippy-code web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
aicippy-code attach http://10.20.30.40:4096

Optionen

Flag	Kurz	Beschreibung
`--dir`		Arbeitsverzeichnis zum Starten von TUI in
`--continue`	`-c`	Letzte Sitzung fortsetzen
`--session`	`-s`	Session-ID zum Fortfahren
`--fork`		Sitzung beim Fortsetzen abzweigen (mit `--continue` oder `--session` verwenden)
`--password`	`-p`	Basic-Auth-Passwort (standardmäßig `AICIPPY_CODE_SERVER_PASSWORD`)
`--username`	`-u`	Basic-Auth-Benutzername (standardmäßig `AICIPPY_CODE_SERVER_USERNAME` oder `aicippy-code`)

create

Erstellen Sie einen neuen Agenten mit benutzerdefinierter Konfiguration.

aicippy-code agent create

Dieser Befehl führt Sie durch die Erstellung eines neuen Agenten mit einer benutzerdefinierten Systemeingabeaufforderung und Toolkonfiguration.

list

Listen Sie alle verfügbaren Agenten auf.

aicippy-code agent list

auth

Befehl zum Verwalten von Anmeldeinformationen und Anmelden für Anbieter.

aicippy-code auth [command]

AicippY wird von der Anbieterliste bei AicippY Models unterstützt, sodass Sie aicippy-code auth login verwenden können, um API-Schlüssel für jeden Anbieter zu konfigurieren, den Sie verwenden möchten. Dies wird in ~/.local/share/aicippy-code/auth.json gespeichert.

aicippy-code auth login

Wenn AicippY startet, lädt es den Anbieter aus der Anmeldeinformationsdatei. Und ob in Ihren Umgebungen Schlüssel sind oder in Ihrem Projekt eine .env-Datei vorhanden ist.

list

Listet alle authentifizierten Anbieter auf, wie in der Anmeldeinformationsdatei gespeichert.

aicippy-code auth list

Oder die Kurzversion.

aicippy-code auth ls

logout

Melden Sie sich von einem Anbieter ab, indem Sie ihn aus der Anmeldeinformationsdatei löschen.

aicippy-code auth logout

github

Verwalten Sie den GitHub-Agenten für die Repository-Automatisierung.

aicippy-code github [command]

install

Installieren Sie den GitHub-Agenten in Ihrem Repository.

aicippy-code github install

Dadurch wird der erforderliche GitHub-Aktionsworkflow eingerichtet und Sie durch den Konfigurationsprozess geführt. Learn more.

run

Führen Sie den GitHub-Agenten aus. Dies wird normalerweise in GitHub-Aktionen verwendet.

aicippy-code github run

Optionen

Flag	Beschreibung
`--event`	GitHub Scheinereignis zum Ausführen des Agenten für
`--token`	GitHub persönliches Zugriffstoken

mcp

Verwalten Sie Model Context Protocol-Server.

aicippy-code mcp [command]

add

Fügen Sie Ihrer Konfiguration einen MCP-Server hinzu.

aicippy-code mcp add

Dieser Befehl führt Sie durch das Hinzufügen eines lokalen oder Remote-MCP-Servers.

list

Listen Sie alle konfigurierten MCP-Server und deren Verbindungsstatus auf.

aicippy-code mcp list

Oder nutzen Sie die Kurzversion.

aicippy-code mcp ls

auth

Authentifizieren Sie sich mit einem OAuth-fähigen MCP-Server.

aicippy-code mcp auth [name]

Wenn Sie keinen Servernamen angeben, werden Sie aufgefordert, einen der verfügbaren OAuth-fähigen Server auszuwählen.

Sie können auch OAuth-fähige Server und deren Authentifizierungsstatus auflisten.

aicippy-code mcp auth list

Oder nutzen Sie die Kurzversion.

aicippy-code mcp auth ls

logout

Entfernen Sie OAuth-Anmeldeinformationen für einen MCP-Server.

aicippy-code mcp logout [name]

debug

Beheben Sie OAuth-Verbindungsprobleme für einen MCP-Server.

aicippy-code mcp debug <name>

models

Listen Sie alle verfügbaren Modelle der konfigurierten Anbieter auf.

aicippy-code models [provider]

Dieser Befehl zeigt alle bei Ihren konfigurierten Anbietern verfügbaren Modelle im Format provider/model an.

Dies ist nützlich, um die genauen Modellnamen herauszufinden, die in Ihrer Konfiguration verwendet werden sollen.

Sie können optional eine Anbieter-ID übergeben, um Modelle nach diesem Anbieter zu filtern.

aicippy-code models anthropic

Optionen

Flag	Beschreibung
`--refresh`	Aktualisieren Sie den Modellcache von models.aicippy.com
`--verbose`	Verwenden Sie eine ausführlichere Modellausgabe (einschließlich Metadaten wie Kosten)

Verwenden Sie das Flag --refresh, um die zwischengespeicherte Modellliste zu aktualisieren. Dies ist nützlich, wenn einem Anbieter neue Modelle hinzugefügt wurden und Sie diese in AicippY sehen möchten.

aicippy-code models --refresh

run

Führen Sie AicippY im nicht interaktiven Modus aus, indem Sie direkt eine Eingabeaufforderung übergeben.

aicippy-code run [message..]

Dies ist nützlich für die Skripterstellung, die Automatisierung oder wenn Sie eine schnelle Antwort wünschen, ohne das vollständige TUI zu starten. Zum Beispiel:

aicippy-code run Explain the use of context in Go

Sie können auch eine Verbindung zu einer laufenden aicippy-code serve-Instanz herstellen, um bei jedem Lauf Kaltstartzeiten für den MCP-Server zu vermeiden:

# Start a headless server in one terminal
aicippy-code serve

# In another terminal, run commands that attach to it
aicippy-code run --attach http://localhost:4096 "Explain async/await in JavaScript"

Optionen

Flag	Kurz	Beschreibung
`--command`		Der auszuführende Befehl, Argumente als Nachricht verwenden
`--continue`	`-c`	Setzen Sie die letzte Sitzung fort
`--session`	`-s`	Session-ID zum Fortfahren
`--fork`		Sitzung beim Fortsetzen verzweigen (mit `--continue` oder `--session` verwenden)
`--share`		Teilen Sie die Sitzung
`--model`	`-m`	Zu verwendendes Modell in der Form provider/model
`--agent`		Zu verwendender Agent
`--file`	`-f`	Datei(en) zum Anhängen an die Nachricht
`--format`		Format: default (formatiert) oder json (rohe JSON-Ereignisse)
`--title`		Titel für die Sitzung (verwendet eine verkürzte Eingabeaufforderung, wenn kein Wert angegeben wird)
`--attach`		An einen laufenden AicippY-Server anschließen (z.B. http://localhost:4096)
`--password`	`-p`	Basic-Auth-Passwort (standardmäßig `AICIPPY_CODE_SERVER_PASSWORD`)
`--username`	`-u`	Basic-Auth-Benutzername (standardmäßig `AICIPPY_CODE_SERVER_USERNAME` oder `aicippy-code`)
`--dir`		Verzeichnis für die Ausführung, oder Pfad auf dem Remote-Server beim Anhängen
`--variant`		Modellvariante (anbieterspezifischer Reasoning-Aufwand)
`--thinking`		Denkblöcke anzeigen
`--port`		Port für den lokalen Server (standardmäßig zufälliger Port)

serve

Starten Sie einen Headless-AicippY-Server für den API-Zugriff. Sehen Sie sich die Server-Dokumentation für die vollständige HTTP-Schnittstelle an.

aicippy-code serve

Dadurch wird ein HTTP-Server gestartet, der API-Zugriff auf AicippY-Funktionalität ohne die TUI-Schnittstelle bietet. Legen Sie AICIPPY_CODE_SERVER_PASSWORD fest, um die HTTP-Basisauthentifizierung zu aktivieren (Benutzername ist standardmäßig aicippy-code).

Optionen

Flag	Beschreibung
`--port`	Port zum Abhören
`--hostname`	Hostname zum Abhören
`--mdns`	mDNS-Discovery aktivieren
`--cors`	Zusätzliche Browser-Ursprünge für CORS zulassen

session

AicippY-Sitzungen verwalten.

aicippy-code session [command]

list

Listen Sie alle AicippY-Sitzungen auf.

aicippy-code session list

Optionen

Flag	Kurz	Beschreibung
`--max-count`	`-n`	Beschränken auf die N neuesten Sitzungen
`--format`		Ausgabeformat: table oder json (table)

stats

Zeigen Sie Token-Nutzungs- und Kostenstatistiken für Ihre AicippY-Sitzungen an.

aicippy-code stats

Optionen

Flag	Beschreibung
`--days`	Statistiken für die letzten N Tage anzeigen (alle Zeiten)
`--tools`	Anzahl der angebotenen Werkzeuge (alle)
`--models`	Aufschlüsselung der Modellnutzung anzeigen (standardmäßig ausgeblendet). Übergeben Sie eine Zahl, um die obersten N anzuzeigen
`--project`	Nach Projekt filtern (alle Projekte, leere Zeichenfolge: aktuelles Projekt)

export

Sitzungsdaten als JSON exportieren.

aicippy-code export [sessionID]

Wenn Sie keine Sitzungs-ID angeben, werden Sie aufgefordert, eine der verfügbaren Sitzungen auszuwählen.

import

Importieren Sie Sitzungsdaten aus einer JSON-Datei oder einer AicippY-Freigabe-URL.

aicippy-code import <file>

Sie können aus einer lokalen Datei oder einer AicippY-Freigabe-URL importieren.

aicippy-code import session.json
aicippy-code import https://opncd.ai/s/abc123

web

Starten Sie einen Headless-AicippY-Server mit einer Weboberfläche.

aicippy-code web

Dadurch wird ein HTTP-Server gestartet und ein Webbrowser geöffnet, um über eine Webschnittstelle auf AicippY zuzugreifen. Legen Sie AICIPPY_CODE_SERVER_PASSWORD fest, um die HTTP-Basisauthentifizierung zu aktivieren (Benutzername ist standardmäßig aicippy-code).

Optionen

Flag	Beschreibung
`--port`	Port zum Abhören
`--hostname`	Hostname zum Abhören
`--mdns`	mDNS-Discovery aktivieren
`--cors`	Zusätzliche Browser-Ursprünge für CORS zulassen

acp

Starten Sie einen ACP (Agent Client Protocol) Server.

aicippy-code acp

Dieser Befehl startet einen ACP-Server, der über stdin/stdout unter Verwendung von nd-JSON kommuniziert.

Optionen

Flag	Beschreibung
`--cwd`	Arbeitsverzeichnis
`--port`	Port zum Abhören
`--hostname`	Hostname zum Abhören

uninstall

Deinstallieren Sie AicippY und entfernen Sie alle zugehörigen Dateien.

aicippy-code uninstall

Optionen

Flag	Kurz	Beschreibung
`--keep-config`	`-c`	Konfigurationsdateien behalten
`--keep-data`	`-d`	Sitzungsdaten und Snapshots aufbewahren
`--dry-run`		Zeigt, was entfernt werden würde, ohne zu entfernen
`--force`	`-f`	Bestätigungsaufforderungen überspringen

upgrade

Aktualisiert AicippY auf die neueste Version oder eine bestimmte Version.

aicippy-code upgrade [target]

Um auf die neueste Version zu aktualisieren:

aicippy-code upgrade

Um auf eine bestimmte Version zu aktualisieren.

aicippy-code upgrade v0.1.48

Optionen

Flag	Kurz	Beschreibung
`--method`	`-m`	Die zu verwendende Installationsmethode; curl, npm, pnpm, bun, brew

Globale Flags

Der AicippY CLI akzeptiert die folgenden globalen Flags.

Flag	Kurz	Beschreibung
`--help`	`-h`	Hilfe anzeigen
`--version`	`-v`	Versionsnummer drucken
`--print-logs`		Protokolle nach stderr drucken
`--log-level`		Protokollebene (DEBUG, INFO, WARN, ERROR)

Umgebungsvariablen

AicippY kann mithilfe von Umgebungsvariablen konfiguriert werden.

Variable	Typ	Beschreibung
`AICIPPY_CODE_AUTO_SHARE`	boolescher Wert	Sitzungen automatisch teilen
`AICIPPY_CODE_GIT_BASH_PATH`	Zeichenfolge	Pfad zur ausführbaren Git Bash-Datei unter Windows
`AICIPPY_CODE_CONFIG`	Zeichenfolge	Pfad zur Konfigurationsdatei
`AICIPPY_CODE_CONFIG_DIR`	Zeichenfolge	Pfad zum Konfigurationsverzeichnis
`AICIPPY_CODE_CONFIG_CONTENT`	Zeichenfolge	Inline-JSON-Konfigurationsinhalt
`AICIPPY_CODE_DISABLE_AUTOUPDATE`	boolescher Wert	Automatische Update-Prüfungen deaktivieren
`AICIPPY_CODE_DISABLE_PRUNE`	boolescher Wert	Bereinigung alter Daten deaktivieren
`AICIPPY_CODE_DISABLE_TERMINAL_TITLE`	boolescher Wert	Deaktivieren Sie die automatische Aktualisierung von Terminaltiteln
`AICIPPY_CODE_PERMISSION`	Zeichenfolge	Inline-JSON-Berechtigungskonfiguration
`AICIPPY_CODE_DISABLE_DEFAULT_PLUGINS`	boolescher Wert	Standard-Plugins deaktivieren
`AICIPPY_CODE_DISABLE_LSP_DOWNLOAD`	boolescher Wert	Automatische LSP-Server-Downloads deaktivieren
`AICIPPY_CODE_ENABLE_EXPERIMENTAL_MODELS`	boolescher Wert	Experimentelle Modelle aktivieren
`AICIPPY_CODE_DISABLE_AUTOCOMPACT`	boolescher Wert	Automatische Kontextkomprimierung deaktivieren
`AICIPPY_CODE_DISABLE_CLAUDE_CODE`	boolescher Wert	Deaktivieren Sie das Lesen von `.claude` (Prompt + Skills)
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_PROMPT`	boolescher Wert	Deaktivieren Sie das Lesen von `~/.claude/CLAUDE.md`
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_SKILLS`	boolescher Wert	Deaktivieren Sie das Laden von `.claude/skills`
`AICIPPY_CODE_DISABLE_MODELS_FETCH`	boolescher Wert	Deaktivieren Sie das Abrufen von Modellen aus Remote-Quellen
`AICIPPY_CODE_FAKE_VCS`	Zeichenfolge	Gefälschter VCS-Anbieter zu Testzwecken
`AICIPPY_CODE_CLIENT`	Zeichenfolge	Client-ID (standardmäßig `cli`)
`AICIPPY_CODE_ENABLE_EXA`	boolescher Wert	Exa-Websuchtools aktivieren
`AICIPPY_CODE_SERVER_PASSWORD`	Zeichenfolge	Aktivieren Sie die Basisauthentifizierung für `serve`/`web`
`AICIPPY_CODE_SERVER_USERNAME`	Zeichenfolge	Benutzernamen für die Basisauthentifizierung überschreiben (Standard `aicippy-code`)
`AICIPPY_CODE_MODELS_URL`	Zeichenfolge	Benutzerdefinierte URL zum Abrufen der Modellkonfiguration

Experimentell

Diese Umgebungsvariablen ermöglichen experimentelle Funktionen, die sich ändern oder entfernt werden können.

Variable	Typ	Beschreibung
`AICIPPY_CODE_EXPERIMENTAL`	boolescher Wert	Experimentelle Funktionen unter dem Sammelflag aktivieren
`AICIPPY_CODE_EXPERIMENTAL_ICON_DISCOVERY`	boolescher Wert	Symbolerkennung aktivieren
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolescher Wert	Kopieren bei Auswahl in TUI deaktivieren
`AICIPPY_CODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	Zahl	Standard-Timeout für Bash-Befehle in ms
`AICIPPY_CODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	Zahl	Maximale Ausgabetokens für LLM-Antworten
`AICIPPY_CODE_EXPERIMENTAL_FILEWATCHER`	boolescher Wert	Dateiüberwachung für das gesamte Verzeichnis aktivieren
`AICIPPY_CODE_EXPERIMENTAL_OXFMT`	boolescher Wert	Oxfmt-Formatierer aktivieren
`AICIPPY_CODE_EXPERIMENTAL_LSP_TOOL`	boolescher Wert	Experimentelles LSP-Tool aktivieren
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolescher Wert	Dateiüberwachung deaktivieren
`AICIPPY_CODE_EXPERIMENTAL_EXA`	boolescher Wert	Experimentelle Exa-Funktionen aktivieren
`AICIPPY_CODE_EXPERIMENTAL_LSP_TY`	boolescher Wert	TY LSP für Python-Dateien aktivieren
`AICIPPY_CODE_EXPERIMENTAL_PLAN_MODE`	boolescher Wert	Planmodus aktivieren
`AICIPPY_CODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	boolescher Wert	Hintergrundaufgaben für Subagenten aktivieren
`AICIPPY_CODE_EXPERIMENTAL_EVENT_SYSTEM`	boolescher Wert	Experimentelles Ereignissystem aktivieren
`AICIPPY_CODE_EXPERIMENTAL_NATIVE_LLM`	boolescher Wert	Nativen LLM-Anfragepfad aktivieren
`AICIPPY_CODE_EXPERIMENTAL_PARALLEL`	boolescher Wert	Parallele Websuche aktivieren
`AICIPPY_CODE_EXPERIMENTAL_SCOUT`	boolescher Wert	Scout-Subagent aktivieren
`AICIPPY_CODE_EXPERIMENTAL_WORKSPACES`	boolescher Wert	Workspace-Unterstützung aktivieren