Your local AI coding agent for desktop, terminal, and editor workflows.
NanoAgent gives developers an AI teammate that can work inside a real repository while keeping the human in control. Ask it to understand a codebase, plan a change, edit files, run validation, review a diff, or automate a pull request review from the same toolchain you already use.
It is built for practical engineering work: local projects, real shells, version-controlled memory, reviewable changes, and explicit approval for sensitive actions.
- Understand unfamiliar code faster with repository-aware search, summaries, and focused file inspection.
- Turn feature requests and bug reports into planned, editable, testable changes.
- Run code review with a findings-first workflow for local diffs, files, pull requests, and merge requests.
- Switch between hands-on implementation, read-only planning, and read-only review profiles.
- Keep team knowledge in reviewable
.nanoagent/memoryfiles instead of hidden agent notes. - Save repeatable slash prompts in
.nanoagent/commandsand run them from the terminal, desktop app, or editor. - Use the provider that fits your budget and policy, from API-key providers to subscription sign-in and local Ollama.
- Bring the same agent into desktop, terminal, VS Code, ACP-compatible editors, and CI review automation.
Use the desktop app for a visual workspace with chat, model controls, profile switching, budget controls, permission prompts, activity output, and undo/redo for tracked file edits.
Use nanoai when you want a keyboard-first agent for interactive work, one-shot prompts, piped input, quick reviews, and automation-friendly output.
Use the VS Code extension to chat with NanoAgent, send selections, review files, review Git diffs, and apply suggested changes from inside the editor.
Use the Visual Studio extension to keep a NanoAgent tool window inside Visual Studio while driving the local NanoAgent CLI over ACP.
Use the included GitHub Actions, GitLab CI, and Bitbucket Pipelines examples to run NanoAgent against pull request and merge request diffs, then post review comments back to your platform.
NanoAgent is designed for useful automation without silent surprises.
- Profiles separate implementation, planning, review, exploration, and delegated work.
- Permission rules decide what can run automatically, what asks first, and what is denied.
- Sensitive actions can require approval, including file edits, shell commands, network access, MCP tools, memory writes, and elevated operations.
- Tracked file edits can be undone and redone.
- Secret-looking values are redacted before logs, memory, audit records, and displayed tool output.
- Your workspace stays local; prompts and selected context are sent only to the model provider you configure when needed for a request.
NanoAgent sends anonymous product analytics to PostHog using built-in US Cloud defaults in code. You can still override Application:Telemetry:* settings, and /disableanalytics writes Application.Telemetry.Enabled=false to .nanoagent/agent-profile.json for the current workspace.
Collected:
- NanoAgent version
- OS family
- app surface such as CLI, Desktop, VS Code, Visual Studio, or JetBrains
- feature names used
- success and failure counts
- token and duration buckets
- daily runs and usage-time buckets
Never collected:
- prompts
- source code
- file paths
- repository names or URLs
- API keys
- terminal output
NanoAgent supports OpenAI, ChatGPT Plus/Pro sign-in, Anthropic Claude Pro/Max sign-in, GitHub Copilot sign-in, OpenRouter, Kilo Code, Cerebras, Groq, Anthropic, Google AI Studio, Ollama, Ollama Cloud, and OpenAI-compatible providers.
Download the latest desktop build from GitHub Releases, or install the CLI:
Release assets also publish SHA256SUMS and GitHub artifact attestations so you can verify both checksums and build provenance.
| Platform | Architecture | Download |
|---|---|---|
| Windows | x64 | Setup .exe |
| Windows | x64 | Portable .zip |
| macOS | Apple Silicon / arm64 | Download .zip |
| macOS | Intel / x64 | Download .zip |
| Linux | x64 | Download .zip |
| Linux | arm64 | Download .zip |
NuGet / .NET tool:
dotnet tool install --global NanoAgent.CLIDirect release installer:
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/rizwan3d/NanoAgent/master/scripts/install.sh | bashWindows PowerShell:
irm https://raw.githubusercontent.com/rizwan3d/NanoAgent/master/scripts/install.ps1 | iexThen start NanoAgent:
nanoaiThe tag-based release workflows publish only NanoAgent to NuGet.org.
The technical guide lives in docs/documentation.md. It covers installation details, first-run onboarding, desktop and terminal workflows, VS Code and Visual Studio setup, ACP integration, CI review automation, codebase indexing, providers, permissions, MCP, memory, hooks, troubleshooting, release automation, and source builds.
Apache License 2.0. See LICENSE.txt.
Sponsored by
