v4.0.0 — 139 agents · 362 tests · MIT open source

AI-powered coding agent
that you actually own

Localcode runs locally with Ollama — your code never leaves your machine. 139 specialized agents, multi-agent orchestration, 10 built-in tools, and a comprehensive test suite. No subscriptions. No cloud lock-in. No telemetry unless you opt in.

npm install -g @localcode/cli
curl -fsSL https://localcode.dev/install.sh | bash
139
Agents
4
Providers
60+
Commands
100%
Free w/ Ollama
localcode
139 specialized agentsMulti-agent orchestration (NEXUS pipeline)100% offline with OllamaMulti-provider — Ollama · OpenAI · Anthropic · Groq60+ slash commandsVS Code extension with chat, agents, session viewsAuto-dispatch agents based on task contextPlugin system — drop .js in ~/.localcode/plugins/Hooks — PreToolUse · PostToolUse · NotificationMemory files — .localcode.md global + projectMCP servers — stdio + HTTP4 built-in themesBudget guard with auto-fallback to localSafe mode with git stash protectionMIT License — fork it, own it 139 specialized agentsMulti-agent orchestration (NEXUS pipeline)100% offline with OllamaMulti-provider — Ollama · OpenAI · Anthropic · Groq60+ slash commandsVS Code extension with chat, agents, session viewsAuto-dispatch agents based on task contextPlugin system — drop .js in ~/.localcode/plugins/Hooks — PreToolUse · PostToolUse · NotificationMemory files — .localcode.md global + projectMCP servers — stdio + HTTP4 built-in themesBudget guard with auto-fallback to localSafe mode with git stash protectionMIT License — fork it, own it

Everything you need. Nothing you don't.

Built for developers who want a coding assistant that works locally, respects privacy, and actually gets the job done.

Core

100% local with Ollama

Run any Ollama model. No API key. No cloud. Your code stays on your machine. Free forever.

Free forever
New🤖

139 specialized agents

From AI engineers to security auditors, database optimizers to DevOps automators. Each with deep domain expertise.

Auto-dispatch
New🌐

Multi-agent orchestration

NEXUS pipeline coordinates multiple agents through 7 phases with quality gates, Dev↔QA loops, and parallel execution.

NEXUS
🔒

You're in control

Permission prompts before every write. Budget limits. Safe mode with git stash. Rate limiting. Telemetry opt-in only.

Privacy-first

362 tests, CI/CD

Comprehensive test suite with 100% pass rate. Every critical path covered. Automated CI on every commit.

Battle-tested

Multi-provider

Ollama, OpenAI, Anthropic, Groq. Switch mid-session. Budget guard auto-falls back to local when limits hit.

Flexibility

Built different. By design.

Cloud coding assistants lock you in. Localcode gives you everything they have — plus the things that matter for serious developers.

Feature
Localcode
Cloud Assistants
Fully local / offline
✓ Free with Ollama
✗ Always cloud
Multi-provider support
✓ 4 providers
✗ One provider only
Switch provider live
✓ /provider cmd
Open source (MIT)
✓ Full source
✗ Proprietary
Specialized agents
✓ 139 agents
Multi-agent orchestration
✓ NEXUS pipeline
Plugin system
✓ Drop .js files
Test suite
✓ 362 tests
✗ Unknown
Telemetry
✓ Opt-in only
✗ Always on
Free to use
✓ With Ollama
✗ Subscription

Your code never leaves your machine

With Ollama, everything runs locally. No API calls, no cloud processing, no data collection. Your proprietary code, your business logic, your secrets — all stay on your machine.

No vendor lock-in

Switch between Ollama, OpenAI, Anthropic, and Groq mid-session. Budget guard automatically falls back to local when you hit spending limits. You're never trapped with one provider.

139 agents, zero manual switching

Describe what you need — Localcode automatically dispatches the right agents. Security engineer for vulnerabilities, database optimizer for slow queries, DevOps automator for CI/CD. All automatic.

Open source, MIT licensed

Every line of code is auditable. Fork it, modify it, distribute it. No hidden telemetry, no surprise charges, no terms of service changes. It's yours.

Built with comprehensive tests

Every critical path is tested. Tool execution, provider clients, session management, settings, MCP, agent spawning, orchestration, file locking, rate limiting, security checks. 100% pass rate.

Privacy-first by default

Telemetry is opt-in. No crash reporting without consent. No usage tracking. No analytics. When you use Localcode with Ollama, literally nothing leaves your machine.

362 tests. 100% pass rate. Every critical path covered.

We don't ship untested code. Every feature has tests. Every edge case is covered. CI runs on every commit.

362
Tests

Comprehensive test suite across 12 test files covering every critical path in the codebase.

100%
Pass Rate

Every test passes. CI runs automatically on every commit across Node 18, 20, and 22.

12
Test Files

Organized by module: tool executor, provider client, session manager, settings, MCP, agents, and more.

CI/CD
Automated

Every commit triggers builds, type checks, and tests. VS Code extension packaged automatically.

What's Tested

Tool Executor

File read/write/patch/delete/move, shell commands with security checks, directory listing, search, find, git operations, path traversal prevention, blocked command enforcement.

Provider Client

Streaming responses, retry with exponential backoff, cost estimation for all providers, model routing (planning/execution/review), abort signal handling.

Session Manager

Session CRUD, checkpoint creation/restoration, session history, token estimation accuracy, state persistence, corrupt state handling.

Settings Manager

Load/save settings, deep merge, validation, migration system (v1→v2), caching, corrupt file handling, dot-path access.

MCP Manager

Connection management, auto-reconnect with backoff, health checks, tool definitions, tool call routing, graceful shutdown.

Agent System

Agent spawning with independent tool executors, cancellation, timeout handling, parallel execution, orchestration with quality gates, auto-dispatch keyword matching.

File Locking

Lock acquisition/release, concurrent access prevention, stale lock detection, timeout handling, cleanup.

Plugin System

Plugin loading, security validation (blocks eval, child_process, fs, net, http, Function constructor), 30-second execution timeout.

Core Types & Constants

Provider configurations, theme system, persona definitions, slash commands (60+), approval modes, spinner frames.

Utilities

String operations, array methods, object manipulation, JSON parsing/stringification, error handling, date/time, math, regex, async utilities.

139 specialized agents

Each agent brings deep domain expertise. Auto-dispatched based on your task context — no manual switching.

💻 Engineering

AI EngineerSenior DeveloperSoftware ArchitectBackend ArchitectFrontend DeveloperDatabase OptimizerAPI DesignerCode ReviewerGit Workflow Master+ 21 more

🧪 Testing

API TesterTest Results AnalyzerReality CheckerTest-Driven Developer+ 6 more

🔒 Security

Security EngineerThreat DetectionCompliance AuditorBlockchain Security+ 4 more

⚙️ DevOps

DevOps AutomatorSREInfrastructure MaintainerCloud Architect+ 6 more

Get Localcode

Open source. Local-first. 139 agents. 362 tests. Ready in 30 seconds.

npm install -g @localcode/cli