# Eggent для Mac

> Приложение Eggent для Mac: что это, как скачать и открыть его в первый раз (подписи Apple пока нет), где лежат его файлы и как его обновить или удалить.

Source: https://eggent.ai/r/docs/desktop-app/

Eggent для Mac запускает того же агента, что и Eggent Cloud, на твоём компьютере. Проекты лежат обычными файлами в папке, которую видно в Finder, а агент работает с программами и файлами на твоём Mac. Подключи облачный воркспейс — и Mac с облаком станут одним агентом: [те же файлы, чаты и память на обеих сторонах](https://eggent.ai/r/docs/desktop-cloud.md).

> [!WARNING]
> Это **ранняя сборка** для Apple silicon, и она **пока не подписана и не заверена (нотаризация) Apple**. При первом запуске macOS не откроет её без твоего разрешения ([как это сделать](#first-launch)). Пользуйся на свой риск, держи копию всего, что нельзя потерять, и до начала прочитай, [до чего достаёт агент](#access).

## Что это {#what}

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

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

- **Само по себе.** Всё остаётся на этом компьютере. Модель подключаешь ты: свой ключ провайдера или программу, которая у тебя уже есть ([Работа на своей подписке](https://eggent.ai/r/docs/desktop-programs.md)).
- **С облачным воркспейсом.** Mac и воркспейс — один агент, а ИИ, включённый в воркспейс, работает и здесь: см. [Приложение и облачный воркспейс](https://eggent.ai/r/docs/desktop-cloud.md).

## Скачать {#download}

Скачай актуальную сборку на [странице Eggent для Mac](https://eggent.ai/r/mac/). Там указан размер файла и его контрольная сумма SHA-256. После скачивания сверь её:

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

### Что нужно {#requirements}

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

## Открыть в первый раз {#first-launch}

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](https://support.apple.com/en-us/102445). Новая загрузка более новой сборки спросит снова.

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

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

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

> [!NOTE]
> Если macOS пишет, что Eggent **повреждён**, и предлагает переместить его в Корзину, сверь контрольную сумму скачанного файла (см. [Скачать](#download)). Если она совпала, файл в порядке: выполни команду из Терминала выше и открой приложение снова. Если не совпала — скачай заново.

## Первый запуск {#first-run}

1. **«Где будет жить Eggent?»** Выбери папку; по умолчанию `~/Eggent`. Всё, что делает и хранит Eggent, будет внутри неё. Папку, где уже что-то лежит, Eggent не заполняет: он создаёт внутри подпапку и сначала говорит об этом. Если в выбранной папке уже есть Eggent, приложение подключится к нему и ничего не удалит.
2. **«Подключить облачный Eggent?»** Введи название воркспейса, логин и пароль, чтобы подключить облачный воркспейс ([как это работает](https://eggent.ai/r/docs/desktop-cloud.md#connect)), или нажми **«Пока без аккаунта»** и подключи позже: **меню Eggent → «Облако и синхронизация…»**. **«У меня ещё нет аккаунта»** открывает страницу регистрации в облаке в браузере; потом вернись и подключись.
3. Приложение готовит инструменты агента, запускает сервер и открывает окно. Первый запуск дольше следующих. Пароль на своём компьютере вводить не нужно: приложение само входит в своё окно.

Без облачного аккаунта приложению нужна модель. В **Настройки → Модели** добавь провайдера со своим API-ключом или используй [программу, которая уже есть на компьютере](https://eggent.ai/r/docs/desktop-programs.md).

## Где что лежит {#folder}

```text
~/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 — открыть с тем, что в ней. Если облако подключено, другая папка синхронизируется с ним: то, что в ней есть, уйдёт в облако, а облачные проекты и чаты придут в неё. Сначала дождись, пока агент закончит работу: приложение на минуту остановится и запустится снова.

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

## Модели {#models}

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

- **ИИ твоего облачного воркспейса.** Когда [подключишь воркспейс](https://eggent.ai/r/docs/desktop-cloud.md#connect), включённые модели появятся в **Настройки → Модели** и спишутся с того же баланса, что и в облаке. Они не заменяют провайдера, которого ты выбрал сам.
- **Свой провайдер.** В **Настройки → Модели** вставляется API-ключ — так же, как на сервере, который ты запускаешь сам: см. [Модели](https://eggent.ai/r/docs/models.md#own-provider).
- **Программа, которая уже есть на компьютере.** Проект может работать на Claude Code или Codex по твоей подписке: [Работа на своей подписке](https://eggent.ai/r/docs/desktop-programs.md).

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

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

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

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

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

## Обновления {#updates}

Автообновлений пока нет. Чтобы обновиться, скачай новую сборку на [странице Eggent для Mac](https://eggent.ai/r/mac/), закрой Eggent, перетащи новый Eggent в **«Программы»** с заменой старого и открой его. macOS снова попросит разрешение, как в первый раз. Папка и настройки остаются как были.

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

## Удалить {#remove}

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

Если пользовался облаком, сначала [отключи его](https://eggent.ai/r/docs/desktop-cloud.md#disconnect).

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

- **macOS не открывает приложение или пишет, что оно повреждено.** См. [Открыть в первый раз](#first-launch).
- **«Eggent не запустился».** Экран предлагает **«Попробовать снова»** и **«Показать журнал»**. В журнале видно, что случилось; если пишешь в поддержку, приложи его.
- **Первый запуск долгий.** Приложение один раз готовит инструменты агента — это около минуты. Дальше быстрее.
- **Панель терминала пишет, что недоступна.** Ей нужен Python 3: поставь инструменты командной строки Apple командой `xcode-select --install`. Команды из чата при этом продолжают работать.
- **«Eggent ещё работает» при выходе.** Приложение считает чаты, которые идут прямо сейчас. Если выйти, они остановятся; **«Подождать»** даст им закончить.
- **Проблемы с синхронизацией.** См. [Приложение и облачный воркспейс](https://eggent.ai/r/docs/desktop-cloud.md#troubleshooting).

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

- Windows и Intel-Mac.
- Подписи и нотаризации Apple: из-за этого при первом запуске macOS и предупреждает. Автообновлений тоже нет.
- Запуска при входе в систему и значка в строке меню.
- Распознавания речи и Python-инструментов для документов, которые есть на компьютере в облаке. Агент пользуется тем, что установлено у тебя.
- Расписаний, которые работают при выключенном Mac. Расписание, созданное в приложении, работает, только пока приложение открыто; задачу, которая должна идти строго по времени, создай в облаке. См. [Что остаётся на каждой стороне](https://eggent.ai/r/docs/desktop-cloud.md#separate).