Repository Understanding
NanoAgent builds a semantic graph of your entire codebase locally. It knows where things are and how they connect.
NanoAgent runs on your machine. It understands your repository, plans changes, edits files, runs validation, and reviews diffs. Quietly capable, incredibly precise.
$ curl -fsSL https://raw.githubusercontent.com/getnanoai/NanoAgent/master/scripts/install.sh | bash
PS> irm https://raw.githubusercontent.com/getnanoai/NanoAgent/master/scripts/install.ps1 | iex
$ npm install -g nanoai-cli
$ pnpm add -g nanoai-cli
$ bun add -g nanoai-cli
$ ext install rizwan3d.nanoagent
Docked tool window drives the local nanoai CLI over ACP.
› Extensions ▸ Manage Extensions ▸ search “NanoAgent”
Docked tool window drives the local nanoai CLI over ACP.
↓ Windows · macOS · Linux (x64 / arm64)
Verify with SHA256SUMS + build attestation.
Works Where You Work
Because an AI coding assistant should be powerful, transparent, and respect your workspace.
NanoAgent runs locally, indexes locally, and stores embeddings locally. No uploading repositories to third-party servers.
Every plan, edit, and validation step is visible before it touches your files. You approve the path forward.
Destructive actions require explicit approval. NanoAgent asks before running shells, writing files, or committing changes.
Works in the terminal, on the desktop, inside VS Code and Visual Studio, and as a CI reviewer for pull requests.
LSP-powered semantic understanding, graph-aware indexing, and diff-based edits make it precise in large projects.
Team knowledge lives in version-controlled .nanoagent/memory files you can read, review, and
edit — not hidden agent notes.
! and !! shellRun shell commands inline with ! and launch live background terminals with
!! — no need to switch terminals.
Stage changes, review diffs, create commits, and manage branches in one place.
Tools and commands run inside a sandbox with permission gates for file edits, network access, and elevated operations.
NanoAgent isn't a chatbot. It's a structured workflow engine that operates autonomously but transparently.
NanoAgent builds a semantic graph of your entire codebase locally. It knows where things are and how they connect.
Before writing a single line of code, the agent formulates a step-by-step plan for your approval.
Applies targeted modifications to files. No messy copy-pasting, just clean, structural diffs.
Runs your tests and linters in the background, automatically fixing errors until the build goes green.
You remain in the driver's seat. Review the proposed diffs before they are committed.
A practical look at what makes NanoAgent different from the tools you already know.
| Feature | NanoAgent | Codex | Claude Code | OpenCode | Kilo Code | GitHub Copilot | Aider |
|---|---|---|---|---|---|---|---|
| Local-first | ✓ | ◐ | ◐ | ✓ | ◐ | – | ✓ |
| Repo memory | ✓ | ◐ | ✓ | ◐ | ◐ | ◐ | – |
| VS Code extension | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | – |
| Visual Studio | ✓ | – | – | – | – | ✓ | – |
| ACP-compatible editors | ✓ | – | ✓ | ✓ | ✓ | ✓ | – |
| CI code reviews | ✓ | ✓ | ✓ | – | ✓ | ✓ | – |
| 15+ AI providers | ✓ | – | – | ✓ | ✓ | – | ✓ |
| ACP protocol | ✓ | – | – | ✓ | ✓ | – | – |
| Sandboxed execution | ✓ | ✓ | ✓ | – | – | – | – |
| Open source | ✓ | ✓ | – | ✓ | ✓ | – | ✓ |
| LSP | ✓ | – | – | ✓ | – | ✓ | – |
| Direct shell & background terminals | ✓ | ◐ | ✓ | ◐ | ✓ | ◐ | ◐ |
| Git sidebar | ✓ | – | – | – | – | ● | – |
| Subagents & orchestration | ✓ | ✓ | ✓ | ✓ | ✓ | ◐ | – |
| Local codebase indexing | ✓ | – | – | – | ✓ | ◐ | ◐ |
| Memory, audit & hooks | ✓ | – | ✓ | – | – | – | – |
| NuGet library release | ✓ | – | ✓ | – | – | – | – |
✓ Yes · ◐ Partial · – No
Comparison is based on publicly documented capabilities as of mid-2026. Features change quickly; verify details on each product's official site before making a decision.
From subscription sign-in to API-key providers to fully local models — NanoAgent adapts to what you already pay for.
In a world of cloud-hosted AI, NanoAgent takes a different path. Your proprietary source code never leaves your workstation unless you push it.
Operates entirely within your local environment or secure VPC.
Local models mean instant responses and no rate limits.
Vector embeddings are stored locally, avoiding third-party data collection.
NanoAgent Gateway is the control plane for enterprise AI. Put a single OpenAI-compatible endpoint in front of your traffic and give security, finance, and platform teams the visibility and control they need.
Track how teams use models and watch for anomalies as adoption grows.
Attribute usage by team, app, project, and user so budgets stop being guesswork.
Keep clients pointed at one endpoint while your team manages changes behind the scenes.
import { streamText } from 'ai'import { createOpenAI } from '@ai-sdk/openai' const nano = createOpenAI({ baseURL: 'https://app.getnanoai.com/v1', apiKey: process.env.NANOAGENT_API_KEY,}) const result = streamText({ model: nano.chat('anthropic/claude-opus-4-8'), prompt: 'Why is the sky blue?',})
import osfrom openai import OpenAI client = OpenAI( base_url="https://app.getnanoai.com/v1", api_key=os.environ["NANOAGENT_API_KEY"],) stream = client.chat.completions.create( model="anthropic/claude-opus-4-8", messages=[{"role": "user", "content": "Why is the sky blue?"}], stream=True,)
# point any OpenAI-compatible client at the Gatewaycurl https://app.getnanoai.com/v1/chat/completions \ -H "Authorization: Bearer $NANOAGENT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "anthropic/claude-opus-4-8", "messages": [{"role": "user", "content": "Why is the sky blue?"}], "stream": true }'
NanoForge's agent scaffolds, builds, and live-previews a real React + Express + PostgreSQL app in an isolated container, backed by its own GitHub repo and database.
React frontend, Express API, and PostgreSQL schema generated together from one description.
Each app runs in its own container with a live URL and hot reload before it touches your machine.
Changes are committed to a dedicated GitHub repo so you can inspect, approve, or edit before merging.
The core NanoAgent package also ships on NuGet. Tagged releases publish the NanoAgent library to NuGet.org alongside the desktop and CLI assets. The end-user command-line experience is still distributed through the release installers.
dotnet add package NanoAgent
Released under the permissive Apache-2.0 License. Contribute, fork, and build upon NanoAgent without restrictions.