Installation

Prerequisites

• Linux, macOS or Windows through WSL 2 (experimental).
• Git 2.38 or newer, and Node.js 22.12 or newer with npm.
• tmux 3.2 or newer. On tmux 3.5 or newer, add set -s extended-keys on to ~/.tmux.conf, or Shift+Enter in n10 Desktop submits instead of starting a new line (#335).
• At least one agent CLI on your PATH, signed in: claude, codex, gemini, copilot or opencode.
• For GitHub, the gh CLI, signed in with gh auth login.
• For Azure DevOps, a personal access token with Code (Read & Write), Build (Read) and Project and Team (Read).
• On Linux, build-essential and python3. npm compiles node-pty during the install.

Install

One package holds n10 Desktop and the terminal UI:

npm install -g @notaharness/n10

Then, from a repository:

n10          # open n10 Desktop
n10 --tui    # run the terminal UI instead

n10 --help lists every command, and n10 --version prints the installed version.

n10 Desktop also comes as a .deb or AppImage for Linux and a .dmg for macOS. See Releases.

Next: Getting started.