███╗ ██╗ █████╗ ███╗ ██╗ ██████╗ █████╗ ██████╗ ███████╗ ███╗ ██╗ ████████╗
████╗ ██║ ██╔══██╗ ████╗ ██║ ██╔═══██╗ ██╔══██╗ ██╔════╝ ██╔════╝ ████╗ ██║ ╚══██╔══╝
██╔██╗ ██║ ███████║ ██╔██╗ ██║ ██║ ██║ ███████║ ██║ ███╗ █████╗ ██╔██╗ ██║ ██║
██║╚██╗██║ ██╔══██║ ██║╚██╗██║ ██║ ██║ ██╔══██║ ██║ ██║ ██╔══╝ ██║╚██╗██║ ██║
██║ ╚████║ ██║ ██║ ██║ ╚████║ ╚██████╔╝ ██║ ██║ ╚██████╔╝ ███████╗ ██║ ╚████║ ██║
╚═╝ ╚═══╝ ╚═╝ ╚═╝ ╚═╝ ╚═══╝ ╚═════╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝ ╚═╝ ╚═══╝ ╚═╝
Ship code with an
AI teammate for your repo
Inspect code, plan changes, make focused edits, run validations, and review pull requests from a desktop app or the nanoai CLI — without giving up approval-first control.
Not just chat — real work.
Desktop app + terminal CLI
Work visually in the desktop app or stay keyboard-first with the nanoai CLI. Same agent, same workspace, your choice.
Codebase indexing & search
Builds .nanoagent/cache/codebase-index.json for fast repo understanding. Search by concept, symbol, path, or behavior. Indexes incrementally and respects .gitignore / .nanoignore.
You stay in control
Sensitive actions like file edits, command execution, network access, MCP tools, memory writes, and elevated operations are controlled by profiles, permissions, and approval prompts.
Team memory & repo docs
Reviewable memory files live in your repo: architecture.md, conventions.md, decisions.md, known-issues.md, test-strategy.md. Commit them, review them in PRs, keep your whole team aligned.
Budget controls
Set spending limits for local or cloud mode. Prevent runaway API costs with /budget, /budget local, /budget cloud, and /budget status.
Workspaces & sections
The desktop app organizes work into local workspaces with saved sections — separate contexts for features, bug fixes, reviews, and planning. Each section has its own conversation history, plan, and file context.
Multiple working modes
Switch between build, plan, review, general, and explore profiles for implementation, read-only planning, code review, delegated work, or quick investigation.
Built-in PR/MR review automation
Use NanoAgent in GitHub Actions, GitLab CI, or Bitbucket Pipelines to review diffs and post review comments automatically.
Editor integration through ACP
Run NanoAgent as an Agent Client Protocol server so compatible editors and workflow tools can send prompts, manage sessions, and receive tool progress updates.
Undo and redo for tracked edits
Roll back or re-apply tracked file edit transactions directly from desktop controls or terminal commands.
Custom agents and skills
Add project-specific instructions, reusable skills, custom subagents, custom tools, and MCP servers to adapt NanoAgent to your workflow.
Local-first workspace
Workspace files, configuration, lesson memory, and optional audit logs are stored locally. Only needed prompts, snippets, tool outputs, and context are sent to the chosen model provider.
Permission policies & sandboxing
Actions can be allowed, denied, or require approval, with sandbox modes like read-only, workspace-write, and full-access when explicitly configured.
Secret redaction and safer logs
NanoAgent redacts common secret patterns before storing or displaying tool output, memory, audit records, logs, conversation history, workspace instructions, and errors. Your tokens and keys stay out of your history. Codebase indexing never stores full file contents — it reads snippets from current workspace files and respects .gitignore / .nanoignore exclusion rules.
Beyond interactive mode — one-shot commands, piped input, and session resume.
nanoai "Summarize this repository"cat error.log | nanoai --stdin "What caused this?"nanoai --section feature-auth "Continue the JWT refactor"Hooks, delegation, custom tools — make NanoAgent yours.
Subagent delegation & orchestration
Built-in and project-defined subagents handle specialized tasks. Use @explore for investigation, @general for delegated work, or agent_delegate / agent_orchestrate for multi-step coordination.
Custom process tools
Expose user-defined tools from agent-profile.json. Write tools in any language — just read JSON from stdin, output text or JSON. Python, Bash, Go, Rust, whatever your team uses.
Lifecycle hooks
Automate around every phase of agent execution. Hooks fire on task, tool, file, shell, web, memory, permission, and delegation lifecycle events — for custom validation, logging, security gates, or workflow automation.
Custom agents, skills & MCP servers
Add project-specific instructions, reusable skills, custom subagents, and connect MCP servers for external tools and data sources — all governed by the same permission and approval system. Adapt NanoAgent to your team's workflow, not the other way around.
Feature comparison across AI coding agents.
✅ = supported · — = not verified as first-class feature
curl -fsSL https://raw.githubusercontent.com/rizwan3d/NanoAgent/master/scripts/install.sh | bashirm https://raw.githubusercontent.com/rizwan3d/NanoAgent/master/scripts/install.ps1 | iexRestart your shell if nanoai is not immediately available.
Pre-built desktop applications for every platform.
Ready to meet your
AI teammate?
Stop context-switching. Start building. NanoAgent keeps you in the flow state.