Windows Befehlszeile

Die AirCode Ø Windows -Installation installiert ein aircode -Befehl für PowerShell und Befehlszeile. Es nutzt die bereits in der Desktop-Anwendung eingebettete Node.js -Laufzeit und ConPTY-Unterstützung; WSL und eine Systeminstallation Node.js sind nicht erforderlich.

Öffnen Sie ein neues -Terminal nach der Installation oder Aktualisierung von AirCode Ø , damit es den aktualisierten Benutzer PATHerhält, und überprüfen Sie dann den Befehl:

aircode version
aircode serve --help

Der Installer löst den Befehl in Bezug auf seinen eigenen Installationsverzeichnis, so dass die Auswahl eines benutzerdefinierten Verzeichnisses in der Installation unterstützt wird.

Desktop-Ausführbar oder Server-Befehl?

Wenn Sie wollen, …	Verwendung
Anschließen eines Electron-Fensters an einen lokalen oder Remote-Server	Öffnen Sie die AirCode Ø Desktop-App
Führen Sie den eingebetteten lokalen Server aus und verwenden Sie ihn von Electron	Öffnen Sie die Desktop-App und wählen Sie Auf dieser Maschine ausführen
Führen Sie einen Server ohne ein Electron-Fenster	Öffnen Sie ein Terminal und führen Sie `aircode serve` aus

Das Desktop-Executable ist kein unterstützter --serve -Eingangspunkt: Es öffnet immer Electron. Der Befehl aircode verwendet die mit der Desktop-App installierte Laufzeit und Server-Payload, startet jedoch einen separaten Vordergrundprozess. Siehe Desktop-Betriebsmodi für die vollständige Zusammenfassung des Lebenszyklus.

Server starten

serve ist der Standardbefehl, so dass diese Formulare gleichwertig sind:

aircode serve --projects-root "D:\Projects"
aircode --projects-root "D:\Projects"

Der Server läuft im Vordergrund und schreibt Logs an dieses Terminal. Drücken Sie Ctrl+C , um es sauber zu stoppen. Jede Projektwurzel erhält ihren eigenen isolierten Laufzeit-Zustand und den Sitzungsnamespace. Wenn der bevorzugte Port bereits von einer anderen Wurzel verwendet wird, wählt AirCode Ø automatisch den nächsten verfügbaren Port aus.

Optionen zum Servieren

Option	Standard	Zweck und gleichwertige Einstellungen
`--projects-root <dir>`	aktuelle Verzeichnis	Wurzel, deren Unterordner AirCode Ø als Projekte präsentiert. Die Direktion muss schon existieren. Die ENV: `AIRCODE_PROJECTS_ROOT`; JSON: `projectsRoot`
`--host <address>`	Tailscale IP, ansonsten `127.0.0.1`	Netzwerk-Schnittstelle, auf der der HTTP -Server zuhört. Die ENV: `AIRCODE_HOST`; JSON: `host`
`--port <number>`	`7860`	HTTP Port von 1 bis 65535. Ein explizit besetzter Port scheitert anstatt sich stillschweigend zu ändern. Die ENV: `AIRCODE_PORT`; JSON: `port`
`--public-url <url>`	keine	Öffentliche HTTP(S) Basis URL in Links und Benachrichtigungen verwendet. Die ENV: `AIRCODE_PUBLIC_URL`; JSON: `publicUrl`
`--config <file>`	Benutzerkonfigurationsdatei	Alternative JSON Konfigurationsdatei. Die ENV: `AIRCODE_CONFIG`
`--state-dir <dir>`	Benutzerstatusverzeichnis	Alternative Laufzeit-Status-Verzeichnis Die ENV: `AIRCODE_STATE_DIR`
`--password <value>`	generiert oder konfiguriert	Zugriff auf das Passwort für diesen Prozess. Bequem, aber sichtbar in der Shell-Geschichte und möglicherweise Prozessinspektion. Die ENV: `AIRCODE_AUTH_PASSWORD`; JSON: `authPassword`
`--password-file <file>`	keine	Lesen des Zugriffsworts aus einer privaten Datei
`--no-password`	abgeschaltet	Deaktivieren Sie die Authentifizierung explizit; verwenden Sie sie nur auf einer absichtlich vertrauenswürdigen Schnittstelle
`-h`, `--help`	—	Anzeigen von Befehlshilfe, ohne den Server zu starten

Die standardmäßige Konfigurationsdatei Windows ist %USERPROFILE%\.config\aircode\config.json; die Standardeinstellungen für den Laufzeitzustand auf die root-spezifischen Verzeichnisse unter %USERPROFILE%\.local\state\aircode\instances.

Wege, die Räume enthalten, müssen zitiert werden. Sowohl --option value als auch --option=value werden akzeptiert. Befehlszeilenoptionen haben Vorrang vor Umgebungsvariablen, die Vorrang vor config.jsonhaben, und dann Standardvariablen.

Bei der ersten Ausführung erzeugt AirCode Ø ein Passwort, speichert es in der ausgewählten Konfigurationsdatei und druckt es einmal aus. --password ist verfügbar, wenn eine vollständige Kommandozeilenprovisionierung erforderlich ist, aber sein Wert kann durch Prozessinspektion und Shell-Historik freigegeben werden. Bevorzugen Sie --password-file, eine geschützte Konfigurationsdatei oder eine sicher gelieferte AIRCODE_AUTH_PASSWORD. Die Deaktivierung von auth muss mit --no-passwordexplizit sein.

Beispiele

Mehrere Wurzeln gleichzeitig

Öffnen Sie ein Terminal in der ersten Wurzel:

cd "$HOME\Desktop"
aircode

Öffnen Sie dann ein anderes Terminal in einer anderen Wurzel:

cd "$HOME\Documents"
aircode

Wenn Tailscale dem Computer 100.84.12.30 zugewiesen hat, können die beiden Banner http://100.84.12.30:7860 und http://100.84.12.30:7861melden. Die Instanzen teilen keinen Runtime-Status oder Sitzungen. Wenn Sie aircode wieder aus einer bereits aktiven Wurzel ausführen, melden Sie anstelle eines Duplikats den vorhandenen URL .

Nur lokale Maschine

aircode serve `
  --projects-root "D:\Projects" `
  --host 127.0.0.1 `
  --port 7860

Öffnen Sie http://127.0.0.1:7860.

Tailscale oder eine private VPN

Binden Sie die genaue VPN -Adresse, die der Windows -Maschine zugewiesen wurde:

aircode serve `
  --projects-root "D:\Projects" `
  --host 100.84.12.30 `
  --port 7860

Andere Geräte im gleichen privaten Netzwerk können dann http://100.84.12.30:7860öffnen. Bevorzugen Sie eine genaue VPN -Adresse gegenüber 0.0.0.0.

Lokales Netzwerk

aircode serve `
  --projects-root "D:\Projects" `
  --host 192.168.1.25 `
  --port 7860

Die Windows Firewall kann Sie bitten, die Verbindung zu erlauben. Erlauben Sie nur die Netzwerkprofile, die Sie verwenden möchten.

Reverse Proxy oder Tunnel URL

aircode serve `
  --projects-root "D:\Projects" `
  --host 127.0.0.1 `
  --port 7860 `
  --public-url "https://aircode.example.com"

--public-url sagt nur AirCode Ø , welche Adresse in generierte Links platziert werden soll. Es nicht öffnen Sie einen Firewall-Port, starten Sie einen umgekehrten Proxy oder erstellen Sie einen Tunnel. Verwenden Sie Remote Access für den integrierten Ausgangstunnel, Tailscale oder private Netzwerkleitungen.

Separate Konfiguration und Status

aircode serve `
  --projects-root "D:\Projects" `
  --config "D:\AirCodeData\config.json" `
  --state-dir "D:\AirCodeData\state"

Wenn ein anderes Terminal gegen diese Instanz einen Lebenszyklusbefehl ausführen muss, stellen Sie zuerst den gleichen Statusverzeichnis ein:

$env:AIRCODE_STATE_DIR = "D:\AirCodeData\state"
aircode status
aircode stop

Desktop-App-Koexistenz

Der CLI -Front-Server und der lokale Server, der vom Desktop-Fenster verwaltet wird, sind getrennte Prozesse. aircode status und aircode stop zielen nur auf den Front-end- CLI -Server ab; sie berichten nicht oder steuern den Desktop-verwalteten Server nicht. Bevor Sie den gleichen Host und den gleichen Port erneut verwenden, entfernen Sie das AirCode Ø -Symbol aus seinem Benachrichtigungsbereich, nicht nur, indem Sie sein Fenster schließen. Alternativ geben Sie dem CLI -Server einen anderen Port.

Beginnend mit einem Terminal wird die AirCode Ø Webanwendung und ihre authentifizierte API ausgesetzt. Es verwandelt den Projektverzeichnis nicht in einen öffentlichen Dateianteil: Der Dateizugriff bleibt auf Projekte unter projectsRoot abgedeckt und wird vom Server durchgesetzt.

Weitere Einstellungen

Agent-ausführbare Wege, Sitzungslimits, Browser-Steuerungen, Wissen, Orchestrierung, Benachrichtigungen und Token-Optimierung bleiben über Umweltvariablen und config.jsonverfügbar. Siehe Konfiguration für die vollständige Konfigurationspriorität und gemeinsame Einstellungen.