01
Five-role agent pipeline
Planner, Tool Manager, Coder, Auditor, and Verifier — each with a distinct job and fallback chain. Not a single prompt wearing a costume.
v4 NPMAI Ecosystem · Free & open source
Plain English
into things done.
NPM-AutoCode-AI is a desktop agent that plans your task, writes real code, audits it for safety, runs it on your machine, and verifies the result — a five-role loop, not a chat window pretending to be one.
0+
Downloads
1,371
Tools
Free
Forever
45+
LLMs
01
PlannerBreaks the task into ordered, atomic steps
02
Tool ManagerSelects from 1,371 verified tools
03
CoderWrites real Python for each step
04
AuditorReviews before anything runs — block or allow
05
VerifierConfirms the task actually completed
Live instrument
Same UI as the desktop app.
This demo mirrors the real Agent page — sidebar, stage stepper, status card, execution log, Configure LLMs, and MCP link. Pick a task chip and press Run.
Agent
Describe a task. It plans, codes, audits, runs and verifies.
● Ready
○
Planner
○
Tool manager
○
Coder
○
Auditor
○
Verifier
Agent
Ready. Describe a task below.
Execution log
Configure LLMs
In the real desktop app this dialog assigns a provider and model to each stage (Planner, Tool manager, Coder, Auditor, Verifier, Chatter). Settings are saved locally. This website demo only simulates the UI.
Get your MCP Link
Login is only needed for the MCP link — chat and tasks never require it. In the real app you sign in once, receive a personal URL, and paste it into Claude or Grok connector settings.
Capabilities
Built like an instrument.
Priced like open source.
Everything a serious coding agent should do — on your machine, behind a calm desktop UI, with no mandatory API key and no cloud lock-in.
02
Independent security audit
Every generated script is reviewed by a separate Auditor role before execution, plus a second non-LLM safety check.
03
Auto-debug loop
If execution fails, the agent captures the error, feeds it back to the Coder, and retries — up to twelve times per step.
04
Workspace awareness
On first run it can scan Desktop, Downloads, Documents, Pictures, Videos, and Music — so it already knows your folders.
05
MCP link, not an API key
Connect Claude or Grok from the sidebar. Login happens once for the link only; the rest of the app can stay account-free.
06
Real subprocess execution
Code runs as an actual child process — not a hidden eval. Output streams live. Kill any script mid-run.
MCP architecture
Claude or Grok as the brain.
Your desktop as the hands.
NPM-AutoCode-AI hosts an MCP endpoint. Link it once from the app, paste the URL into Claude (claude.com) or Grok (grok.com) connector settings, and the model you already use plans and writes — while this app executes locally. No extra API key. Your files never leave your machine for execution.
Local
Your desktop
Runs code, reads folders, holds credentials. Execution stays on your hardware.
Relay
MCP server
Carries jobs and results. Does not run your scripts or store your workspace.
Model
Claude / Grok
Thinks, plans, and reviews using the chat you already open every day.
01
Get your link
Sign in once from the app MCP flow. A personal token is issued for your account.
02
Paste into connector
Add the link under Claude or Grok custom connector settings.
03
Ask in plain language
Clear my Downloads — the model routes the job through your link automatically.
04
Audited before run
Scripts pass Auditor review and a safety check before any local process starts.
05
Runs on your machine
Local subprocess only. The MCP path relays code and results — not your disk.
06
Verified, not assumed
Verifier checks actual outcome against the task — not just a zero exit code.
Tool registry
1,371 tools. Zero wiring.
Git, GitHub, Docker, AWS, Stripe, Notion, FFmpeg, image pipelines, email, SSH, and more — available the moment you install. Describe the task; the Tool Manager selects what each step needs.
GitTool · commit · branch · rebaseGitHubTool · issues · PRs · releasesDockerTool · build · compose · registryAWSS3Tool · buckets · presigned URLsStripeTool · payments · invoicesSMTPAdvancedTool · HTML · attachmentsNotionAdvancedTool · pages · databasesTwilioTool · SMS · voice · WhatsApp
GitTool · commit · branch · rebaseGitHubTool · issues · PRs · releasesDockerTool · build · compose · registryAWSS3Tool · buckets · presigned URLsStripeTool · payments · invoicesSMTPAdvancedTool · HTML · attachmentsNotionAdvancedTool · pages · databasesTwilioTool · SMS · voice · WhatsApp
TerminalTool · commands · pipesPackageManagerTool · npm · pip · cargoFFmpegTool · convert · compress · trimImageAdvancedTool · resize · batch editSpeechAITool · transcribe · diarizeComputerVisionTool · detect · OCRDebuggerTool · breakpoints · stacksVSCodeTool · open · edit · extensions
TerminalTool · commands · pipesPackageManagerTool · npm · pip · cargoFFmpegTool · convert · compress · trimImageAdvancedTool · resize · batch editSpeechAITool · transcribe · diarizeComputerVisionTool · detect · OCRDebuggerTool · breakpoints · stacksVSCodeTool · open · edit · extensions
Agent architecture
How the agent thinks
Every task moves through these stages in order. Each stage is a dedicated role — so planning stays separate from coding, coding stays separate from safety review, and verification is never optional.
01
Scan
Reads workspace context before anything else.
02
Plan
Breaks the request into ordered atomic steps.
03
Select
Picks exact tools each step requires.
04
Generate
Writes real Python for every step.
05
Audit
Block or allow — before a process starts.
06
Execute
Real subprocess. Stream live. Kill anytime.
07
Verify
Confirms the outcome matches the task.
The builder
Meet the founder
Sonu Kumar — Bihar, India
Sonu Kumar
Founder · NPMAI ECOSYSTEM · Bihar Viral Boy
Age 15Bihar, IndiaKota, Rajasthan
434K+ followersTEDx speakerAllen 100% scholar
4M+npmai downloads
900K+npmai_agents
434K+Followers
TEDxSpeaker at 13
100%Allen scholarship
10Research papers
Age 9
Teaching nursery kids
While in 4th grade — early focus on education equity.
Age 11 — Bihar Viral Boy
Challenged the state’s priorities
Raised education and liquor-ban issues; went viral nationally.
Age 13
TEDx speaker
Among India’s youngest — rural education and the tech divide.
Age 13–15
Founded NPMAI ECOSYSTEM
Self-taught, no formal CS path. Built on free cloud infrastructure.
2026
Ten research papers
AI, chemistry, mathematics, and constitutional science.
Get started
Download free. Run locally.
No API keys required to start. No local GPU required. Unzip and launch — on first run the agent can learn your workspace before you type a task.
1
Download ZIP
2
Unzip folder
3
Run the app
4
Start automating
Windows · Linux · macOS · Free forever · Open source · NPMAI Ecosystem
57,000+ downloads — measured via LLM requests on the npmai_LLM server.