memocap

SQLite memory shared by Codex, Claude, Pi, and OpenCode

Packages

Package details

skill

Install memocap from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:memocap
Package
memocap
Version
0.1.5
Published
Sep 10, 2026
Downloads
639/mo · 41/wk
Author
asural
License
MIT
Types
skill
Size
10.5 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "skills": [
    "./skills/memocap"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

中文

memocap

YiShi (忆时) memory — human-like retrieval, storage, forgetting, capsules, and visualization. Gives AI memory that forgets, associates, emerges, and can be sealed. Triggers: 忆时, 记忆, 记住, 回想, 回忆, recall, remember, 时间胶囊, 记忆检索, 可视化, 记忆脑图, 人物画像.

One SQLite. Four hosts, one memocap. Recall first every turn; store decisions / prefs / tasks / agreements after a similar-check.

Install

pnpm add -g memocap

Codex: memocap install writes AGENTS.md.

Claude: memocap install writes CLAUDE.md and a skill.

Pi: pi install npm:memocap (puts memocap on PATH; agent rules always call that name — never an absolute binary path).

On Windows, Pi runs tools through Git Bash, which breaks drive-letter absolute paths (pi#2080). Install with npm/pnpm global or pi install npm:memocap so memocap is on PATH.

OpenCode: opencode plugin memocap

memocap install --host grok,claude (repeatable) selects hosts; --all writes Codex/Claude/Grok. TUI checkboxes mark detected agents.

Commands

remember [--force] / recall [--type] [--limit 3] / list / forget

Usage

Local SQLite (default, no network):

memocap remember "ship friday"
memocap recall "friday"

Server (same store, token required):

git clone https://github.com/luodaoyi/memocap
cd memocap
export MEMOCAP_TOKEN=replace-me
docker compose up -d

Port 8787. Data stays in the Compose volume. Without a token the stack will not start.

export MEMOCAP_ADDR=http://127.0.0.1:8787
memocap remember "ship friday"

Other machines use the same token and set MEMOCAP_ADDR to http://server:8787.

If MEMOCAP_ADDR is unset, the CLI stays local and does not use the network.

Compare

Project How it remembers Hosts
ClawHub memocap value-store + recall-first OpenClaw
claude-mem auto-captures sessions Claude
agentmemory auto-captures via MCP multi-host MCP
pi-memory markdown files Pi
this repo value-store + recall-first Codex / Claude / Pi / OpenCode, local SQLite or one-token server