Repository Understanding
NanoAgent builds a semantic graph of your entire codebase locally. It knows where things are and how they connect.
Built for real codebases. Designed to keep you in control.
NanoAgent works locally across your terminal, editor, and desktop. It understands repository context, proposes a plan, asks before meaningful actions, and lets you review every diff.
Apache-2.0 open source · Local-first workflow · Terminal, editor, desktop, and CI/CD
$npm install -g nanoai-cli$ext install rizwan3d.nanoagentDocked 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.
nanoai
Works Where You Work
Power-user engineering features. Nothing hidden.
Structured context, reviewable planning, safe execution, and model flexibility. Built for practical software work rather than one-off code generation.
- 🧩
Local repository context
Build semantic, language-aware context from your codebase locally so the agent can reason across real projects.
- 🗺️
Reviewable planning
Use a read-only planning workflow to inspect the intended approach before a file is changed.
- 🛡️
Permission-gated actions
Approve file edits, commands, network access, and elevated operations before they happen.
- 🧠
Repository memory in Git
Keep team knowledge in version-controlled memory files you can inspect, review, and evolve together.
- ⌨️
Fits your workflow
Work from the terminal, desktop, VS Code, Visual Studio, and supported CI/CD workflows.
- ↗️
Provider flexibility
Choose hosted, API-key, OpenAI-compatible, or local model providers without changing how you work.
- ⚙️
Headless & CI mode
Non-interactive single-query mode for CI/CD pipelines, scripts, and automation. Supports piped stdin.
Precision engineered for complex codebases.
NanoAgent isn't a chatbot. It's a structured workflow engine that operates autonomously but transparently.
Strategic Planning
Before writing a single line of code, the agent formulates a step-by-step plan for your approval.
Precision Editing
Applies targeted modifications to files. No messy copy-pasting, just clean, structural diffs.
Automated Validation
Runs your tests and linters in the background, automatically fixing errors until the build goes green.
Human Review
You remain in the driver's seat. Review the proposed diffs before they are committed.
An autonomous workflow you can inspect.
Move quickly without losing the ability to see, guide, and approve what your coding agent does.
01
Understand the repository
NanoAgent gathers relevant codebase context, symbols, diagnostics, and existing project knowledge before it acts.
02
Propose a reviewable plan
See what it intends to change and which checks it plans to run, then approve or redirect the work.
03
Edit, validate, and review
NanoAgent applies the approved work, runs validation, and leaves you with targeted diffs to inspect.
See what makes NanoAgent different.
Compare the execution model, engineering workflow, integrations, and model flexibility that matter when AI becomes part of real software development.
| Feature | NanoAgent | Codex | Claude Code | OpenCode | GitHub Copilot | Aider |
|---|---|---|---|---|---|---|
| Local-first execution | ✓ | ◐ | ◐ | ✓ | – | ✓ |
| Local codebase indexing | ✓ | ◐ | ◐ | ◐ | ◐ | ◐ |
| Sandboxed execution | ✓ | ◐ | ◐ | – | – | – |
| Direct shell & bg terminals | ✓ | ◐ | ✓ | ◐ | ◐ | ◐ |
| Repo memory under version control | ✓ | ◐ | ◐ | ◐ | ◐ | – |
| LSP-aware coding workflow | ✓ | ◐ | ◐ | ◐ | ◐ | ◐ |
| Reviewable planning mode | ✓ | ◐ | ◐ | ◐ | ◐ | ◐ |
| Automated validation workflow | ✓ | ✓ | ✓ | ◐ | ◐ | ◐ |
| Subagents & orchestration | ✓ | ◐ | ◐ | ◐ | ◐ | – |
| VS Code workflow | ✓ | ✓ | ✓ | ✓ | ✓ | ◐ |
| Visual Studio workflow | ✓ | – | – | – | ◐ | – |
| CI/CD and headless workflows | ✓ | ◐ | ◐ | ◐ | ◐ | ◐ |
| SDK for embedding in applications | ✓ | – | – | ◐ | – | – |
| Multiple model providers (15+) | ✓ | ◐ | ◐ | ✓ | ◐ | ✓ |
| OpenAI-compatible endpoints | ✓ | – | – | ✓ | – | ✓ |
| Open source (Apache-2.0) | ✓ | ◐ | – | ✓ | – | ✓ |
✓ Yes · ◐ Partial · – No
Use the model that fits your budget, workflow, and policy.
NanoAgent is your coding workflow layer. Keep the flexibility to use the model source you already pay for — whether that is a subscription, API provider, OpenAI-compatible endpoint, or local model.
- OpenAI
- ChatGPT Plus / Pro
- Anthropic Claude Pro / Max
- GitHub Copilot
- OpenRouter
- Nano Code
- Cerebras
- Groq
- DeepSeek
- Anthropic
- Google AI Studio
- Ollama
- LM Studio
- Ollama Cloud
- OpenAI-compatible
Your code.Your environment.Your choice of model.
NanoAgent takes a local-first approach to repository understanding and developer control. Keep indexing and supported operations close to your codebase while choosing the model provider that fits your technical and policy requirements.
Local execution
Run the agent and repository indexing in your local environment or secure VPC according to your deployment configuration.
Local indexing
Keep vector embeddings and codebase context under your control instead of requiring a third-party repository workspace.
Provider flexibility
Use hosted, API-key, gateway, or local models without changing the core developer workflow.
Need centralized model routing, spend attribution, policy controls, and audit-ready usage records? Explore NanoAgent Gateway for teams →
NuGet library
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 NanoAgentUse an AI coding agent you can actually inspect.
Install NanoAgent free and bring AI into your codebase without giving up visibility, control, or provider choice.
✨ Want Voice Mode & IDE release notifications?
Zero spam. Only breaking updates & new platform capabilities.