Eggent для Mac

Eggent для Mac запускает того же агента, что и Eggent Cloud, на твоём компьютере. Проекты лежат обычными файлами в папке, которую видно в Finder, а агент работает с программами и файлами на твоём Mac. Подключи облачный воркспейс — и Mac с облаком станут одним агентом: те же файлы, чаты и память на обеих сторонах.

#Что это

Приложение с теми же экранами, что у облачной версии, и с сервером Eggent внутри, на твоём компьютере. Сервер слушает только локальный адрес, и говорить с ним может только окно приложения.

Работает двумя способами, переключаться между ними можно когда угодно:

• Само по себе. Всё остаётся на этом компьютере. Модель подключаешь ты: свой ключ провайдера или программу, которая у тебя уже есть (Работа на своей подписке).
• С облачным воркспейсом. Mac и воркспейс — один агент, а ИИ, включённый в воркспейс, работает и здесь: см. Приложение и облачный воркспейс.

#Скачать

Скачай актуальную сборку на странице Eggent для Mac. Там указан размер файла и его контрольная сумма SHA-256. После скачивания сверь её:

shasum -a 256 ~/Downloads/Eggent-<версия>-arm64.dmg

#Что нужно

• Mac с Apple silicon (M1 и новее) и macOS 13 (Ventura) или новее. Intel-Mac и Windows пока не поддерживаются.
• Около 1,2 ГБ места на диске под приложение (скачивается около 360 МБ) и место под твои проекты.
• Интернет для модели — и если она идёт из облачного воркспейса, и если от твоего провайдера.
• По желанию: Python 3 для панели терминала. Он идёт с инструментами командной строки Apple (xcode-select --install в Терминале).

#Открыть в первый раз

macOS открывает приложение без предупреждения, только если Apple его проверила, а для этого нужен платный сертификат разработчика, которого у Eggent пока нет. Поэтому при первом запуске macOS останавливает приложение. С файлом всё в порядке: разрешаешь один раз, и macOS запоминает.

1. Открой .dmg и перетащи Eggent в «Программы».
2. Открой Eggent из «Программ». macOS скажет, что не может проверить приложение на вредоносное ПО. Нажми «Готово» (в старых версиях macOS — «OK»).
3. Открой «Системные настройки» → «Конфиденциальность и безопасность», прокрути до раздела «Безопасность», нажми «Всё равно открыть» рядом с Eggent и введи пароль или приложи палец (Touch ID).
4. Открой Eggent ещё раз и нажми «Открыть».

Так Apple описывает открытие любого заблокированного приложения: Safely open apps on your Mac. Новая загрузка более новой сборки спросит снова.

В macOS 13 и 14 можно ещё нажать по Eggent с Control, выбрать «Открыть» и подтвердить.

Если удобнее Терминал, сними метку «скачано из интернета» и открывай приложение как обычно:

xattr -dr com.apple.quarantine /Applications/Eggent.app

#Первый запуск

1. «Где будет жить Eggent?» Выбери папку; по умолчанию ~/Eggent. Всё, что делает и хранит Eggent, будет внутри неё. Папку, где уже что-то лежит, Eggent не заполняет: он создаёт внутри подпапку и сначала говорит об этом. Если в выбранной папке уже есть Eggent, приложение подключится к нему и ничего не удалит.
2. «Подключить облачный Eggent?» Введи название воркспейса, логин и пароль, чтобы подключить облачный воркспейс (как это работает), или нажми «Пока без аккаунта» и подключи позже: меню Eggent → «Облако и синхронизация…». «У меня ещё нет аккаунта» открывает страницу регистрации в облаке в браузере; потом вернись и подключись.
3. Приложение готовит инструменты агента, запускает сервер и открывает окно. Первый запуск дольше следующих. Пароль на своём компьютере вводить не нужно: приложение само входит в своё окно.

Без облачного аккаунта приложению нужна модель. В Настройки → Модели добавь провайдера со своим API-ключом или используй программу, которая уже есть на компьютере.

#Где что лежит

~/Eggent/
  Projects/        ярлык на data/projects: твои проекты и файлы агента
  data/
    projects/      проекты и файлы агента
    chats/         то, что экран показывает по каждому чату
    pi-sessions/   то, что агент помнит о каждом чате
    chat-files/    вложения
    settings/ …    ключи и настройки этого компьютера
  README.txt

Файл → «Показать папку Eggent в Finder» и «Показать Projects в Finder» открывают их. Собственные настройки приложения лежат в ~/Library/Application Support/Eggent, а Файл → «Показать журнал» показывает, где его журнал.

Файл → «Сменить папку Eggent…» переносит её в другое место, двумя способами. «Перенести» перевозит всё: проекты, чаты, память агента, вход и связь с облаком. «Открыть другую» переключает Eggent на другую папку, а эту оставляет на диске как есть: пустая папка — начать с нуля, папка Eggent — открыть с тем, что в ней. Если облако подключено, другая папка синхронизируется с ним: то, что в ней есть, уйдёт в облако, а облачные проекты и чаты придут в неё. Сначала дождись, пока агент закончит работу: приложение на минуту остановится и запустится снова.

Ключи и настройки — только этого компьютера. В облако они не синхронизируются никогда.

#Модели

Чтобы отвечать, приложению нужна модель. Дать её можно тремя способами, их можно сочетать:

• ИИ твоего облачного воркспейса. Когда подключишь воркспейс, включённые модели появятся в Настройки → Модели и спишутся с того же баланса, что и в облаке. Они не заменяют провайдера, которого ты выбрал сам.
• Свой провайдер. В Настройки → Модели вставляется API-ключ — так же, как на сервере, который ты запускаешь сам: см. Модели.
• Программа, которая уже есть на компьютере. Проект может работать на Claude Code или Codex по твоей подписке: Работа на своей подписке.

#До чего достаёт агент

В облаке агент работает внутри компьютера, где есть только твой воркспейс. На твоём Mac такой коробки нет. У агента есть терминал, и команды он запускает от твоего пользователя, из папки Eggent, поэтому может читать и менять всё, что можешь ты, — как любая программа, которую ты запускаешь.

Что его сдерживает:

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

Относись к агенту как к толковому помощнику с терминалом на твоём ноутбуке: проси о том, что готов ему доверить, и держи важные данные в резервной копии.

#Обновления

Автообновлений пока нет. Чтобы обновиться, скачай новую сборку на странице Eggent для Mac, закрой Eggent, перетащи новый Eggent в «Программы» с заменой старого и открой его. macOS снова попросит разрешение, как в первый раз. Папка и настройки остаются как были.

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

#Удалить

Закрой Eggent и перетащи его из «Программ» в Корзину. Две вещи остаются намеренно: папка ~/Eggent с твоими файлами и историей чатов и собственные настройки приложения в ~/Library/Application Support/Eggent. Чтобы начать с нуля, удали и их.

Если пользовался облаком, сначала отключи его.

#Если что-то пошло не так

• macOS не открывает приложение или пишет, что оно повреждено. См. Открыть в первый раз.
• «Eggent не запустился». Экран предлагает «Попробовать снова» и «Показать журнал». В журнале видно, что случилось; если пишешь в поддержку, приложи его.
• Первый запуск долгий. Приложение один раз готовит инструменты агента — это около минуты. Дальше быстрее.
• Панель терминала пишет, что недоступна. Ей нужен Python 3: поставь инструменты командной строки Apple командой xcode-select --install. Команды из чата при этом продолжают работать.
• «Eggent ещё работает» при выходе. Приложение считает чаты, которые идут прямо сейчас. Если выйти, они остановятся; «Подождать» даст им закончить.
• Проблемы с синхронизацией. См. Приложение и облачный воркспейс.

#Чего здесь пока нет

• Windows и Intel-Mac.
• Подписи и нотаризации Apple: из-за этого при первом запуске macOS и предупреждает. Автообновлений тоже нет.
• Запуска при входе в систему и значка в строке меню.
• Распознавания речи и Python-инструментов для документов, которые есть на компьютере в облаке. Агент пользуется тем, что установлено у тебя.
• Расписаний, которые работают при выключенном Mac. Расписание, созданное в приложении, работает, только пока приложение открыто; задачу, которая должна идти строго по времени, создай в облаке. См. Что остаётся на каждой стороне.