# LocalPilot

> LocalPilot is a free, open-source coding agent for VS Code that runs on local models from Ollama, LM Studio, llama.cpp or vLLM, and can install a model for you in one click. Agent mode, parallel agents, skills, subagents, screenshots, MCP and hardware-aware model management, with no subscription, account or telemetry. A private, offline alternative to GitHub Copilot, Cursor and Claude Code.

LocalPilot is a free, MIT-licensed Visual Studio Code extension (`localpilot.localpilot-agent`, version 1.1.1). It is a complete coding agent — agent / ask / plan modes, parallel agents with change review, skills and subagents, @-mentions and workspace context, screenshots and vision models, inline completions and MCP servers — that runs entirely against local model servers such as Ollama, LM Studio, llama.cpp, vLLM and Docker Model Runner (or any OpenAI-compatible endpoint). It can set models up by itself: with no model found it installs or starts Ollama and downloads a smallest-first starter set sized to the machine's RAM/GPU; a model manager shows what fits, enables/disables/removes installed models and installs from a curated catalog; automatic routing sends image turns to a vision model, completions to the smallest FIM model and falls back when a model is offline. No account, no telemetry, no code leaves the machine unless the user configures a remote endpoint. It is a private, offline alternative to GitHub Copilot, Cursor and Claude Code. It also reuses existing CLAUDE.md, AGENTS.md, .cursorrules, .cursor/rules, .claude/skills, .claude/agents and .github/copilot-instructions.md files.

Install: VS Code Marketplace https://marketplace.visualstudio.com/items?itemName=localpilot.localpilot-agent or `code --install-extension localpilot.localpilot-agent`. VSIX downloads: https://github.com/isathish/localpilot/releases. Source: https://github.com/isathish/localpilot. Author: Sathishkumar Nagarajan (https://github.com/isathish).

## Documentation
- [Getting started](https://isathish.github.io/localpilot/docs/getting-started/): Install LocalPilot, connect a local model server and run your first agent task in under five minutes.
- [Features](https://isathish.github.io/localpilot/docs/features/): A tour of everything LocalPilot can do.
- [Models & providers](https://isathish.github.io/localpilot/docs/models/): One-click model setup sized to your hardware, a model manager with catalog, enable/disable and remove, automatic per-task routing, and auto-detected providers — Ollama, LM Studio, llama.cpp, vLLM, Docker Model Runner or any OpenAI-compatible endpoint.
- [Agent, Ask & Plan](https://isathish.github.io/localpilot/docs/agent-modes/): The three interaction modes and how approvals keep you in control.
- [Parallel agents & changes](https://isathish.github.io/localpilot/docs/parallel-agents/): Run many agents at once, watch them in the Agents panel, and keep or undo what each one did.
- [Skills & subagents](https://isathish.github.io/localpilot/docs/skills-and-agents/): Package expertise as reusable skills and delegate work to specialised subagents.
- [Memory & planning](https://isathish.github.io/localpilot/docs/memory-and-planning/): How LocalPilot remembers across sessions, plans multi-step work with a live checklist, caches tool results, and runs from your terminal.
- [Terminal & CLI](https://isathish.github.io/localpilot/docs/terminal-and-cli/): Watch the agent run commands in a branded VS Code terminal, hand terminal output to the chat, and run the full LocalPilot agent from any shell with the `localpilot` CLI.
- [Context & mentions](https://isathish.github.io/localpilot/docs/context/): How LocalPilot fits large tasks into small context windows, and how to attach exactly the context you want.
- [Screenshots & images](https://isathish.github.io/localpilot/docs/images/): Show the model what you see — capture a region, paste or drop an image, screenshot a web page or local dev server headlessly, open URLs in a browser view inside VS Code, and let a vision model work on it.
- [MCP servers](https://isathish.github.io/localpilot/docs/mcp/): Extend the agent with any Model Context Protocol server.
- [Configuration](https://isathish.github.io/localpilot/docs/configuration/): Every LocalPilot setting, with defaults.
- [Keyboard shortcuts](https://isathish.github.io/localpilot/docs/shortcuts/): Default keybindings (rebind them under Preferences → Keyboard Shortcuts).
- [Troubleshooting](https://isathish.github.io/localpilot/docs/troubleshooting/): Common problems and fixes.
- [Development](https://isathish.github.io/localpilot/docs/development/): Build LocalPilot from source, run the tests, and contribute.
- [Publishing](https://isathish.github.io/localpilot/docs/publishing/): One-time publisher setup and the two supported publish paths (CI or local).

## Guides
- [Ollama in VS Code](https://isathish.github.io/localpilot/guides/ollama-vscode/): Turn Ollama into a Copilot-style agent inside VS Code with LocalPilot — tool calling, file edits, terminal commands, parallel agents and screenshots, all offline.
- [LM Studio in VS Code](https://isathish.github.io/localpilot/guides/lm-studio-vscode/): Connect LM Studio's local server to VS Code with LocalPilot and get an agent that edits files, runs commands and reviews changes — using the GGUF or MLX models you already downloaded.
- [GitHub Copilot alternative](https://isathish.github.io/localpilot/guides/github-copilot-alternative/): LocalPilot is a free GitHub Copilot and Cursor alternative for VS Code that runs entirely on your hardware with Ollama, LM Studio, llama.cpp or vLLM — agent mode, parallel agents, skills, screenshots and MCP without a subscription.
- [Offline AI coding assistant](https://isathish.github.io/localpilot/guides/offline-ai-coding-assistant/): How to run a fully offline AI coding assistant in VS Code with LocalPilot — no internet, no accounts, no telemetry. Works on air-gapped machines and in regulated environments.

## Optional
- [Home page](https://isathish.github.io/localpilot/): landing page with feature overview, comparison table and FAQ
- [Changelog](https://github.com/isathish/localpilot/blob/main/CHANGELOG.md): release notes
- [README](https://github.com/isathish/localpilot#readme): repository overview
- [Markdown sources](https://github.com/isathish/localpilot/tree/main/docs): every documentation page is available as Markdown under docs/