Install nca

One command on macOS and Linux. Detects your platform, downloads the latest release from GitHub, and installs to/usr/local/bin.

One-line install

curl -fsSL https://nca-cli.com/install | bash

Set NCA_INSTALL_DIR to change the install path from the default. After install, run nca doctor to verify provider readiness, then open a project directory and type nca.

GitHub Releases

Pre-built binaries for every release are on theReleases page. Windows: download the matching .zip and putnca.exe on your PATH.

macOS (Apple Silicon)aarch64-apple-darwin · .tar.gz
macOS (Intel)x86_64-apple-darwin · .tar.gz
Linux (x86_64)x86_64-unknown-linux-gnu · .tar.gz
Linux (ARM64)aarch64-unknown-linux-gnu · .tar.gz
Windows (x86_64)x86_64-pc-windows-msvc · .zip

Build from source

Requires Rust edition 2024 and a recent toolchain.

$ git clone https://github.com/madebyaris/native-cli-ai.git
$ cd native-cli-ai
$ cargo build --release
$ cp target/release/nca /usr/local/bin/

Quick start

# Configure a provider
$ export MINIMAX_API_KEY="your-api-key"

# Interactive CLI
$ nca

# Line REPL (no full-screen TUI)
$ nca --no-tui

# One-shot
$ nca run --prompt "Explain this repository"

# Detached session
$ nca spawn --prompt "Inspect the repo and draft a plan"

# Inspect & attach
$ nca sessions
$ nca status <session_id>
$ nca attach <session_id>

Next:Getting started·Providers

Back to home