hjqcan

GoodMemory — AI skill for Claude Code

AI community

Local-first, auditable memory layer for AI apps and coding agents — Codex, Claude Code, MCP, HTTP, TypeScript, and Python.

How to install GoodMemory

This entry records only its repository, not the path inside it, so there is no exact command to give. Open hjqcan/GoodMemory and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What GoodMemory does

Local-first, auditable memory layer for AI apps and coding agents — Codex, Claude Code, MCP, HTTP, TypeScript, and Python.

Alternatives in AI

TokenTracker — Local-first AI token usage & cost tracker for 31 coding tools incl 1.4k ★
Molio — A local-first personal knowledge layer for AI agents 241 ★
Engrim — The Universal Cross-Model Episodic Memory Standard 219 ★

README

GoodMemory

Language: English | [简体中文](./README.zh-CN.md)

GoodMemory is a memory layer for AI products and coding agents.

**Release source:** this source targets the `0.8.1` stable release. Registry commands require `goodmemory@0.8.1` to be published. The release workflow verifies npm `latest` and the already published GitHub assets against the locally prepared manifest; it does not rebuild or publish.

It gives chat apps, copilots, and agent hosts a durable user/project memory loop: write selected facts, retrieve the right context, inject it into the next turn, audit what happened, and delete it when it is wrong.

GoodMemory is not an LLM, agent framework, vector database, or generic RAG system. It is the product memory layer between your app or installed agent host and the model runtime.

What You Get

Durable memory API: remember, recall, buildContext, feedback, forget, exportMemory, importMemory, and deleteAllMemory.
Installed agent memory for Codex and Claude Code through goodmemory setup, managed hooks, installed Codex pre-action, goodmemory status, read-only MCP, and opt-in writeback.
Public write customization with GoodMemoryConfig.remember, RememberProfile, rememberRules, RememberInput.annotations, and named extractor ids.
Package exports for goodmemory, goodmemory/ai-sdk, goodmemory/host, and goodmemory/http through compiled dist artifacts and TypeScript declarations.
Local-first storage: Bun gets durable SQLite by default; explicit Postgres, injected adapters, and embedding providers can be added when needed.
Evaluation and release evidence paths for deterministic tests, live evals, provider-backed evals, package smoke tests, and quality gates.

OpenAI Build Week 2026

**Pre-existing foundation.** GoodMemory existed before OpenAI Build Week. The pre-event foundation already included the core memory API, local SQLite/Postgres storage, installed-host integration, and the l