whatisgithub

What is heapcode?

heaplabshq/heapcode — explained in plain English

Analysis updated 2026-05-18

3TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A VS Code AI coding assistant that connects to almost any AI model, local or cloud, offering chat, autocomplete, inline edits, and an autonomous coding agent.

Mindmap

mindmap
  root((Heap Code))
    What it does
      AI coding assistant
      Chat and edits
      Autonomous agent
      Semantic search
    Tech stack
      TypeScript
      React
      VS Code API
    Providers
      Local Ollama
      OpenAI
      Azure OpenAI
      OpenRouter
    Use cases
      Private local AI
      Multi provider switching
      Codebase search
    Audience
      Developers
      Privacy focused users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Set up a private local AI coding assistant using Ollama that never sends code to the cloud.

USE CASE 2

Use one extension with multiple AI providers by switching profiles from the status bar.

USE CASE 3

Add an autonomous agent that reads, edits, and runs commands in your project with permission prompts.

USE CASE 4

Search your codebase semantically so AI answers are grounded in your own files.

What is it built with?

TypeScriptReactpnpmVS Code API

How does it compare?

heaplabshq/heapcode000madz000/payload-test-api-route-handlerakash-sr/memobsidian
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires building from source with pnpm and F5 in VS Code, or installing a packaged .vsix, plus configuring an AI provider.

Free to use, modify, and share for any noncommercial purpose, but you cannot sell it or run it as a paid service.

So what is it?

Heap Code is a coding assistant built for VS Code that works with almost any AI model provider, whether that is a cloud service like OpenAI, Azure, OpenRouter, Groq, or Together AI, or a model you run yourself with tools like Ollama, LM Studio, vLLM, or LocalAI. Instead of locking you into one company's AI, it lets you set up named profiles for different providers and switch between them from the status bar, choosing separate models for chat, code editing, autocompletion, the autonomous agent, and search. The tool offers a chat panel with syntax highlighted code and slash commands such as /explain, /fix, and /review, plus the ability to reference your current file, selection, or the whole workspace in a question. It also provides ghost text completions as you type, an inline edit mode where you select code and describe a change, and an agent mode that can read, search, and edit files or run commands on its own. Every non read action asks for permission first, and a one click Revert all option restores every file the agent touched. For understanding a codebase, Heap Code builds a semantic search index using an embeddings model, combining it with plain keyword search so it can find relevant code even without a heavy AI model behind it. It supports the Model Context Protocol so extra tools from other servers can be added, and it reads project notes and instructions the same way Claude Code does, so any memory files already written for other AI tools can be reused. Because your code only leaves your machine to reach whichever model endpoint you configure, it is possible to run entirely offline with local models like Ollama and keep everything private, though the extension does collect anonymous usage telemetry by default that can be turned off in settings. The project is licensed under PolyForm Noncommercial 1.0.0, which means it is free for personal, research, and internal use but cannot be sold or offered as a paid hosted service. Earlier versions before 0.2.0 remain available under Apache-2.0.

Copy-paste prompts

Prompt 1
Help me configure a local Ollama profile in Heap Code with separate models for chat and completions.
Prompt 2
Explain how Heap Code's agent mode permission system works and how to enable it safely.
Prompt 3
Show me how to set up a .heapcode/HEAPCODE.md memory file for my project.
Prompt 4
Walk me through building the Heap Code VS Code extension from source with pnpm.

Frequently asked questions

What is heapcode?

A VS Code AI coding assistant that connects to almost any AI model, local or cloud, offering chat, autocomplete, inline edits, and an autonomous coding agent.

What language is heapcode written in?

Mainly TypeScript. The stack also includes TypeScript, React, pnpm.

What license does heapcode use?

Free to use, modify, and share for any noncommercial purpose, but you cannot sell it or run it as a paid service.

How hard is heapcode to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is heapcode for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.