# Install and quick start

> Install nsq with npm (or try it with npx), then start agents and open the dashboard in five commands.

Source: https://docs.neurosquad.ai/en/cli/install

## Requirements

- **Node.js 22.13 or newer** ([nodejs.org](https://nodejs.org)).
- **Windows** (x64, arm64), **macOS** (Apple silicon, Intel) or **Linux** (x64, arm64). Native parts
come prebuilt — no compiler needed.
- At least one agent CLI you already use and are signed in to: Claude Code, Codex CLI or OpenCode.
nsq starts them; it does not install them.
- `curl` on `PATH` (Claude Code and Codex report their status through it). It ships with Windows 10
and later, macOS and most Linux distributions.

## Install

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

The command is `nsq`. Check the install with `nsq doctor`: it lists the agent CLIs it found, the
daemon, `curl`, the terminal and the OpenRouter key.

> Package managers and one-line install scripts follow the npm release: Homebrew
> (`brew install glmn-ai/neurosquad/neurosquad-cli`), Scoop (`scoop bucket add neurosquad
> https://github.com/glmn-ai/scoop-neurosquad`, then `scoop install neurosquad-cli`) and install
> scripts that use your own npm. Until they are live, use npm.

## Quick start

**1. Start an agent on a task**

```sh
nsq run claude "fix the flaky checkout test" --worktree
```

`--worktree` gives the agent its own branch and checkout, so several agents can work on one
repository without stepping on each other.

**2. Start another one**

```sh
nsq run codex --name reviewer
```

**3. Or any command**

```sh
nsq run -- npm run dev
```

**4. Open the dashboard**

```sh
nsq
```

A grid of live terminals. When an agent needs you, its tile lights up with the question;
press `y`, `a` or `n` to answer, `Enter` to open it full
screen, `q` to leave — the agents keep running.

**5. Check on them from anywhere**

```sh
nsq ls
```

Status, the pending question and the cost of each agent, from any terminal.

Agents start in the current folder. Next: [the dashboard and its keys](https://docs.neurosquad.ai/en/cli/dashboard).