SOBAAgent Docs

Звуковые уведомления

Sound notifications SOBA: CLI-флаги, env-переменные, config.json и поведение на разных платформах.

SOBA может воспроизводить звуки при важных событиях: завершение задачи, ошибка, запрос dangerous-операции.


1. CLI-флаги

ФлагНазначение
--sound-enabledВключить звук на текущий запуск
--no-soundОтключить звук на текущий запуск
--sound-volume <0..1>Громкость
--sound-repeatПовторять звук до следующего события или смены состояния

Пример:

soba -i --sound-enabled --sound-volume 0.5

2. Config

Блок sound в ~/.soba/config.json:

{
  "sound": {
    "enabled": true,
    "volume": 0.7,
    "repeatMode": "once",
    "repeatIntervalMs": 3000
  }
}
КлючЗначения
enabledtrue или false
volumeчисло от 0.0 до 1.0
repeatMode"once" или "repeat"
repeatIntervalMsинтервал повтора в миллисекундах

3. Env

export SOBA_SOUND_ENABLED=true
export SOBA_SOUND_VOLUME=0.7
export SOBA_SOUND_REPEAT=once

Приоритет стандартный:

CLI flags > env > config.json > defaults

4. Практика

Для долгих задач:

soba -i --sound-enabled --sound-repeat

Для CI, записи экрана или тихого режима:

soba -i --no-sound

Если звук не воспроизводится, проверьте системный player и громкость ОС. SOBA не должен блокировать выполнение задачи из-за недоступного аудио.

Что дальше

On this page