# Проблемы и удаление

> Как решить частые проблемы nsq — nsq doctor, терминальный модуль (node-pty, ConPTY), хуки и curl, хранилище секретов — и как чисто удалить nsq.

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

## Начните с `nsq doctor`

```sh
nsq doctor
```

Команда печатает версии nsq и Node, папку данных, работает ли демон, где найден каждый CLI агента,
работают ли `curl` и терминальный модуль, есть ли ключ OpenRouter, а также ваш терминал и его размер.
Приложите её вывод к сообщению об ошибке.

Журнал демона — `~/.neurosquad-cli/daemon.log`.

## Агент «not found»

nsq запускает CLI из вашего `PATH` и типовых папок установки (а в Windows — ещё и из текущего `PATH`
в реестре, так что CLI, установленный минуту назад, находится). Проверьте, что `claude`, `codex` или
`opencode` запускается в вашем терминале; `nsq doctor` показывает, что нашёл nsq. Если CLI лежит в
необычном месте, выполните `nsq down` и снова запустите nsq из терминала, где CLI работает
(работавшие агенты продолжат свои сессии).

## Статус не меняется или «ждёт вас» не приходит

Claude Code и Codex сообщают статус через `curl`. Если `nsq doctor` пишет `curl MISSING`, установите
его (он есть в Windows 10 и новее, в macOS и в большинстве дистрибутивов Linux). Обычная команда
(`nsq run -- …`) никогда не показывает «ждёт вас» — у неё нет хуков.

## Не загружается терминальный модуль (node-pty)

nsq управляет терминалами через node-pty, собранный заранее для каждой поддерживаемой платформы, —
при установке ничего не компилируется. Если `nsq doctor` показывает `node-pty FAILED`:

- проверьте, что `node --version` — 22.13 или новее, и переустановите nsq после смены версии Node
(`npm install -g neurosquad`);
- убедитесь, что для этой установки не были выключены install-скрипты (`--ignore-scripts`);
- в Windows nsq использует ConPTY, псевдоконсоль Windows (Windows 10 версии 1809 или новее). Лучший
терминал для дашборда — Windows Terminal; старое окно консоли тоже работает, но рисует хуже.

## Кракозябры, не те цвета или сломанные логотипы

Возможно, терминал не умеет того, что определил nsq. Попробуйте `NSQ_GLYPHS=ascii`, `NSQ_COLOR=256`
или `NSQ_LOGOS=glyphs` (или `none`), а если рамки съезжают в CJK-окружении — `NSQ_AMBIGUOUS_WIDE=1`.
См. [Настройка](https://docs.neurosquad.ai/ru/cli/configuration).

## Нет уведомлений

См. [Уведомления](https://docs.neurosquad.ai/ru/cli/notifications): на macOS установите `terminal-notifier` или разрешите
уведомления «Редактору скриптов»; в Linux на рабочем столе должна работать служба уведомлений. По
SSH держите дашборд открытым — он подаёт сигнал в терминале.

## Ключ OpenRouter не сохраняется

Ключ хранится в хранилище секретов ОС. В Linux для этого нужен Secret Service (GNOME Keyring,
KWallet), которого на сервере часто нет; вместо этого задайте `OPENROUTER_API_KEY` в окружении, из
которого запускается демон.

## Удаление

```sh
nsq down                          # остановить демон и его агентов
nsq openrouter clear-key          # удалить ключ OpenRouter из хранилища секретов
nsq logout                        # только если вы входили в аккаунт
npm uninstall -g neurosquad
```

Затем удалите `~/.neurosquad-cli` (или ваш `NSQ_HOME`) — там список агентов, настройки, журналы,
модель диктовки и worktree агентов, поэтому сначала проверьте `worktrees/` на нужную вам работу.
Ветки, созданные nsq (`nsq/<имя>`), остаются в ваших репозиториях, пока вы не удалите их через git.
Ваши CLI агентов и их собственные настройки не менялись.