explaingit

tickernelz/opencode-mem

Analysis updated 2026-05-18

711TypeScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

TLDR

A plugin that gives AI coding assistants persistent memory of your projects and preferences using a local database on your machine.

Mindmap

mindmap
  root((OpenCode Memory))
    What it does
      Remembers project context
      Learns user profile
      Local vector search
    Tech stack
      TypeScript
      SQLite
      USearch
    Use cases
      Recall past decisions
      Browse memories in web UI
      Auto capture context
    Audience
      Vibe coders
      Developers
      OpenCode 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

Let your AI coding assistant remember project architecture and past decisions between sessions.

USE CASE 2

Build an automatic profile of your coding preferences that the assistant reuses over time.

USE CASE 3

Browse and search everything the assistant has remembered through a local web dashboard.

What is it built with?

TypeScriptSQLiteUSearchOpenCode

How does it compare?

tickernelz/opencode-memaffaan-m/agentshieldindalok/rzweb
Stars711719723
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasyeasy
Complexity2/53/53/5
Audiencevibe coderdeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Installs with a single config line and downloads automatically on next OpenCode startup.

MIT license, so you can use, modify, and redistribute it freely, including commercially, as long as you keep the copyright notice.

In plain English

OpenCode Memory is a plugin for OpenCode, a coding agent tool, that gives AI coding assistants a persistent memory across sessions. Normally an AI assistant forgets everything once a conversation ends, but this plugin stores facts, decisions, and context in a local vector database on your own machine, so the assistant can recall past project details and your personal preferences the next time you work together. The plugin uses SQLite as its underlying data store, paired with a vector search library called USearch for fast lookups, and falls back to a simpler exact search method if USearch is not available. It automatically learns a profile of the user over time, keeps a combined timeline of memories and prompts, and includes a full web interface for browsing and managing what has been remembered. It also tries to avoid storing duplicate information and includes some built in privacy protections. To install it, you add opencode-mem to your OpenCode configuration file, and it downloads automatically the next time OpenCode starts. Once running, you can add memories, search past memories by keyword, view your learned profile, or list recent entries, either through simple commands or through the local web dashboard, which runs on port 4747 by default. For automatic memory capture, the plugin can use whatever AI provider you already have set up inside OpenCode, including Claude Pro or Max through OAuth, GitHub Copilot, or direct API keys, so you generally do not need to configure a separate key just for this plugin. There is also a manual fallback option if you prefer to point it at a specific provider like OpenAI directly. Settings such as storage location, memory limits, and how many past memories get injected into a new chat are all configurable in a separate settings file. The project is written in TypeScript, is open to contributions, and is released under the MIT license. It says it was inspired by an earlier project called opencode-supermemory.

Copy-paste prompts

Prompt 1
Explain how OpenCode Memory stores and retrieves my project context between sessions.
Prompt 2
Walk me through installing opencode-mem in my OpenCode configuration file.
Prompt 3
How do I search my stored memories using the web interface on port 4747?
Prompt 4
What AI providers can OpenCode Memory use for automatic memory capture?

Frequently asked questions

What is opencode-mem?

A plugin that gives AI coding assistants persistent memory of your projects and preferences using a local database on your machine.

What language is opencode-mem written in?

Mainly TypeScript. The stack also includes TypeScript, SQLite, USearch.

What license does opencode-mem use?

MIT license, so you can use, modify, and redistribute it freely, including commercially, as long as you keep the copyright notice.

How hard is opencode-mem to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is opencode-mem for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.