nsq — NeuroSquad in your terminal

Run several AI coding agents from one terminal.

nsq starts Claude Code, Codex, OpenCode or any command, keeps them running in a background daemon, shows them as live terminals in one dashboard, and tells you when one of them is waiting for you, including the question it is asking. You can answer from the dashboard.

0.1.0 is a preview. Commands, keys and config may still change before 1.0. Please report what breaks.

Install

Requires Node.js 22.13 or newer. No compiler needed: native parts ship prebuilt for Windows (x64, arm64), macOS (Apple silicon, Intel) and Linux (x64, arm64).

npm install -g neurosquad      # then run: nsq
npx neurosquad                 # or try it without installing

More ways (Homebrew, Scoop, install scripts) and uninstalling: docs/guide/getting-started.md. nsq then keeps itself up to date: installed with npm, Homebrew or Scoop, it installs a new release in the background (other installs show the command to run) and switches to it once nothing would be lost — no busy agent, no open dashboard, every agent able to resume its session — or when you press U (updates; nsq config set autoUpdate false turns it off).

Quick start

cd ~/code/my-app
nsq run claude "fix the flaky checkout test" --worktree   # an agent on its own branch
nsq run codex --name reviewer                             # a second agent
nsq run -- claude --effort high                           # or the CLI's own command line
nsq run -- npm run dev                                    # any command, as an agent
nsq                                                       # the dashboard

In the dashboard, select an agent with the arrows, press Enter to work in it full screen, and Ctrl+] to go back to the grid. When an agent asks a permission question, press y, a or n without opening it. Press q to close the dashboard — the agents keep running.

What it does

• Agents that outlive the window. A per-user daemon owns the terminals. Close the dashboard or the terminal — the agents keep working. nsq down stops them; the next nsq up (or just nsq) brings them back on their own sessions — after a reboot too.
• One dashboard. Workspaces and agents in a sidebar, the selected workspace as a grid of live terminals; any agent opens full screen and goes back to the grid.
• Exact status, with the question. Working / needs you / finished comes from each CLI's own hooks, not from guessing at the screen. "Needs you" carries the harness's own text, e.g. Claude wants to run: npm test.
• Quiet while working. Some prompts come from tools that never fire a hook — git asking for a password, an installer's [y/N], sudo, ssh's host key — or a command just hangs. When a working agent's screen has not changed for 5 minutes (quietAfter; a turning spinner does not count), it shows as quiet — check it, with the prompt it seems to show, and calls you like "needs you".
• Answer inline. y / a / n (yes / always / no) on a permission prompt, i to interrupt, s to send a prompt — or S to send it when the current turn ends.
• An approvals log. Every "needs you" question and how it ended, for all agents, in one file: which agent asked, the exact question (tool, command / path / url), the answer, and who gave it from where — the dashboard, nsq answer, the phone (this machine, the Wi-Fi or the internet, and the device), the agent's own terminal, or the CLI itself. nsq log approvals.
• Notifications and sound. A native notification on Windows, macOS and Linux when an agent needs you or finishes — one per agent, withdrawn when it works again. Over SSH or without a desktop, the dashboard rings its own terminal instead (bell + OSC 9).
• A git worktree per agent. --worktree gives the agent its own checkout on branch nsq/<name>, so parallel agents don't trip over each other. nsq diff <agent> shows its uncommitted changes.
• Cost per agent. nsq cost reads tokens from each harness's own logs. A model without a known price shows "no price", never $0.
• Your config stays yours. ~/.claude, ~/.codex and opencode.json are never written: everything nsq needs lives in a per-agent layer (flags, environment, its own folder).
• OpenRouter built in. One key, any model, for Claude Code, Codex and OpenCode.
• Your own model servers. llama.cpp, Ollama, LM Studio, vLLM, SGLang, Unsloth Studio or any OpenAI- / Anthropic-compatible API — tested, then offered to each CLI that can speak to it.
• Voice dictation. Local speech recognition; the text is pasted into the agent, never sent.
• Phone (experimental). Pair a phone with a QR code and answer your agents from it.
• Terminal graphics. CLI logos over kitty / iTerm2 / sixel graphics, light animations that switch off over SSH and on request, ASCII fallbacks.

Supported: Claude Code, Codex, OpenCode (1.x and 2.x), and any command (nsq run -- <command>; it has no hooks, so it shows working / finished, never "needs you"). Agents that support the herdr status protocol (Crush, Kiro CLI, Command Code and others) work in nsq out of the box with nsq run -- <agent>: they report working, needs you and finished themselves, and nsq resumes their session when they report how to (how). Want another CLI? Request it.

Keys

The mouse works too: click selects, double-click opens, the wheel scrolls an agent's output back (over a tile or full screen; Shift+PgUp too) and, over the sidebar, moves the selection. Drag over an agent's text to copy it, click a link to open it in your browser: the dashboard holds the mouse, so it does what your terminal would.

Commands

nsq                                   the dashboard (starts the daemon)
nsq run <claude|codex|opencode> [prompt]
        [--name n] [--worktree] [--model id] [--provider name|openrouter]
        [--dangerous] [--attach]
nsq run [--name n] -- <command…>      any command
nsq ls [--json]                       agents and their status
nsq attach <agent>                    full-screen terminal (Ctrl+] to detach)
nsq send <agent> "prompt" [--when-done]
nsq answer <agent> yes|always|no      answer a permission prompt
nsq interrupt|stop|start|restart <agent>
nsq rm <agent> [--worktree]           remove (and delete its worktree)
nsq set <agent> [--dangerous on|off] [--model id|none]
        [--provider name|openrouter|none] [--quiet-after min|default]
nsq diff <agent>                      uncommitted changes (git diff HEAD) in its folder
nsq peek <agent> [-n 20]              the last lines of its screen
nsq cost [--since 7d] [--json]        what each agent spent
nsq log approvals [--agent x] [--since 2h] [--json]
                                      every "needs you" question, its answer and who gave it
nsq openrouter set-key|clear-key|models [query]|status
nsq openrouter test <model> [--harness claude|codex|opencode]
nsq provider add <name> --url <base> [--key-stdin|--ask-key]
                                      your own server: llama.cpp, Ollama, LM Studio,