Heap Code

Model-agnostic AI coding assistant for VS Code. Works with any OpenAI-compatible API — local (Ollama, LM Studio, vLLM, LocalAI) or cloud (OpenAI, OpenRouter, Groq, Together, Azure OpenAI, NVIDIA NIM).

Privacy

Your code never leaves your machine except to the endpoint you configure. No telemetry, no proprietary backend, no account. Point it at Ollama on your LAN and everything stays home. API keys live in your OS keychain, never in settings files.

Quick start

Open the Heap Code icon in the activity bar.
Click the ⚙ gear in the chat header → add a provider profile (Ollama works out of the box at http://localhost:11434/v1).
Pick a model, chat. Switch to Agent mode for autonomous multi-file tasks.

Features

Chat — streaming markdown; history; slash commands (/explain, /fix, /review…); @selection @file @problems @terminal @workspace mentions; attach files, folders, or a line-range selection; paste screenshots for vision models; code-block Copy / Insert / Apply
Agent mode — plans, then reads, searches, edits files and runs commands autonomously; language-server tools (symbols, references, definitions); every non-read action behind permission prompts; per-file Keep / Revert / Reapply and per-turn workspace restore; a 🔧 picker chooses which tools it may use
Completions — ghost text with proper FIM formats per model family (Qwen, DeepSeek, StarCoder, CodeLlama, Codestral, CodeGemma), native Ollama FIM, debounced + cancellable
Inline edit — select code, Ctrl+I/Cmd+I, describe the change, review in a native diff, accept from its title bar
Semantic search (RAG) — background incremental index with your embeddings model, LLM-reranked retrieval; powers @workspace and the agent's search
Context management — usage meter with auto-detected model context windows; automatic conversation compaction; edit any earlier prompt to rewind conversation and workspace
MCP — register Model Context Protocol servers (stdio / HTTP / SSE); their tools join agent mode under the same permissions
Project memory — HEAPCODE.md + .heapcode/memory.md load into every session
Git — commit-message generation from the staged diff (✨ in Source Control)

Provider profiles

Named profiles with per-role models — chat, edit, apply, autocomplete, agent, embeddings, rerank — managed in the in-chat settings panel or via the status bar. Capabilities (vision, tool calling, context window) resolve per preset and per model, with per-profile overrides.

License

Apache-2.0. Source: github.com/siddharth7631/heapcode