🚂 localcode

The blazingly fast, air-gapped, zero-bloat coding assistant.

localcode is a local-first coding assistant designed to give you the multi-file editing capabilities of tools like Claude Code or OpenCode, but with the instantaneous latency of native hardware inference. Built for 24GB+ machines (like the Mac Mini M4), localcode uses a "Dumb Bridge" architecture to keep your model's KV Cache hot and prefill times near zero.

No vector databases. No API keys. No hidden "agentic" tool-calling loops. Just you, your files, and raw local inference.

⚡ Why localcode?

Modern AI coding agents are slow. They inject massive tool schemas into the context window, execute hidden bash commands, and degrade your local model's Key-Value (KV) cache.

localcode solves this by shifting the burden of file-system navigation from the AI back to the application.

• Static System Prompts: localcode never changes its system prompt, meaning Ollama caches the prefix perfectly. Prefill time drops from 10+ seconds to milliseconds.
• Explicit Context: You declare exactly which files matter. localcode injects them directly.
• Streaming Search & Replace: localcode intercepts <<<< ==== >>>> diff blocks in real-time as they stream from Ollama and patches your codebase instantly.

⚡ Why localcode?

Modern AI coding agents are slow. They inject massive tool schemas into the context window, execute hidden bash commands, and degrade your local model's Key-Value (KV) cache.

localcode solves this by shifting the burden of file-system navigation from the AI back to the application.

• Static System Prompts: localcode never changes its system prompt, meaning Ollama caches the prefix perfectly. Prefill time drops from 10+ seconds to milliseconds.
• Explicit Context: You declare exactly which files matter. localcode injects them directly.
• Streaming Search & Replace: localcode intercepts <<<< ==== >>>> diff blocks in real-time as they stream from Ollama and patches your codebase instantly.

🚀 Features

• 100% Air-Gapped: Your proprietary enterprise code never leaves your localhost.
• Zero Agentic Bloat: No LangChain, no heavy embeddings, no background indexers.
• Multi-File Context: Edit a controller and its corresponding route in the exact same prompt.
• Dual Modes: Run an interactive TUI for complex reviews, or a headless background daemon (localcode serve) for instant IDE integrations.

🚀 Features

• 100% Air-Gapped: Your proprietary enterprise code never leaves your localhost.
• Zero Agentic Bloat: No LangChain, no heavy embeddings, no background indexers.
• Multi-File Context: Edit a controller and its corresponding route in the exact same prompt.
• Dual Modes: Run an interactive TUI for complex reviews, or a headless background daemon (localcode serve) for instant IDE integrations.

Installation

To install localcode, follow these steps:

1. Clone the repository:

   git clone https://github.com/tuanhuydev/localcode.git

2. Navigate to the project directory:

   cd localcode

3. Install the dependencies:

   pnpm install

4. Build the project:

   pnpm build

5. Run the application:

   pnpm start

Usage

To use localcode, you can run the following commands:

• Start the interactive TUI:

  localcode

• Start the headless background daemon:

  localcode serve

License

This project is licensed under the MIT License. See the LICENSE file for more information.

Contact

For any questions or support, please open an issue on the GitHub repository.