cmuxcmux
/docs

#Уведомления

cmux поддерживает десктопные уведомления, позволяя AI-агентам и скриптам оповещать тебя когда им нужно внимание.

#Жизненный цикл

  1. Получено: уведомление появляется в панели, десктопный алерт срабатывает (если не подавлен)
  2. Непрочитанное: бейдж показан на вкладке рабочего пространства
  3. Прочитанное: убирается когда ты просматриваешь это рабочее пространство
  4. Очищено: удалено из панели

#Подавление

Десктопные алерты подавляются когда:

  • Окно cmux сфокусировано
  • Конкретное рабочее пространство, отправляющее уведомление, активно
  • Панель уведомлений открыта

#Панель уведомлений

Нажми ⌘⇧I чтобы открыть панель уведомлений. Кликни на уведомление чтобы перейти к этому рабочему пространству. Нажми ⌘⇧U чтобы перейти напрямую к рабочему пространству с самым свежим непрочитанным уведомлением.

#Пользовательская команда

Запускай shell-команду каждый раз когда уведомление запланировано. Задай её в Настройки > Приложение > Команда уведомления. Команда запускается через /bin/sh -c с этими переменными окружения:

ПеременнаяОписание
CMUX_NOTIFICATION_TITLEЗаголовок уведомления (имя рабочего пространства или приложения)
CMUX_NOTIFICATION_SUBTITLEПодзаголовок уведомления
CMUX_NOTIFICATION_BODYТекст уведомления
Examples
# Text-to-speech
say "$CMUX_NOTIFICATION_TITLE"

# Custom sound file
afplay /path/to/sound.aiff

# Log to file
echo "$CMUX_NOTIFICATION_TITLE: $CMUX_NOTIFICATION_BODY" >> ~/notifications.log

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

#Хуки уведомлений

cmux.json может задавать хуки уведомлений, которые получают каждую политику уведомления как JSON через stdin. Каждый хук возвращает JSON через stdout. По умолчанию хуки отключены; cmux запускает их только когда notifications.hooks содержит хотя бы один включённый хук. cmux применяет возвращённый текст и эффекты, поэтому хуки могут фильтровать баннеры, сохранять или пропускать историю боковой панели, запускать звуки или останавливать последующие хуки.

cmux.json
{
  "notifications": {
    "hooks": [
      {
        "id": "quiet-docs",
        "command": "sed 's/"desktop":true/"desktop":false/'",
        "timeoutSeconds": 20
      }
    ]
  }
}
Ввод и вывод хука
{
  "version": 1,
  "notification": {
    "workspaceId": "3B3F0D83-...",
    "surfaceId": "7E9C1A02-...",
    "title": "Codex",
    "subtitle": "Waiting",
    "body": "Agent needs input"
  },
  "context": {
    "cwd": "/path/to/project",
    "configPath": "/path/to/project/.cmux/cmux.json",
    "hookId": "quiet-docs",
    "appFocused": false,
    "focusedPanel": false
  },
  "effects": {
    "record": true,
    "markUnread": true,
    "reorderWorkspace": true,
    "desktop": true,
    "sound": true,
    "command": true,
    "paneFlash": true
  }
}

Хуки наследуются из глобального файла ~/.config/cmux/cmux.json и проектных файлов .cmux/cmux.json от родительских каталогов до текущего workspace. Проектные хуки перед запуском используют тот же запрос доверия, что и другие проектные команды cmux.json. Баннеры подтверждения Feed тоже проходят через эти хуки; отключение desktop скрывает нативный баннер, но оставляет элемент Feed доступным в cmux. Установите notifications.hooksMode в replace в конфигурации проекта, чтобы игнорировать унаследованные хуки. Если хук завершается с ошибкой, истекает по тайм-ауту или возвращает неверный JSON, cmux использует поведение уведомлений по умолчанию и показывает предупреждение об ошибке хука.

#Отправка уведомлений

#CLI

cmux notify --title "Task Complete" --body "Your build finished"
cmux notify --title "Claude Code" --subtitle "Waiting" --body "Agent needs input"

#OSC 777 (простой)

Протокол RXVT использует фиксированный формат с заголовком и телом:

printf '\e]777;notify;My Title;Message body here\a'
Shell function
notify_osc777() {
    local title="$1"
    local body="$2"
    printf '\e]777;notify;%s;%s\a' "$title" "$body"
}

notify_osc777 "Build Complete" "All tests passed"

#OSC 99 (расширенный)

Протокол Kitty поддерживает подзаголовки и ID уведомлений:

# Format: ESC ] 99 ; <params> ; <payload> ESC \

# Simple notification
printf '\e]99;i=1;e=1;d=0:Hello World\e\\'

# With title, subtitle, and body
printf '\e]99;i=1;e=1;d=0;p=title:Build Complete\e\\'
printf '\e]99;i=1;e=1;d=0;p=subtitle:Project X\e\\'
printf '\e]99;i=1;e=1;d=1;p=body:All tests passed\e\\'
ФункцияOSC 99OSC 777
Заголовок + текстДаДа
ПодзаголовокДаНет
ID уведомленияДаНет
СложностьВышеНиже
Используй OSC 777 для простых уведомлений. Используй OSC 99 когда нужны подзаголовки или ID уведомлений. Используй CLI (cmux notify) для самой простой интеграции.

#Claude Code hooks

cmux интегрируется с Claude Code через hooks чтобы уведомлять тебя когда задачи завершаются.

#1. Создай скрипт хука

~/.claude/hooks/cmux-notify.sh
#!/bin/bash
# Skip if not in cmux
[ -S /tmp/cmux.sock ] || exit 0

EVENT=$(cat)
EVENT_TYPE=$(echo "$EVENT" | jq -r '.hook_event_name // "unknown"')
TOOL=$(echo "$EVENT" | jq -r '.tool_name // ""')

case "$EVENT_TYPE" in
    "Stop")
        cmux notify --title "Claude Code" --body "Session complete"
        ;;
    "PostToolUse")
        [ "$TOOL" = "Task" ] && cmux notify --title "Claude Code" --body "Agent finished"
        ;;
esac
chmod +x ~/.claude/hooks/cmux-notify.sh

#2. Настрой Claude Code

~/.claude/settings.json
{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/cmux-notify.sh"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Task",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/cmux-notify.sh"
          }
        ]
      }
    ]
  }
}

Перезапусти Claude Code чтобы применить хуки.

#GitHub Copilot CLI

Copilot CLI поддерживает хуки, которые выполняют shell-команды при событиях жизненного цикла, таких как отправка промпта, остановка агента и ошибки.

~/.copilot/config.json
{
  "hooks": {
    "userPromptSubmitted": [
      {
        "type": "command",
        "bash": "if command -v cmux &>/dev/null; then cmux set-status copilot_cli Running; fi",
        "timeoutSec": 3
      }
    ],
    "agentStop": [
      {
        "type": "command",
        "bash": "if command -v cmux &>/dev/null; then cmux notify --title 'Copilot CLI' --body 'Done'; cmux set-status copilot_cli Idle; fi",
        "timeoutSec": 5
      }
    ],
    "errorOccurred": [
      {
        "type": "command",
        "bash": "if command -v cmux &>/dev/null; then cmux notify --title 'Copilot CLI' --subtitle 'Error' --body 'An error occurred'; cmux set-status copilot_cli Error; fi",
        "timeoutSec": 5
      }
    ],
    "sessionEnd": [
      {
        "type": "command",
        "bash": "if command -v cmux &>/dev/null; then cmux clear-status copilot_cli; fi",
        "timeoutSec": 3
      }
    ]
  }
}

Для хуков на уровне репозитория создайте файл .github/hooks/notify.json с аналогичной структурой:

.github/hooks/notify.json
{
  "version": 1,
  "hooks": {
    "userPromptSubmitted": [ ... ],
    "agentStop": [ ... ]
  }
}

#Примеры интеграций

#Уведомление после долгой команды

~/.zshrc
# Add to your shell config
notify-after() {
  "$@"
  local exit_code=$?
  if [ $exit_code -eq 0 ]; then
    cmux notify --title "✓ Command Complete" --body "$1"
  else
    cmux notify --title "✗ Command Failed" --body "$1 (exit $exit_code)"
  fi
  return $exit_code
}

# Usage: notify-after npm run build

#Python

python
import sys

def notify(title: str, body: str):
    """Send OSC 777 notification."""
    sys.stdout.write(f'\x1b]777;notify;{title};{body}\x07')
    sys.stdout.flush()

notify("Script Complete", "Processing finished")

#Node.js

node
function notify(title, body) {
  process.stdout.write(`\x1b]777;notify;${title};${body}\x07`);
}

notify('Build Done', 'webpack finished');

#tmux passthrough

Если используешь tmux внутри cmux, включи passthrough:

.tmux.conf
set -g allow-passthrough on
printf '\ePtmux;\e\e]777;notify;Title;Body\a\e\\'