Официальные доки · сверено 2026-09-23

Orca установлен, а команды orca нет: сначала проверьте, что это orca-ide

Orca — только про установку и подключение: в Linux имя команды orca-ide, а не orca; в Homebrew нужна команда с tap; CLI отвечает command not found; SSH проходит, но удалённый терминал не стартует; сопряжение с телефоном не выходит. В официальных docs по каждому случаю есть по предложению (сверено 2026-09-23).

Обновлено 2026-09-23

#Имя команды orca-ide#brew с tap#AppImage / deb / rpm#SSH и привязка телефона

Четыре правила до отладки

orca-ide

Имя команды и пакета

Официально: в Linux ставится как orca-ide и не перекрывает экранную читалку GNOME; у .deb/.rpm то же имя и та же причина. Сначала which orca-ide, потом подозрения, что установка не удалась.

с tap

Полная команда brew

Нужный cask — это stablyai/orca/orca; cask «просто orca» с 2026-09-01 в статусе disabled, причина — fails_gatekeeper_check.

~/.local/bin

Место регистрации CLI

Официальное решение для command not found — зарегистрировать CLI в Settings → General → Orca CLI; на macOS shim устанавливается в ~/.local/bin, затем проверьте, что он в PATH.

То же приложение

Формат ≠ другая версия

AppImage/.deb/.rpm ставят одно и то же приложение; официально различается лишь доставка обновлений — не судите о разнице функций по формату пакета.

Уточнение: приложение то же, команда не всегда orca

На официальной странице install это вынесено в отдельный раздел с заголовком “The CLI command is orca-ide”, а в тексте буквально: “On Linux the Orca CLI installs as orca-ide, not orca”. Причина там же приведена дословно: “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”. И там же добавлено: “The .deb and .rpm packages are named orca-ide for the same reason”. Поэтому «поставил, а orca ничего не делает» на Linux чаще всего значит не провал установки, а то, что этот путь изначально не принадлежал Orca.

Что насчитали в тот день

Страница latest в GitHub Releases на 2026-09-23 отдаёт v1.4.207, published 2026-09-22T09:44:40Z; в ассетах лежат orca-macos-x64.dmg, orca-windows-setup.exe и orca-linux.AppImage. Лицензия — MIT по самому файлу LICENSE в репозитории (поле license в API совпадает). Счётчики, которые меняются по минутам — звёзды и форки — на эту страницу не выносим: для них есть сравнительная таблица на странице P4, где у каждого числа стоит дата выгрузки. На телефонах iOS идёт через App Store (внутреннее имя в листинге — orca-ide), для Android официально выложены app-release.apk на странице релизов и короткая инструкция по установке.

Хронология

2026-09-01

2026-09-01: в публичных метаданных Homebrew у cask с именем orca disable_date именно этот, а disable_reason — fails_gatekeeper_check. На дату сверки этой страницы 2026-09-23 disabled у него по-прежнему true, deprecated — по-прежнему false. То есть его не «заменил Orca», его отключил Homebrew.

2026-09-22

2026-09-22: шесть страниц официальной документации, нужные этой странице (install, troubleshooting, ssh, mobile, android-apk, headless Linux server), и README скачаны дословно и лежат в архиве; любую английскую цитату отсюда можно найти в нём слово в слово.

2026-09-23

2026-09-23: четыре версии страницы готовы, сверены с официальным текстом. Имена команд, пакетов, статус cask меняются с версией, поэтому в каждом разделе — дата сверки; правки берут по дате заново, не подменяя молча.

Что сам, что по докам

Подтверждено документацией

Сверено 2026-09-23; с официальными страницами дословно сходятся шесть пунктов: 1) On Linux the Orca CLI installs as orca-ide, not orca; 2) 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; 3) brew install --cask stablyai/orca/orca и brew upgrade --cask orca; 4) Each published release ships three Linux packages — an AppImage, a .deb, and an .rpm ... They contain the same app; 5) при command not found помогает Register the CLI under Settings → General → Orca CLI, на macOS shim попадает в ~/.local/bin; 6) предложение сопряжения с телефоном: A pairing offer is a capability containing a device credential and E2EE material.

⚠️ Три ложных допущения

Первое: «набрал orca — молчит, значит, не установлен». В Linux она изначально зовётся не orca, и официально сказано: экранный диктор GNOME не перекрывается; сначала смотрят на orca-ide и PATH. Второе: «orca сняли с brew, значит, через Homebrew не поставить». Отключён одноимённый cask без tap (fails_gatekeeper_check); дорога — за версией с tap, stablyai/orca/orca — первой строкой официальной install-страницы. Третье: «раз SSH подключается, всё работает». В официальной troubleshooting-странице files и terminals — две разные вещи, отдельный пункт — SSH works for files but not “Download Folder”: целая папка требует рекурсивного SFTP, а на встроенном в систему канале sftp может сработать лишь наполовину.

Не то или не установлено

Сначала эти два пункта

Первое — имя: возвращает ли which orca-ide хоть что-то и виден ли ~/.local/bin в PATH. Второе — канал: что ты поставил на macOS, cask с tap или тот .dmg с GitHub; оба из stable, но за brew upgrade идёт только первый. Если обе проверки сходятся, большинство «command not found» исчезает само.

Ещё три проверки

Первое — подпись и разрешение: официальный раздел macOS пишет Signed and notarized, но при первом запуске подтверждение всё равно вероятно — норма для Electron-приложений. Второе — удалённая машина: SSH подключился, терминал не поднимается — по документации сверяют Node на ней и выход в сеть при первой установке relay; на Linux ещё make, g++/clang++, python3, затем переподключение. Третье — минимальный образ: страница headless пишет A minimal server or container image ships none of the Electron libraries — не хватает общих библиотек, не самого Orca.

Выбор способа установки

macOS: официальный вариант — команда с tap, brew install --cask stablyai/orca/orca; обновление — brew upgrade --cask orca. В документации сказано, что этот cask следует каналу stable, а за сборками RC надо идти в GitHub Releases или в пункт «Check for Updates» в самом приложении. Имя cask без tap, просто orca, занято другим продуктом: в публичных метаданных Homebrew, полученных 2026-09-23, стоит disabled: true, disable_date 2026-09-01, disable_reason — fails_gatekeeper_check (это не снятие с публикации, deprecated по-прежнему false). Linux: по официальным данным каждый релиз выходит в трёх пакетах — AppImage, .deb и .rpm — и для x64, и для arm64; «They contain the same app. What differs is how updates reach you», так что выбор только по тому, как обновление до вас доходит. Для Arch — yay -S stably-orca-bin (или stably-orca-git, сборка из исходников). Для сервера без графического интерфейса есть отдельная официальная страница: сперва ставят Xvfb и общие библиотеки, которые линкует Electron; в документации предупреждение: «A minimal server or container image ships none of the Electron libraries».

Причём тут QCode

У установки тут связи нет: Orca не поставляет моделей, не хранит ваши учётные данные, и после установки доступ к моделям — как прежде, из конфига запускаемого CLI агента. Связь — в том, куда ключ смотрит: на своём эндпоинте меняете base_url и ключ того CLI. Страница отвечает лишь за подъём Orca, работу удалённого терминала и сопряжение телефона. Как писать его — в нашем руководстве по своему эндпоинту; не повторяем.

Частые вопросы

Набрал orca на Linux — тишина: установка не удалась?

Обычно нет. На официальной странице install есть отдельный раздел «The CLI command is orca-ide»: в Linux Orca CLI ставится как orca-ide, ведь /usr/bin/orca уже занят штатной настольной средой GNOME, и Orca её не перекрывает; пакеты .deb и .rpm — та же причина. Так что сначала which orca-ide, потом ~/.local/bin в PATH — и лишь после этих двух шагов речь о переустановке.

Почему brew install --cask orca сообщает, что этот cask отключён?

Потому что cask orca без тапа — не канал релизов этого проекта. Открытые метаданные Homebrew на 2026-09-23 показывают disabled: true, disable_date 2026-09-01 и disable_reason fails_gatekeeper_check, при этом deprecated всё ещё false. Официальная страница install даёт команду с тапом — brew install --cask stablyai/orca/orca, обновление через brew upgrade --cask orca, и там же сказано, что этот cask следует каналу stable.

AppImage, deb или rpm — что выбрать?

В оригинале каждый релиз выходит в этих трёх форматах пакетов (есть и x64, и arm64). Дословно — They contain the same app. What differs is how updates reach you, so pick on that. То есть выбирать стоит по тому, как до тебя доходят обновления, а не по различиям функций. Для Arch бери stably-orca-bin или stably-orca-git, собранный из исходников.

В терминале: Orca CLI command not found — где исправлять?

Официальная страница troubleshooting даёт шаг регистрации: «Register the CLI under Settings → General → Orca CLI». На macOS там появляется shim в ~/.local/bin, а дальше проверьте, что этот каталог стоит в PATH вашей оболочки. Иными словами, переустановка тут не поможет: не хватает одной записи в PATH.

SSH подключается, а удалённый терминал не запускается — что проверять первым?

Официальная troubleshooting-страница — три условия: на удалённом хосте есть Node и выход в сеть при первой установке relay; для удалённого Linux добавьте связку C/C++-инструментов: make, g++/clang++, python3; установив, переподключитесь один раз — Orca переустановит нативные модули. Другая страница (headless Linux server) — о серверной предпосылке: A minimal server or container image ships none of the Electron libraries — поэтому Xvfb и общие библиотеки Electron ставят вместе.

Offer для сопряжения с телефоном на вид без проблем — почему он не подключается?

Официальная headless-страница разбирает причину в два слоя. Сам offer — это «A pairing offer is a capability containing a device credential and E2EE material», его отправляют только целевому клиенту и не оставляют в логах доступа прокси. Если соединения нет, чаще виновата сеть: boundEndpoint — адрес, который процесс слушает, advertisedEndpoint — адрес, к которому обращается клиент. Официально сказано: если DNS, файрвол, публикация портов Docker, политика Tailscale или обратный прокси не выводят advertised на bound, то даже на вид корректный offer не подключится.

Источники информации

Официальная документация (2026-09-22 снята один в один в локальный архив): пять страниц — install, troubleshooting, ssh, mobile, android-apk — лежат по адресам https://raw.githubusercontent.com/stablyai/orca/HEAD/docs/site/content/docs/<имя-страницы>.mdx; две страницы, headless Linux server и linux glibc compatibility, — в каталоге docs/reference/; README — в корне репозитория. Для Homebrew взяты публичные метаданные https://formulae.brew.sh/api/cask/orca.json, а сведения о релизе и имена ассетов — из https://api.github.com/repos/stablyai/orca/releases/latest. Всё получено из открытой сети, без какого-либо входа в аккаунт.

Найти CLI первым делом

Примерный порядок разбора: есть ли orca-ide в PATH → регистрация CLI (Settings → General → Orca CLI) → удалённые Node и тулчейн → лишь потом эндпоинт модели. Формулировки сверены 2026-09-23.

Создать аккаунт Модели Тарифы