GoodMemory — AI skill for Claude Code
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 ★
- TurboLLM — Run any local LLM engine, auto-tuned to your GPU — polished web UI + OpenAI/Anthropic-compatible API 251 ★
- Molio — A local-first personal knowledge layer for AI agents 241 ★
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, anddeleteAllMemory. - 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, andgoodmemory/httpthrough compileddistartifacts 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
Related Skills
Singularmem
Singularmem is a local-first persistent memory layer for LLM-driven workflows built in Rust, SQLite, Typescrip
Awareness SDK
Local-first AI agent memory — one command, 13+ IDEs, works offline. Persistent memory for Claude Code, Cursor,
Llmslim
Long-term memory for AI agents with no LLM call: an MCP server and Claude Code plugin, plus local-first contex
Seamless
Local-first shared memory and task coordination for AI coding agents. One Go binary, MCP server, markdown file
Sessionmem
Local-first MCP memory layer for AI coding assistants; persistent cross-session memory, stored entirely on you
Babata
Local-first personal AI runtime — Telegram + WeChat transports, shared memory, skills, ops automation. The sys
Related Agents
Code Writer TypeScript
TypeScript code implementation sub-agent. Invoked by any manager whose plan calls for TS code — Node services,
Kimi Worker
Forward a coding, diagnosis, or review task to Kimi K3 (Moonshot) through the local kimi-worker.sh runtime. Us
Part 13: Memory Bridge (Give Coding Agents Your Brain)
When you spawn Codex or Claude Code to build something, they start blind. They don't know your architecture de