macOS-Einrichtung

Überblick

YeePilot läuft nativ auf macOS und unterstützt sowohl Intel- als auch Apple-Silicon-Macs. Diese Anleitung behandelt Installation, Keychain-Integration, Gatekeeper-Berechtigungen und macOS-spezifische Besonderheiten.

Systemanforderungen

Installation

Schnellinstallation (Empfohlen)

Das Installationsskript erkennt automatisch die Architektur Ihres Macs und installiert die richtige Binärdatei:

curl -fsSL https://yee.to/install.sh | bash

Dies wird:

1. Erkennen, ob Sie auf Intel oder Apple Silicon arbeiten.
2. Die entsprechende native Binärdatei herunterladen.
3. Die Download-Prüfsumme verifizieren.
4. Die Binärdatei unter /usr/local/bin/yeepilot installieren.

Überprüfen Sie nach der Installation die Funktionsfähigkeit:

yeepilot version

Manuelle Installation

1. Laden Sie das richtige Archiv von der Release-Seite (opens in new tab) herunter:

   • yeepilot-darwin-amd64.tar.gz für Intel-Macs
   • yeepilot-darwin-arm64.tar.gz für Apple-Silicon-Macs (M1, M2, M3, M4)

2. Entpacken und installieren:

tar xzf yeepilot-darwin-arm64.tar.gz
sudo mv yeepilot /usr/local/bin/
sudo chmod +x /usr/local/bin/yeepilot

3. Installation überprüfen:

yeepilot version

Gatekeeper-Berechtigungen

macOS Gatekeeper kann YeePilot beim ersten Ausführen blockieren, da die Binärdatei nicht mit einem Apple-Entwicklerzertifikat signiert ist. Sie sehen eine Meldung wie: "yeepilot" kann nicht geöffnet werden, da der Entwickler nicht verifiziert werden kann.

Über Systemeinstellungen erlauben

1. Öffnen Sie Systemeinstellungen (oder Systemeinstellungen auf älteren macOS-Versionen).
2. Gehen Sie zu Datenschutz & Sicherheit.
3. Scrollen Sie nach unten zum Abschnitt Sicherheit.
4. Sie sollten eine Meldung sehen, dass yeepilot blockiert wurde. Klicken Sie auf Trotzdem erlauben.
5. Führen Sie yeepilot version erneut aus und klicken Sie im Bestätigungsdialog auf Öffnen.

Über das Terminal erlauben

Alternativ entfernen Sie das Quarantäne-Attribut direkt:

xattr -d com.apple.quarantine /usr/local/bin/yeepilot

Dies muss nur einmal durchgeführt werden. Nachfolgende Updates können eine Wiederholung dieses Schritts erfordern.

Ersteinrichtung

Führen Sie die interaktive Einrichtung aus, um Ihren KI-Anbieter zu konfigurieren:

yeepilot setup

Dies erstellt Ihre Konfigurationsdatei unter ~/.yeepilot/config.yaml.

Zugangsdatenspeicherung

YeePilot verwendet automatisch den macOS Keychain, um API-Schlüssel und Authentifizierungstoken zu speichern. Dies bietet sichere, verschlüsselte Speicherung, die sich in Ihr System-Login integriert.

• Zugangsdaten werden im Standard-Login-Keychain gespeichert.
• Beim ersten Speichern oder Abrufen von Zugangsdaten durch YeePilot sehen Sie möglicherweise eine Keychain-Zugriffsaufforderung. Klicken Sie auf Immer erlauben, um wiederholte Aufforderungen zu vermeiden.
• Zugangsdaten sind im Keychain-Zugriff mit yeepilot beschriftet, um sie leicht zu identifizieren.

Gespeicherte Zugangsdaten anzeigen

Öffnen Sie Schlüsselbundverwaltung (unter Programme > Dienstprogramme) und suchen Sie nach yeepilot, um gespeicherte Zugangsdaten zu sehen.

Kein zusätzliches Setup erforderlich

Anders als unter Linux werden für die Zugangsdatenspeicherung auf macOS keine zusätzlichen Pakete benötigt. Der Keychain ist auf allen macOS-Installationen verfügbar.

Sandbox-Einschränkungen

macOS unterstützt keine Linux-Kernel-Namespaces. YeePilot verwendet stattdessen Prozessebenen-Ressourcenlimits, die grundlegende Isolation bieten:

• CPU-Zeitlimits -- Befehle werden beendet, wenn sie die konfigurierte CPU-Zeit überschreiten.
• Speicherlimits -- Prozessspeicher wird auf das konfigurierte Maximum begrenzt.
• Dateigrößenlimits -- Die Erstellung einzelner Dateien wird begrenzt.

Zur Konfiguration der Sandbox-Einstellungen:

# ~/.yeepilot/config.yaml
sandbox:
  enabled: true
  use_namespaces: false  # Nicht verfügbar auf macOS, automatisch deaktiviert
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64

Beachten Sie, dass use_namespaces auf macOS unabhängig vom Konfigurationswert automatisch auf false gesetzt wird. Es ist keine Aktion Ihrerseits erforderlich.

Für vollständige Namespace-Isolation sollten Sie YeePilot in einer Linux-Virtual-Machine oder einem Docker-Container auf Ihrem Mac ausführen.

Apple-Silicon-Hinweise

YeePilot bietet eine native arm64-Binärdatei für Apple-Silicon-Macs (M1, M2, M3, M4-Serie). Diese läuft ohne Rosetta-2-Übersetzung und gewährleistet optimale Leistung.

Um zu bestätigen, dass Sie die native Binärdatei ausführen:

file $(which yeepilot)

Die Ausgabe sollte arm64 für Apple Silicon oder x86_64 für Intel enthalten.

Wenn Sie versehentlich die Intel-Version auf einem Apple-Silicon-Mac installiert haben, funktioniert sie zwar über Rosetta 2, aber eine Neuinstallation mit der richtigen Architektur wird empfohlen:

curl -fsSL https://yee.to/install.sh | bash

Das Installationsskript erkennt und installiert immer die richtige Architektur.

Terminal-Empfehlungen

YeePilots TUI funktioniert am besten mit Terminals, die Folgendes unterstützen:

• 256 Farben oder True Color -- Für korrekte Theme-Darstellung.
• Unicode -- Für Rahmenzeichen und Statusindikatoren.
• Größenänderung -- Die TUI passt sich an Terminal-Größenänderungen an.

Alle beliebten macOS-Terminals funktionieren gut:

Aktualisierung

Auf die neueste Version aktualisieren:

yeepilot update

Möglicherweise müssen Sie die Binärdatei nach einem Update erneut in Gatekeeper erlauben (siehe Abschnitt Gatekeeper-Berechtigungen oben).

Deinstallation

YeePilot und alle Daten entfernen:

yeepilot uninstall --all

Oder nur die Binärdatei entfernen und die Konfiguration behalten:

yeepilot uninstall --binary-only

Für eine manuelle Entfernung:

sudo rm /usr/local/bin/yeepilot
rm -rf ~/.yeepilot

Gespeicherte Keychain-Einträge können manuell über die Schlüsselbundverwaltung entfernt werden, indem Sie nach yeepilot suchen und die passenden Einträge löschen.