explaingit

awesamarth/pi-supermemory

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A memory add-on for the Pi coding agent that lets it remember project facts and preferences across sessions using a local or hosted Supermemory server.

Mindmap

mindmap
  root((pi-supermemory))
    What it does
      Recalls past sessions
      Auto captures facts
      Redacts private data
    Tech stack
      TypeScript
      Pi agent
      Supermemory Local
    Use cases
      Remember test commands
      Save team decisions
      Search past notes
    Audience
      Developers
      Pi users
      AI tool builders

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

Keep an AI coding agent aware of project conventions like test commands across separate sessions

USE CASE 2

Automatically save decisions, bug fixes, and setup notes mentioned during a coding conversation

USE CASE 3

Search or recall earlier notes about a project without re-explaining context each time

USE CASE 4

Redact secrets before they are stored in the memory database

What is it built with?

TypeScriptPiSupermemoryBun

How does it compare?

awesamarth/pi-supermemory0xradioac7iv/tempfs52191314/web-agent-proxy-sdk
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires running a separate Supermemory Local server, which itself needs an OpenAI key or a local model endpoint.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

pi-supermemory adds persistent memory to Pi, a coding agent. Normally an AI coding assistant forgets everything once your session ends. This package changes that by connecting Pi to a memory system called Supermemory, so it can recall things it learned in earlier sessions, like which test command your project uses or a decision you made about how a feature should work. By default the memory database lives on your own computer through a local server called Supermemory Local, so nothing is sent to an outside service unless you choose to use hosted Supermemory instead. Before Pi responds to you, it quietly checks this memory for anything relevant and adds it to its context. After a useful conversation, it automatically saves durable facts such as preferences, bug fixes, and setup notes, based on keywords like remember, decision, bug, and fix appearing in the conversation. You can also manage memory directly with commands inside Pi, such as saving a note, searching past memories, checking your saved profile, or telling it to forget something. Plain language works too: you can simply say things like remember that this repo uses Bun, and it will store that. Memory is split into two separate scopes: one tied to you as a user, and one tied to the specific project you are working in, so personal preferences do not leak between unrelated codebases. There is also a privacy feature that redacts anything wrapped in private tags before it gets stored, so secrets like API keys typed into a conversation are not saved in plain text. Setup involves installing the Pi package, then running the separate Supermemory Local server, which itself needs an OpenAI key or a local model to do its own summarizing work behind the scenes. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through installing pi-supermemory and starting Supermemory Local on my machine
Prompt 2
Show me how to configure pi-supermemory to use a local Ollama model instead of OpenAI for memory extraction
Prompt 3
Explain the difference between the user memory scope and the project memory scope in pi-supermemory
Prompt 4
Write a supermemory.json config that raises maxMemories to 10 and adds a custom signal keyword

Frequently asked questions

What is pi-supermemory?

A memory add-on for the Pi coding agent that lets it remember project facts and preferences across sessions using a local or hosted Supermemory server.

What language is pi-supermemory written in?

Mainly TypeScript. The stack also includes TypeScript, Pi, Supermemory.

What license does pi-supermemory use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is pi-supermemory to set up?

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

Who is pi-supermemory for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.