nanocode-cli 0.2.9

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

Features

• Constrained Output: Force model replies into auditable action frames.
• Verified Edits: Reject stale range edits before they touch files.
• Autonomous Loop: Chain reading, editing, running, and verification.
• Live Telemetry: Stream tool intent, token use, cost, and status.

Tools

• File: Read, LineCount, ListDir, Search.
• Edit: Edit, ReplaceRange, BatchReplaceRanges, ApplyPatch.
• Shell: Bash, Git.
• Memory: Blackboard.

Commands

• Info: /help [question], /status.
• Session: /compact, /blackboard [status|clear].
• Config: /model, /compact-at, /reason, /reason_effort, /stream, /yolo.
• Exit: /exit, /quit.

Configuration

• Required: NANOCODE_API_URL, NANOCODE_API_KEY, NANOCODE_MODEL.
• Runtime: NANOCODE_DIR, NANOCODE_TEMPERATURE, NANOCODE_STREAM.
• Reasoning: NANOCODE_REASONING, NANOCODE_REASONING_EFFORT.
• Limits: NANOCODE_MODEL_TIMEOUT, NANOCODE_SHELL_TIMEOUT, NANOCODE_COMPACT_AT, NANOCODE_MAX_AGENT_STEPS.
• Cost: NANOCODE_PROMPT_PRICE_PER_1M_TOKENS, NANOCODE_COMPLETION_PRICE_PER_1M_TOKENS.

Status

• Status bar: model, reasoning, context, tokens/cost, blackboard, elapsed time, and active model-call time.
• /status: model, reasoning, stream, yolo, conversation, tokens/cost, blackboard, goal, and verification.

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

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.