Nova
Install the CLI on macOS, Linux, or Windows — or download the standalone Windows build. Free and MIT-licensed; you pay only for model usage.
Nova is a free, MIT-licensed AI coding agent that runs in your terminal. Install it on macOS, Linux, or Windows with npm i -g @circuit-nova/nova-cli, which requires Node.js 22.5 or newer. Windows users can instead download a standalone installer that needs no Node.js runtime. Nova reads your repository, plans a change, edits files, and runs commands, using a CircuitNotion API key for model access.
macOS, Linux, and Windows. Requires Node.js 22.5+.
npm i -g @circuit-nova/nova-cliStandalone x64 build — no separate Node.js install needed.
Standard setup wizard. Best choice for most people.
Nova_0.1.7_x64-setup.exe
For managed or scripted deployment via Group Policy or Intune.
Nova_0.1.7_x64_en-US.msi
Downloads are served from the signed GitHub release. macOS and Linux users: install the CLI from npm.
1# Install globally (recommended for a CLI)
2npm i -g @circuit-nova/nova-cli
3
4nova --version # 1.0.0
5
6# Project-local instead
7# npm i @circuit-nova/nova-cli
8
9# Or run once without installing
10# npx @circuit-nova/nova-cli@latest --versionQuickstart
Nova authenticates with a CircuitNotion API key set in your environment.
1# 1. Point Nova at your CircuitNotion key
2export CIRCUITNOTION_API_KEY=cn_YOUR_KEY
3
4# 2. Run it in a project
5cd your-project
6nova # interactive session
7nova "Fix the failing test in src/parser.ts"
8
9# 3. Read-only mode — write tools never load
10nova --plan "how does auth work here?"
11
12# Health check for proxies and firewalls
13nova --doctorCreate a key on the developer platform and add credits. The same key works with Claude Code, Cline, and Hermes too.
Capabilities
Nova reads the repository as it is, proposes a plan, then edits files and runs commands — or works in an isolated remote sandbox when you prefer.
Destructive steps ask first. Plan mode never loads write tools at all, so you can point it at unfamiliar code safely.
Work is checkpointed as it goes, so an unwanted change is a revert away rather than a manual cleanup.
Token spend is tracked per run against your CircuitNotion balance, so an agent loop never becomes a surprise bill.
Integrity
Every Windows installer is published with a detached signature on the release.
# Each installer ships a detached .sig from the release
# Download the installer and its .sig, then verify before running.
# Signatures: https://github.com/chrisnkuno/circuit-agent/releases/download/v0.1.7/Nova_0.1.7_x64-setup.exe.sigCompare
Same agent, two distributions. The version numbers are independent.
| Nova CLI | Nova for Windows | |
|---|---|---|
| Version | 1.0.0 | 0.1.7 |
| Operating systems | macOS, Linux, Windows | Windows 10 and 11 (x64) |
| Requires Node.js | Yes — 22.5 or newer | No |
| How to get it | npm i -g @circuit-nova/nova-cli | Download the .exe or .msi |
| Download size | — | 27.8 MB (.exe) / 39.9 MB (.msi) |
| License | MIT | MIT |
| Price | Free — you pay only for model usage | Free — you pay only for model usage |
FAQ
Run "npm i -g @circuit-nova/nova-cli" to install the command-line agent on macOS, Linux, or Windows. It requires Node.js 22.5 or newer. On Windows you can instead download the desktop installer, which does not require Node.js.
Nova is published under the MIT license, and the source is on GitHub at https://github.com/chrisnkuno/circuit-agent. The agent itself is free; you pay only for the model usage it makes through your CircuitNotion API key.
The CLI runs anywhere Node.js 22.5+ runs — macOS, Linux, and Windows. The packaged desktop build is currently Windows x64 only; macOS and Linux users should install the CLI from npm.
They are the same agent in two forms. The npm CLI (version 1.0.0) runs in your terminal and needs Node.js. The Windows desktop build (version 0.1.7) is a standalone installer with no Node.js requirement. The two version numbers are independent.
Yes. Nova runs against models through a CircuitNotion API key set as the CIRCUITNOTION_API_KEY environment variable. You can create one on the CircuitNotion developer platform.
Every installer on the release page ships with a detached .sig signature file. Download the signature alongside the installer and verify it before running the setup.