Orca installiert, aber kein orca-Befehl: Prüfen Sie zuerst, ob es als orca-ide installiert wurde
Orca, nur die Installationsseite: Unter Linux lautet der Befehl orca-ide, nicht orca; Homebrew braucht den Befehl mit dem Tap; die CLI meldet „command not found“; SSH verbindet, startet aber kein Remote-Terminal; die Handy-Kopplung schlägt fehl. Die offiziellen Dokumente widmen jedem dieser Punkte einen Satz (geprüft am 2026-09-23).
Aktualisiert 2026-09-23
Vier Dinge vorab
Befehls- und Paketnamen
Offiziell wird es unter Linux als orca-ide installiert, damit der GNOME-Screenreader nicht überdeckt wird; .deb/.rpm verwenden denselben Namen aus demselben Grund. Führen Sie which orca-ide aus, bevor Sie von einer fehlgeschlagenen Installation ausgehen.
Der vollständige brew-Befehl
Das Cask für diese App ist stablyai/orca/orca; das schlichte orca ist seit 2026-09-01 deaktiviert, Grund: fails_gatekeeper_check.
Wo sich die CLI registriert
Die offizielle Lösung bei „command not found“ ist, die CLI unter Einstellungen → Allgemein → Orca CLI zu registrieren; unter macOS wird dabei ein Shim in ~/.local/bin installiert. Prüfen Sie anschließend, ob dieses Verzeichnis im PATH liegt.
Paketformat ≠ Version
AppImage/.deb/.rpm installieren dieselbe App; offiziell unterscheidet sich nur, wie Updates zu Ihnen gelangen – schließen Sie aus dem Paketformat nicht auf Funktionsunterschiede.
Zur Klarstellung: dieselbe App, der Befehlsname ist nicht immer orca
Die offizielle Installationsseite widmet dem einen eigenen Unterabschnitt mit der Überschrift „The CLI command is orca-ide“, dessen Text lautet „On Linux the Orca CLI installs as orca-ide, not orca“, und auch die Begründung wird zitiert: „GNOME Orca — the screen reader that ships by default on Ubuntu and other GNOME desktops — already owns /usr/bin/orca, and Orca will not shadow it“. Derselbe Abschnitt ergänzt eine Zeile: „The .deb and .rpm packages are named orca-ide for the same reason“. Unter Linux ist „Ich habe es installiert und orca tut nichts“ also meist keine fehlgeschlagene Installation – dieser Pfad gehörte nie zu Orca.
Am selben Tag gezählt
Die Seite „GitHub Releases latest“, abgerufen am 2026-09-23, liefert v1.4.207, veröffentlicht am 2026-09-22T09:44:40Z, mit Assets unter anderem für orca-macos-x64.dmg, orca-windows-setup.exe und orca-linux.AppImage; die Lizenz lautet MIT laut der LICENSE-Datei des Repositorys (das Lizenzfeld der API stimmt überein). Zähler, die sich minütlich ändern, etwa Stars und Forks, bleiben aus dem Text dieser Seite heraus – sie gehören in die Vergleichstabelle auf der P4-Seite, in der jede Zahl ihren eigenen Abruftag trägt. Auf dem Handy läuft iOS über den App Store (der interne App-Name in diesem Eintrag ist orca-ide); für Android ist der offizielle Kanal app-release.apk auf der Releases-Seite plus eine kurze Installationsanleitung.
Zeitachse
2026-09-01: In den öffentlichen Metadaten von Homebrew ist dies das disable_date des Orca-Casks, und sein disable_reason lautet fails_gatekeeper_check. Diese Seite wurde am 2026-09-23 geprüft, und dieser Cask steht weiterhin auf disabled: true, deprecated: false. Er wurde also nicht „durch Orca ersetzt“, sondern von Homebrew deaktiviert.
2026-09-22: Die sechs offiziellen Dokumentationsseiten, die diese Seite nutzt (install, troubleshooting, ssh, mobile, android-apk, headless Linux server), und die README wurden wortgetreu abgerufen und archiviert; jedes englische Zitat hier findet sich Wort für Wort in diesem Archiv.
2026-09-23: Der viersprachige Text dieser Seite ist final und am offiziellen Wortlaut abgeglichen. CLI-Namen, Paketnamen und Cask-Status ändern sich je nach Version, daher nennt jeder Abschnitt sein Prüfdatum; spätere Änderungen werden datiert neu erfasst, ohne stillen Austausch.
Selbst beheben vs. Dokumentation
Wörtlich in der Doku
Geprüft am 2026-09-23; sieben Aussagen stimmen Wort für Wort mit offiziellen Seiten überein: 1) Unter Linux wird die Orca-CLI als orca-ide installiert, nicht als orca; 2) GNOME Orca – der Screenreader, der unter Ubuntu und anderen GNOME-Desktops standardmäßig mitgeliefert wird – belegt bereits /usr/bin/orca, und Orca überschreibt ihn nicht; 3) brew install --cask stablyai/orca/orca und brew upgrade --cask orca; 4) Jedes veröffentlichte Release enthält drei Linux-Pakete – ein AppImage, ein .deb und ein .rpm; 5) Sie enthalten dieselbe App; 6) die Lösung für command not found lautet Register the CLI under Settings → General → Orca CLI, und unter macOS landet der Shim in ~/.local/bin; 7) das Angebot zur Handy-Kopplung: A pairing offer is a capability containing a device credential and E2EE material.
⚠️ Drei falsche Annahmen
Erstens: „orca eingeben bringt nichts, also ist es nicht installiert“. Unter Linux hieß der Befehl nie orca; die offizielle Seite sagt ausdrücklich, dass er den GNOME-Screenreader nicht überschattet – prüfen Sie daher zuerst orca-ide und PATH. Zweitens: „orca wurde aus brew entfernt, also kann Homebrew Orca nicht installieren“. Deaktiviert ist der gleichnamige Cask ohne Tap (fails_gatekeeper_check); das Tap-Paket stablyai/orca/orca ist dieser Weg, die erste Zeile der offiziellen Installationsseite. Drittens: „SSH verbindet, also funktioniert es“. Die offizielle Fehlerbehebungsseite trennt Dateien und Terminals in zwei Dinge und nennt: SSH funktioniert für Dateien, aber nicht „Download Folder“ allein – ein ganzer Ordner braucht rekursives SFTP, und über den systemeigenen sftp-Kanal funktioniert womöglich nur die Hälfte (alle drei am 2026-09-22 geprüft; Snapshots unter Quellen).
Falsche Installation oder fehlende
Prüfen Sie zuerst diese zwei Punkte
Erstens der Name: Liefert which orca-ide etwas zurück, und liegt ~/.local/bin in Ihrem PATH? Zweitens der Kanal: Haben Sie unter macOS den getappten Cask oder die .dmg von GitHub verwendet? Beide sind stabil, aber nur der Cask folgt brew upgrade. Wenn Sie diese beiden Punkte richtig setzen, erledigen sich die meisten Meldungen „command not found“ von selbst.
Drei weitere Prüfungen
Erstens Signierung und Freigabe: Der offizielle macOS-Abschnitt sagt Signed and notarized und ergänzt, dass der erste Start weiterhin eine Bestätigung verlangen kann – bei Electron-Apps normal. Zweitens der Remote-Rechner: Wenn SSH verbindet, aber kein Terminal startet, sollen Sie laut Doku prüfen, ob auf dem Remote-Rechner Node und Netzwerkzugriff für die erstmalige Relay-Installation vorhanden sind; unter Linux zusätzlich make, g++/clang++, python3, danach einmal neu verbinden. Drittens minimale Images: Die Headless-Seite sagt A minimal server or container image ships none of the Electron libraries – es fehlen also gemeinsame Bibliotheken, nicht Orca selbst.
Installationsweg wählen
macOS: Die offizielle Zeile ist die mit dem Tap, brew install --cask stablyai/orca/orca, und Upgrades laufen über brew upgrade --cask orca; laut Dokumentation folgt dieses Cask dem Stable-Kanal, RC-Builds erhalten Sie also über GitHub Releases oder „Nach Updates suchen“ in der App. Der schlichte Cask-Name orca gehört einem anderen Artefakt: Die öffentlichen Homebrew-Metadaten, abgerufen am 2026-09-23, lauten disabled: true, disable_date 2026-09-01, disable_reason fails_gatekeeper_check (nicht aus dem Verzeichnis entfernt, und deprecated ist weiterhin false). Linux: Offiziell liefert jedes Release drei Pakete, AppImage, .deb und .rpm, jeweils für x64 und arm64, und „They contain the same app. What differs is how updates reach you“ – Sie wählen also nur danach, „wie Updates zu Ihnen gelangen“. Die Arch-Zeile lautet yay -S stably-orca-bin (oder stably-orca-git, aus dem Quellcode gebaut). Headless-Server haben eine eigene offizielle Seite: Installieren Sie zuerst Xvfb sowie die gemeinsam genutzten Bibliotheken, gegen die Electron linkt; die Dokumentation warnt: „A minimal server or container image ships none of the Electron libraries“.
Wo QCode ins Spiel kommt
Auf der Installationsseite gibt es keine Verbindung: Orca liefert kein Modell mit und hält keine Zugangsdaten, und nach der Installation kommt der Modellzugriff weiterhin aus der eigenen Konfiguration der gestarteten Agent-CLI. Verbindend ist, worauf dieser Key zeigt: Bei einem eigenen Endpunkt ändern Sie base_url und Key dieser CLI. Diese Seite bringt zunächst nur Orca selbst zum Laufen, das Remote-Terminal zum Öffnen und das Handy zum Koppeln. Die Endpunkt-Konfiguration steht im Leitfaden für benutzerdefinierte Endpunkte dieser Website und wird hier nicht wiederholt.
FAQ
orca unter Linux eingegeben – keine Reaktion. Installation fehlgeschlagen?
In der Regel nicht. Die offizielle Installationsseite hat dafür einen eigenen Abschnitt, The CLI command is orca-ide: Unter Linux wird die Orca-CLI als orca-ide installiert, da der mitgelieferte GNOME-Desktop /usr/bin/orca bereits belegt und Orca ihn nicht überschreibt; bei den Namen von .deb und .rpm gilt derselbe Grund. Führen Sie daher zuerst which orca-ide aus und prüfen Sie dann, ob ~/.local/bin im PATH liegt – klären Sie diese beiden Punkte, bevor Sie über eine Neuinstallation sprechen.
Warum meldet brew install --cask orca, dass dieses Cask deaktiviert ist?
Weil der Cask orca ohne Tap nicht der Release-Kanal dieses Projekts ist. Die öffentlichen Metadaten von Homebrew zeigen am 2026-09-23 disabled: true, disable_date 2026-09-01 und disable_reason fails_gatekeeper_check, während deprecated weiterhin false ist. Die offizielle Installationsseite nennt den getappten Befehl brew install --cask stablyai/orca/orca, aktualisiert mit brew upgrade --cask orca, und sagt, dass dieser Cask dem stabilen Kanal folgt.
AppImage, deb oder rpm – welches wählen?
Offiziell liefert jedes Release diese drei Paketformate aus (sowohl x64 als auch arm64 sind vorhanden): They contain the same app. Unterschiedlich ist, wie Updates zu Ihnen gelangen, richten Sie Ihre Wahl also danach – das heißt, Grundlage der Entscheidung ist der Update-Weg, nicht Funktionsunterschiede. Für die Arch-Route nehmen Sie stably-orca-bin oder stably-orca-git, das aus dem Quellcode baut.
Das Terminal meldet „Orca CLI command not found“ – wo behebe ich das?
Die offizielle Troubleshooting-Seite nennt den Registrierungsschritt: Register the CLI under Settings → General → Orca CLI. Unter macOS legt sie einen Shim in ~/.local/bin ab; bestätigen Sie dann, dass dieses Verzeichnis im PATH Ihrer Shell liegt. Mit anderen Worten: Eine Neuinstallation ist nicht die Lösung – es fehlt dieser eine Eintrag im PATH.
SSH verbindet, aber das Remote-Terminal startet nicht – was prüfe ich zuerst?
Die offizielle Fehlerbehebungsseite nennt drei Punkte: Stellen Sie sicher, dass auf dem Remote-Rechner Node vorhanden ist und er bei der ersten Relay-Installation Netzwerkzugriff hat; fügen Sie auf einem Linux-Remote-Rechner diese C/C++-Toolchain hinzu – make, g++/clang++, python3; verbinden Sie sich nach der Installation einmal neu, damit Orca seine nativen Module neu installiert. Eine weitere Seite (Headless-Linux-Server) ergänzt die serverseitige Voraussetzung: Ein minimales Server- oder Container-Image bringt keine der Electron-Bibliotheken mit, daher werden Xvfb und die gemeinsam genutzten Electron-Bibliotheken zusammen installiert.
Das Angebot zur Handy-Kopplung sieht in Ordnung aus – warum verbindet es trotzdem nicht?
Die offizielle Headless-Seite teilt die Ursache in zwei Ebenen auf. Das Angebot selbst: „A pairing offer is a capability containing a device credential and E2EE material“ – es sollte also nur an den vorgesehenen Client gehen und nicht in Zugriffsprotokolle eines Proxys gelangen. Eine fehlgeschlagene Verbindung liegt meist auf der Netzwerkseite: boundEndpoint ist die Adresse, auf der der Prozess lauscht, advertisedEndpoint die, die der Client anwählt, wie die Dokumentation es ausführt – wenn DNS, Firewall, Docker-Port-Veröffentlichung, Tailscale-Richtlinie oder ein Reverse Proxy advertised nicht auf bound weiterleitet, kann sich auch ein gültig aussehendes Angebot nicht verbinden.
Quellen
Offizielle Dokumentation (am 2026-09-22 wortgetreu lokal archiviert): Die fünf Seiten install, troubleshooting, ssh, mobile und android-apk liegen unter https://raw.githubusercontent.com/stablyai/orca/HEAD/docs/site/content/docs/<page-name>.mdx; die beiden Seiten headless Linux server und linux glibc compatibility liegen unter docs/reference/; die README befindet sich im Repository-Stammverzeichnis. Die Homebrew-Seite nutzt die öffentlichen Metadaten unter https://formulae.brew.sh/api/cask/orca.json; die Release- und Asset-Namen stammen von https://api.github.com/repos/stablyai/orca/releases/latest. Alles wurde über das öffentliche Internet abgerufen, ohne angemeldeten Zustand.
Zuerst die CLI sichtbar machen
Empfohlene Debug-Reihenfolge: Ist orca-ide im PATH → CLI-Registrierung (Settings → General → Orca CLI) → Node und Toolchain auf dem Remote-Rechner → erst dann der Modell-Endpunkt. Offizieller Wortlaut geprüft am 2026-09-23.
Weiterführende Artikel
Orca-ADE-Installation und parallele Worktrees
Was es ist, was Parallelität spart, was Sie dafür aufgeben – die Mechanik steht dort. Hier: Installations- und Verbindungsfehler.
Orca: Drittanbieter-Endpunkte und Keys im Überblick
Nach der Installation verbinden Sie Ihren eigenen Endpunkt: Die Felder jedes Agents und die offiziellen Aussagen finden Sie dort.
Parallele Agents: Kontingent und Kosten
Die Rechnung, die Sie einmal aufstellen sollten, sobald es läuft: Bei N parallelen Agents gibt es einen gemeinsamen Kontingent-Pool, dazu den Preisunterschied bei Kontext und Caching.
Diese Seite gibt offene Orca-Doku und Repo-Inhalte von Stably wieder. Keine Verbindung zu Orca oder Stably, keine Empfehlung. Befehlsname, Cask-Status, Paketformate sowie SSH- und Handy-Verhalten richten sich nach den am 2026-09-23 erfassten offiziellen Seiten; ändert sich der offizielle Wortlaut, gilt dieser.