Проблемы и удаление
Начните с nsq doctor
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.
См. Настройка.
Нет уведомлений
См. Уведомления: на macOS установите terminal-notifier или разрешите
уведомления «Редактору скриптов»; в Linux на рабочем столе должна работать служба уведомлений. По
SSH держите дашборд открытым — он подаёт сигнал в терминале.
Ключ OpenRouter не сохраняется
Ключ хранится в хранилище секретов ОС. В Linux для этого нужен Secret Service (GNOME Keyring,
KWallet), которого на сервере часто нет; вместо этого задайте OPENROUTER_API_KEY в окружении, из
которого запускается демон.
Удаление
nsq down # остановить демон и его агентов
nsq openrouter clear-key # удалить ключ OpenRouter из хранилища секретов
nsq logout # только если вы входили в аккаунт
npm uninstall -g neurosquadЗатем удалите ~/.neurosquad-cli (или ваш NSQ_HOME) — там список агентов, настройки, журналы,
модель диктовки и worktree агентов, поэтому сначала проверьте worktrees/ на нужную вам работу.
Ветки, созданные nsq (nsq/<имя>), остаются в ваших репозиториях, пока вы не удалите их через git.
Ваши CLI агентов и их собственные настройки не менялись.