nanocode-cli 0.2.1

A lightweight terminal-based AI coding assistant

nanocode

A lightweight terminal-based AI coding assistant.

nanocode is used to help building itself, including features such as @file path completion.

Screenshots

Install

uv tool install nanocode-cli

Upgrade an existing install:

uv tool upgrade nanocode-cli

For local development:

uv sync --extra dev
uv run nanocode

Environment Variables

Required:

export NANOCODE_API_URL="https://api.example.com/v1"
export NANOCODE_API_KEY="your-api-key"
export NANOCODE_MODEL="your-model"

Optional:

export NANOCODE_DIR=".nanocode"
export NANOCODE_TEMPERATURE="0.7"
export NANOCODE_REASONING="on"
export NANOCODE_REASONING_EFFORT="medium"
export NANOCODE_MODEL_TIMEOUT="60"
export NANOCODE_SHELL_TIMEOUT="60"
export NANOCODE_COMPACT_AT="100"

Usage

Start nanocode:

nanocode

Show available commands:

/help

Ask a source-aware question about nanocode itself:

/help how does compact work?

Safety

nanocode does not provide sandbox protection. It can run shell commands and edit files in the environment where you start it.

If you do not fully trust the model, tools, prompts, or workspace, run nanocode inside your own sandbox, container, VM, or other isolated environment.

Use at your own risk.