Установка

Требования

macOS 27 на Apple Silicon.
Xcode 27 — чтобы собрать приложение из исходников.
Ключ OpenAI API — им пользуются разбор команд и голос (GPT-Live).
Для настоящей работы: Claude Code и/или Codex с их ACP-адаптерами (Node.js и npm).

Без агентов всё можно попробовать на встроенном тестовом агенте.

Сборка приложения

git clone https://github.com/artipop/blu.git && cd blu
open blu.xcodeproj    # в первый раз: ⌘B, затем «Trust & Enable» для макросов пакетов
scripts/install.sh    # собирает Release-версию в /Applications

scripts/install.sh кладёт blu в /Applications. Debug-сборка из Xcode — отдельное приложение blu dev со своими данными: удобно пробовать новое, не трогая повседневные проекты.

Ключ OpenAI

Откройте настройки: ⌘, → Голос.
Вставьте ключ. Он хранится в Связке ключей macOS — не в файле и не в iCloud.

Один ключ служит и голосу, и разбору команд. Без ключа или сети команды не выполняются, и blu говорит почему.

Установка агентов

npm i -g @agentclientprotocol/claude-agent-acp @agentclientprotocol/codex-acp

Нужны и сами CLI — claude и/или codex. blu ищет их в PATH интерактивной login-оболочки, так что установки через nvm и Homebrew находятся.

Войдите один раз в Терминале:

claude      # затем /login
codex login

Редактор проекта показывает, найден ли адаптер, и даёт кнопку Войти в Терминале. blu никогда не читает ваши токены — они остаются у агентов.

Дальше: первые шаги.