# Настройка

> Файл настроек nsq, переменные окружения и где nsq хранит свои данные.

Source: https://docs.neurosquad.ai/ru/cli/configuration

nsq работает без всякой настройки. Чтобы что-то поменять, отредактируйте
`~/.neurosquad-cli/config.json` (создайте, если его нет). Все поля необязательные; если файла нет
или он сломан, действуют значения по умолчанию.

```json
{
  "logos": "auto",
  "notifications": true,
  "sound": true,
  "detachKey": "Ctrl+]",
  "dictation": {
    "enabled": true,
    "hotkey": "CommandOrControl+Shift+Space",
    "mode": "toggle",
    "model": "parakeet-tdt-0.6b-v3"
  }
}
```

| Настройка | Значения | По умолчанию |
| --- | --- | --- |
| `logos` | `auto`, `images` (настоящие логотипы, где терминал умеет рисовать картинки), `glyphs` (маленькие цветные значки), `neutral` (без фирменных цветов) | `auto` |
| `notifications` | уведомления на рабочем столе — [Уведомления](https://docs.neurosquad.ai/ru/cli/notifications) | `true` |
| `sound` | звук с каждым уведомлением | `true` |
| `detachKey` | клавиша выхода из агента на весь экран, `Ctrl+<клавиша>` | `Ctrl+]` |
| `dictation.enabled` | диктовка включена или выключена — [Диктовка](https://docs.neurosquad.ai/ru/cli/dictation) | включена |
| `dictation.hotkey` | глобальная клавиша, например `F9`, `Ctrl+Alt+Space`; `""` — без неё | `CommandOrControl+Shift+Space` |
| `dictation.mode` | `hold` (пока нажата) или `toggle`; не задано — короткое нажатие переключает, удержание пишет | не задано |
| `dictation.model` | `parakeet-tdt-0.6b-v3` или `whisper-large-v3-turbo` | `parakeet-tdt-0.6b-v3` |

Доступ с телефона включается командами `nsq phone on|off` и запоминается в этом же файле.

Настройки читаются при запуске дашборда и демона: после изменения откройте дашборд заново, а для
настроек самого демона (уведомления, звук) выполните `nsq down`, затем `nsq up`.

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

| Переменная | Что делает |
| --- | --- |
| `NSQ_HOME` | Хранить данные nsq не в `~/.neurosquad-cli` (у отдельной папки — свой демон) |
| `OPENROUTER_API_KEY` | Ключ OpenRouter, если в ОС нет хранилища секретов |
| `NSQ_LOGOS` | `images`, `glyphs` или `none` — как `logos` выше |
| `NSQ_IMAGES=0` | Никогда не рисовать картинки в терминале |
| `NSQ_COLOR` | `truecolor`, `256`, `16` или `none` — вместо определённых автоматически цветов |
| `NO_COLOR` | [Стандартный](https://no-color.org) выключатель цвета, учитывается |
| `NSQ_GLYPHS` | `ascii` или `unicode` — вместо определённого автоматически набора символов |
| `NSQ_AMBIGUOUS_WIDE=1` | Для терминалов, которые рисуют символы неоднозначной ширины двойными (некоторые CJK-настройки) |
| `NSQ_NO_ANIMATION=1` | Без анимаций |
| `NSQ_ANIMATION=1` | Анимации и по SSH (там они по умолчанию выключены) |
| `NSQ_NO_NOTIFY=1` | Без уведомлений на рабочем столе (задайте там, откуда запускается демон) |
| `NSQ_NO_BROWSER=1` | `nsq login` печатает ссылку, а не открывает браузер |

## Где nsq всё хранит

Всё лежит в `~/.neurosquad-cli` (или в `NSQ_HOME`):

| | |
| --- | --- |
| `agents.json` | ваши агенты |
| `config.json` | настройки выше |
| `daemon.log` | журнал демона — первое, куда смотреть, если что-то не так |
| `layers/` | настройки, которые nsq передаёт каждому CLI для каждого агента |
| `worktrees/` | [worktree](https://docs.neurosquad.ai/ru/cli/worktrees) агентов |
| `models/` | модель диктовки |

Секреты — ключ OpenRouter и необязательный вход в аккаунт — хранятся в хранилище секретов ОС, а не в
этой папке.