# Початок роботи

cmux — легкий нативний термінал для macOS на основі Ghostty для керування кількома AI-агентами для програмування. Він має вертикальні вкладки, панель сповіщень і API керування через сокет.

## Установлення

### DMG (рекомендовано)

[Завантажити для Mac](https://cmux.com/uk/download/confirmation?dl=1)

Відкрийте .dmg і перетягніть cmux до папки «Програми». cmux оновлюється автоматично через Sparkle, тож завантажити його потрібно лише раз.

### Homebrew

```
brew tap manaflow-ai/cmux
brew install --cask cmux
```

Щоб оновити пізніше:

```
brew upgrade --cask cmux
```

Під час першого запуску macOS може попросити підтвердити відкриття застосунку від встановленого розробника. Натисніть **Відкрити**, щоб продовжити.

## Перевірка встановлення

Відкрийте cmux, і ви маєте побачити:

-   Вікно термінала з бічною панеллю вертикальних вкладок ліворуч
-   Один уже відкритий початковий робочий простір
-   Термінал на основі Ghostty, готовий до введення

## Налаштування CLI

cmux включає інструмент командного рядка для автоматизації. Усередині терміналів cmux він працює автоматично. Щоб використовувати його в інших терміналах, відкрийте палітру команд (⌘⇧P) і виконайте **Команда оболонки: встановити 'cmux' у PATH**. Вбудований CLI буде зв'язано з /usr/local/bin, а якщо ця папка потребує прав, буде запитано пароль адміністратора.

Або створіть символічне посилання самостійно:

```
sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux
```

Після цього можна виконувати команди на кшталт:

```
cmux list-workspaces
cmux notify --title "Build Complete" --body "Your build finished"
```

## Зробити cmux терміналом за замовчуванням

Щоб посилання ssh:// і скрипти оболонки з Finder відкривалися в cmux, а не в Терміналі, виберіть у рядку меню **cmux > Make cmux the Default Terminal** або виконайте **Make cmux the Default Terminal** з палітри команд.

## Автоматичні оновлення

cmux автоматично перевіряє наявність оновлень через Sparkle. Коли оновлення доступне, у рядку заголовка з'являється плашка оновлення. Також можна перевірити вручну через cmux > Check for Updates у рядку меню.

## Відновлення сесії (поточна поведінка)

Після перезапуску cmux відновлює розкладку та метадані. Підтримувані сесії агентів також можуть продовжитися, якщо хуки зберегли нативний токен відновлення.

cmux не зберігає довільний стан запущених процесів. Непідтримувані термінальні застосунки, як-от tmux, vim і звичайні оболонки, знову відкриваються як звичайні термінали.

See the [session restore guide](https://cmux.com/uk/docs/session-restore) for agent hook setup and the supported resume matrix.

## Вимоги

-   macOS 14.0 або новіша
-   Mac з Apple Silicon або Intel

Canonical: https://cmux.com/uk/docs/getting-started

Documentation index: https://cmux.com/llms.txt