ローカル LLM / エージェント向けの軽量メモリ基盤を、coding agent 向け resolver 機能で拡張した実験実装です。
4つの SQLite ストアで、保存、検索、参照、要約を行い、docs/chunks/read receipts/stale check も扱えます。
AIエージェントはこちらを参照してください。
| Store | 用途 |
|---|---|
short |
短期メモ、作業中の情報 |
journal |
時系列ログ、進捗、判断 |
knowledge |
知識、定義、手順 |
archive |
検索対象外の退避先 |
cd memx_spec_v3/go
go build ./cmd/mem
# short に保存
mem in short --title "会議メモ" --body "明日10時に打ち合わせ"
# 横断検索
mem out search --json "会議"
# ID を指定して表示
mem out show <NOTE_ID>mem out search は short / journal / knowledge を横断検索します。
mem out show は short / journal / knowledge / archive を解決します。
.claude/commands/ に以下の Skill を含みます。
| Skill | 用途 |
|---|---|
/remember |
short に保存 |
/recall |
横断検索 |
/journal |
journal に保存 |
/knowledge |
knowledge に保存 |
/show |
ノート詳細表示 |
/memx-help |
使い方表示 |
# short
mem in short --title "Title" --body "Body"
# journal / knowledge
mem in journal --title "進捗" --body "API実装完了" --scope project:memx
mem in knowledge --title "用語" --body "JWT = JSON Web Token" --scope glossary --pinned
# 検索 / 表示
mem out search --json "JWT"
mem out show <NOTE_ID>
# store ごとの操作
mem out journal list --scope project:memx
mem out knowledge pinned --json
# 要約
mem summarize <NOTE_ID>
mem summarize --ids id1,id2,id3 --json
# GC
mem gc short --dry-run
mem gc short --enable-gc既定 DB は short.db / journal.db / knowledge.db / archive.db です。
mem api serve --addr 127.0.0.1:7766CLI から API サーバー経由で使う場合:
mem in short --api-url http://127.0.0.1:7766 --title "test" --body "body"
mem out search --api-url http://127.0.0.1:7766 --json "test"主なエンドポイント:
POST /v1/notes:ingestPOST /v1/notes:searchGET /v1/notes/{id}POST /v1/notes:summarizePOST /v1/journal:ingestPOST /v1/journal:searchGET /v1/journal/{id}POST /v1/knowledge:ingestPOST /v1/knowledge:searchGET /v1/knowledge/{id}GET /v1/archive/{id}POST /v1/docs:ingestPOST /v1/docs:resolvePOST /v1/chunks:getPOST /v1/docs:searchPOST /v1/reads:ackPOST /v1/docs:stale-checkPOST /v1/contracts:resolve
mem summarize と保存時の自動要約で使います。
mem CLI と API サーバーは、memx-core 配下で起動した場合に .env を自動読込します。
export MEMX_LLM_PROVIDER="openai"
export OPENAI_API_KEY="sk-..."
export MEMX_OPENAI_MODEL="gpt-5-mini"export MEMX_LLM_PROVIDER="alibaba"
export DASHSCOPE_API_KEY="sk-..."
export MEMX_ALIBABA_MODEL="glm-5"
export MEMX_ALIBABA_BASE_URL="https://coding-intl.dashscope.aliyuncs.com/v1"Alibaba 互換モードでは chat/completions を使います。
secretは保存拒否- 既定の
sensitivityはinternal - タイトル、本文、列挙値にバリデーションあり
- AGENT_GUIDE.md
- docs/requirements.md
- docs/interfaces.md
- docs/design.md
- memx_spec_v3/docs/requirements.md
- memx_spec_v3/docs/design.md
- memx_spec_v3/docs/contracts/openapi.yaml
- memx_spec_v3/docs/contracts/cli-json.schema.json
License: MIT