Локальный агент для macOS

aictrlx — агент, который работает на вашем Mac

Один агент для кода и остальной работы — тестов, почты, календаря, Drive, браузера и приложений macOS, — который спрашивает вас, прежде чем отправить письмо, изменить календарь или нажать на сайте кнопку, которая что-то отправляет, удаляет или покупает.

Сейчас — macOS, другие операционные системы — позже.

Что умеет агент

Код от начала до конца

Изучает репозиторий, ищет, читает, вносит правки, запускает тесты, разбирает ошибки и исправляет их — с контрольными точками, возобновляемыми сессиями и командами /diff и /undo для изменений задачи.

Gmail

Ищет письма синтаксисом запросов Gmail, читает письма и цепочки, готовит черновики и ответы, ставит метки и архивирует. Массовый разбор по запросу заранее показывает, сколько писем, от кого и за какие даты.

Google Календарь

Находит действительно свободное время по данным free/busy — его считает код, а не модель, — и создаёт, изменяет и отменяет события в правильном часовом поясе.

Google Drive — только чтение

Ищет, показывает папки, открывает документы, таблицы и презентации как текст и сохраняет файл в рабочую папку. Ничего в Drive не меняет.

Настоящий браузер

Chromium для сайтов, у которых нет API или MCP-сервера: снимки страницы, клики, формы, скачивание и загрузка файлов. Входы на сайты хранятся в профилях, а пароли вводятся по ссылке — модель их не видит.

Приложения macOS

Программы на рабочем столе через Accessibility: дерево интерфейса, клики, ввод текста и сочетания клавиш. Каждое действие оценивается по тому, на что оно направлено, а рабочим столом управляет только один запуск за раз.

MCP-серверы

Подключите любой MCP-сервер — его инструменты станут возможностью агента, а насколько они рискованны, решает ваша настройка, а не сервер. Серверы, настроенные в Claude Desktop, Cursor, VS Code и других программах, можно импортировать.

Субагенты

Делит задачу на части, независимые выполняет параллельно и сверяет результаты с доказательствами. Код, написанный параллельно, возвращается наборами изменений, которые применяются все вместе или не применяются вовсе.

Очередь и расписания

Поставьте задачу в очередь или настройте повторяющуюся по расписанию в нужном часовом поясе — её выполнит фоновый процесс. Если нужен человек, задача останавливается и ждёт, а не действует сама и не бросает работу.

Память и планы

То, что вы попросили запомнить, само доходит до следующих запусков, а у долгой задачи есть план, который не теряется ни при повторе, ни при сжатии разговора.

Как агент работает с aictrlx.ru

Аккаунт на aictrlx.ru даёт Mac две вещи: модели и ретранслятор для телефона. Обе работают с одним API-ключом проекта, и получить его можно одной командой.

  1. Вход одной командой

    aictrlx login показывает код и открывает страницу aictrlx.ru/device. Вы сверяете код, выбираете проект и что разрешить этому Mac — «Модели» и, если тариф это включает, «Ретранслятор для телефона», — и подтверждаете. Ключ хранится только в связке ключей macOS (Keychain).

  2. Модели через сервис

    С разрешением «Модели» команда регистрирует модель aictrlx, если для сервиса на Mac ещё нет ни одной: режим маршрутизации coding по адресу https://aictrlx.ru/v1 — OpenAI-совместимый API, который сам выбирает модель для каждого запроса. Работу она получит, когда вы разрешите удалённые модели.

  3. Ретранслятор для телефона

    Вне дома и Mac, и телефон сами подключаются к relay.aictrlx.ru, а он соединяет их друг с другом. TLS между телефоном и Mac идёт насквозь, поэтому ретранслятор видит только шифротекст и метаданные, но не содержимое. Он выключен, пока вы не выполните aictrlx phone relay on.

Что печатает aictrlx login (пример)
$ aictrlx login
To sign this Mac in to aictrlx, open https://aictrlx.ru/device
and check that it shows the code   WDJB-MJHT
(opened in your browser). Waiting for you to approve it… Ctrl+C stops.
Signed in to aictrlx as anna@example.com — project "Default Project".
  key      "aictrlx — Anna's MacBook Pro", kept in the macOS Keychain only
  models   the model "aictrlx" (coding) at https://aictrlx.ru/v1 has this key — registered now
  relay    the phone relay key for relay.aictrlx.ru is set
Next (nothing else was changed):
  aictrlx config set model_privacy allow_remote   remote models get no work until you allow them
  aictrlx model policy --default aictrlx          send work to it
  aictrlx phone relay on                          reach this Mac from the phone away from home

Телефон как пульт

Приложение aictrlx для Android — ещё один интерфейс агента, как терминал: сам агент и его модели остаются на Mac.

Подтверждения по отпечатку

Отвечайте на ожидающие подтверждения по одному: каждое решение подписывается после отпечатка пальца (или PIN-кода телефона, если вы разрешили его при привязке). Кнопки «одобрить всё» нет.

Задачи в реальном времени

Ставьте задачи в очередь, останавливайте, приостанавливайте и продолжайте; следите за фоновой задачей вживую и отправляйте ей уточнения — она прочитает их на следующем шаге.

Результаты, уведомления, расписания

Читайте результаты и уведомления, смотрите субагентов задачи и изменённые ею файлы, управляйте расписаниями.

Окна терминала и «Поделиться»

Смотрите, какие окна aictrlx открыты на Mac, и пишите в них; отправляйте в новую задачу текст, ссылку или файл из любого приложения.

Привязка — только у Mac: aictrlx phone pair показывает QR-код, приложение его сканирует, и вы сверяете шесть цифр на обоих экранах. Дома телефон подключается к Mac напрямую, вне дома — через ретранслятор.

Телефон ничего не решает сам: он не меняет настройки, режим задачи и маршруты телефонов и не проходит входы на сайты, CAPTCHA и одноразовые коды — для этого нужен человек у Mac.

Безопасность и приватность

Прежде всего локально

Агент, его инструменты, память и история работы с каждой папкой хранятся на вашем Mac. API-ключи и OAuth-токены — только в связке ключей macOS: не в файлах, не в журналах и не там, где их может увидеть модель.

Подтверждения решает код

Каждый вызов оценивается детерминированными правилами, а не моделью. Отправка писем и изменения в календаре всегда требуют подтверждения — с превью из настоящих аргументов; отправка, удаление или покупка подтверждаются по отдельности, никогда пачкой.

Удалённые модели — только с вашего разрешения

По умолчанию (model_privacy local_only) ни одна модель на чужом сервере не видит работу агента. Почта, календарь, Drive, память и управление компьютером по умолчанию в списке local_only_capabilities: их данные не уходят на удалённые модели, даже когда те разрешены.

Ретранслятор не читает содержимое

TLS между телефоном и Mac сквозной: ретранслятор пересылает шифротекст, который не может расшифровать, и узнаёт только метаданные — аккаунт, идентификаторы и ключи телефонов, адреса, время и объём.

Страницы и письма — это данные

То, что написали другие, — письма, события, файлы Drive, веб-страницы, ответы MCP — попадает к модели как данные в отдельной рамке. Страница может лишь заставить модель предложить действие, а оно проходит те же подтверждения.

Песочница и честная проверка

На macOS каждая команда оболочки по умолчанию выполняется в песочнице Seatbelt: запись — только в рабочей и временных папках, сеть — только localhost. Прежде чем задача будет считаться выполненной, независимый проверяющий смотрит diff и изменённые файлы — и может честно ответить, что судить не может.

Платформы

macOS

Уже сейчас. Управление приложениями и песочница для команд — возможности macOS.

Другие операционные системы

Позже: aictrlx появится и на других операционных системах.

Android

Приложение для телефона: подтверждения, задачи и результаты — дома и вне дома.

Установка

aictrlx для macOS

Установка одной командой

Терминал на Mac
git clone https://github.com/aictrlx/aictrlx_agent.git aictrlx && cd aictrlx && ./install.sh

Установщик поставит aictrlx в ~/.local/share/aictrlx, скачает Chromium для браузера агента и добавит команду aictrlx в PATH. Нужны git и Python 3.12 или новее: если такого Python нет, установщик подскажет, как его поставить (brew install python@3.12). Когда он закончит, откройте новое окно терминала. Обновление — в папке aictrlx: git pull && ./install.sh.

Затем в терминале

  1. aictrlx login войдите: подтвердите код на aictrlx.ru/device
  2. aictrlx config set model_privacy allow_remote пока вы не разрешите удалённые модели, они не получают работу
  3. aictrlx model policy --default aictrlx отправлять работу модели сервиса
  4. aictrlx phone relay on открывать этот Mac с телефона вне дома
  5. aictrlx интерактивный режим в папке проекта: опишите задачу обычными словами

Три шага после aictrlx login команда напечатает сама — только те, что ещё не сделаны. aictrlx doctor проверит окружение.

Приложение для Android

Подтверждения, задачи и результаты на телефоне; привязка — у Mac командой aictrlx phone pair.

Бета

Бета-версия: приложение ещё будет меняться, возможны ошибки. Для Android 10 и новее. В первый раз Android попросит разрешить установку приложений из браузера; следующие версии ставятся поверх.

Документация и сценарии

Первые шаги, телефон, основные команды, сценарии и ответы на частые вопросы.

Открыть документацию