Installation

Prerequisites

• Linux or macOS. n10 runs every agent and terminal in tmux, which has no native Windows build.
• Git 2.38 or newer, and Node.js 22.12 or newer with npm.
• tmux 3.2 or newer.
• 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.

A .deb package and an AppImage for Linux are coming, tracked in #122.

Next: Getting started.