Начало работы

Установка

Варианты установки — npx, глобально, нативное macOS-приложение или из исходников.

Если в Быстром старте вам хватило npx purplemux, читать дальше не нужно. Эта страница — для тех, кому нужна постоянная установка, десктопное приложение или запуск из исходников.

Требования

  • macOS 13+ или Linux — Windows не поддерживается. WSL2 обычно работает, но в нашу матрицу тестов не входит.
  • Node.js 20 или новее — проверьте через node -v.
  • tmux — любой релиз 3.0+.

Способы установки

npx (без установки)

npx purplemux

При первом запуске purplemux загружается и кешируется в ~/.npm/_npx/. Подходит, если хотите попробовать или запустить разово на удалённой машине. Каждый запуск использует последнюю опубликованную версию.

Глобальная установка

npm install -g purplemux
purplemux

pnpm и yarn работают так же (pnpm add -g purplemux / yarn global add purplemux). Последующие запуски быстрее, потому что не нужно ничего разрешать. Обновление — npm update -g purplemux.

Бинарник также доступен под коротким именем pmux.

Нативное macOS-приложение

Скачайте последний .dmg из Releases — есть сборки для Apple Silicon и Intel. Авто-обновление встроено.

Приложение содержит Node, tmux и сервер purplemux, плюс добавляет:

  • Иконку в меню-баре со статусом сервера
  • Нативные уведомления (отдельно от Web Push)
  • Автозапуск при входе в систему (переключатель в Настройки → Общие)

Запуск из исходников

git clone https://github.com/subicura/purplemux.git
cd purplemux
pnpm install
pnpm start

Для разработки (горячая перезагрузка):

pnpm dev

Порт и переменные окружения

purplemux слушает на 8022 (web + ssh, шутки ради). Перенастраивается через PORT:

PORT=9000 purplemux

Логирование управляется через LOG_LEVEL (по умолчанию info) и LOG_LEVELS для переопределений по модулям:

LOG_LEVEL=debug purplemux
# debug только для модуля Claude hook
LOG_LEVELS=hooks=debug purplemux
# несколько модулей сразу
LOG_LEVELS=hooks=debug,status=warn purplemux

Доступные уровни: trace · debug · info · warn · error · fatal. Модули, не указанные в LOG_LEVELS, наследуют LOG_LEVEL.

Полный список — в Порты и переменные окружения.

Автозапуск при загрузке

Самый простой вариант
Если вы используете macOS-приложение, включите **Настройки → Общие → Запускать при входе**. Никаких скриптов писать не нужно.

При CLI-установке оберните в launchd (macOS) или systemd (Linux). Минимальная systemd-юнит:

# ~/.config/systemd/user/purplemux.service
[Unit]
Description=purplemux

[Service]
ExecStart=/usr/local/bin/purplemux
Restart=on-failure

[Install]
WantedBy=default.target

systemctl --user enable --now purplemux

Обновление

Способ Команда
npx автоматически (свежая версия при каждом запуске)
Глобальный npm npm update -g purplemux
macOS-приложение автоматически (обновляется при запуске)
Из исходников git pull && pnpm install && pnpm start

Удаление

npm uninstall -g purplemux          # или pnpm remove -g / yarn global remove
rm -rf ~/.purplemux                 # удаляет настройки и данные сессий

Нативное приложение перетаскивается в Корзину обычным образом. Подробнее о том, что хранится в ~/.purplemux/, — в Каталоге данных.