memex

Name: memex
Author: iamtouchskyer

ローカル

github.com/iamtouchskyerメモリ・ナレッジ1447 週間前に更新

リポジトリ

memex について

memex は AI コーディングエージェント向けの永続メモリシステムです。エージェントが学んだ内容を、双方向リンク付きの markdown アトミックカードとして保存します。セッションをまたいで知識を引き継ぎたい開発者に向いており、複数のクライアントで同じディレクトリを共有できます。

主な機能

01[[双方向リンク]]付きのアトミックな知識カード
02ベクトルデータベースや embedding が不要
03クライアント間で共有される ~/.memex/cards/ ディレクトリ
04Git によるカードの同期
05ローカル UI のタイムラインとリンクグラフ表示

活用シーン

01Claude Code や Cursor でセッションをまたいで過去の結論をリコール
02複数のマシン間でエージェントのメモリカードを同期
03Obsidian などのツールでカードを閲覧・編集

MCP 対応

memex は MCP サーバーとして動作し、Cursor・Codex・Windsurf などの MCP クライアントに 12 個のツールを公開します。Claude Code ではプラグインによる統合を使用し、MCP はフォールバックとして利用できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "iamtouchskyer-memex": {
      "command": "npx",
      "args": [
        "-y",
        "@touchskyer/memex"
      ],
      "env": {
        "MEMEX_HOME": "<MEMEX_HOME>"
      }
    }
  }
}

起動コマンドnpx -y @touchskyer/memex

設定が必要な環境変数

MEMEX_HOMECustom data directory for memex cards (default: ~/.memex)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@touchskyer/memex0.1.8stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
limit	number	いいえ	結果の最大数（デフォルトは 10）
query	string	いいえ	検索キーワード。省略すると、すべてのカードを一覧表示します。

詳細

memex

AI コーディングエージェントのための永続メモリです。エージェントはセッションをまたいで学んだことを記憶します。

English | 中文 | 日本語 | 한국어 | Español

memex timeline view

英語

AI エージェントはタスクを終えるたびに、[[双方向リンク]]を使った独立したナレッジカードとして知見を保存します。次のセッションでは、作業を始める前に関連するカードを呼び出すため、最初からやり直すのではなく、すでに得た知識を活用できます。

ベクトルデータベースも埋め込みも不要です。エージェントもあなたも読める Markdown ファイルだけを使います。

対応プラットフォーム

プラットフォーム	統合方法	使用感
Claude Code	プラグイン（フック＋スキル）	最適 — 自動呼び出し、スラッシュコマンド、SessionStart フック
VS Code / Copilot	MCP サーバー	12 個の MCP ツール、設定不要
Cursor	MCP サーバー	12 個の MCP ツール、設定不要
Codex	MCP サーバー	12 個の MCP ツール、設定不要
Windsurf	MCP サーバー	12 個の MCP ツール、設定不要
Pi	拡張機能（カスタムツール＋フック）	8 個のツール、自動呼び出しフック、スラッシュコマンド
あらゆる MCP クライアント	MCP サーバー	12 個の MCP ツール、設定不要

すべてのプラットフォームで同じ ~/.memex/cards/ ディレクトリを共有します。Claude Code で書いたカードは、Cursor、Codex、その他のクライアントでもすぐに利用できます。

前提条件

VS Code / Copilot：前提条件はありません — 拡張機能に必要なものがすべて含まれています
Claude Code：前提条件はありません — プラグインがすべて処理します
Pi：Node.js 18+ と npm install -g @touchskyer/memex が必要です
その他すべてのプラットフォーム（Cursor、Codex、Windsurf など）：Node.js 18+ が必要です

インストール

ステップ 1：エディターに memex を追加する

プラットフォーム	コマンド
VS Code / Copilot	VS Code Extensions で「memex」を検索 — インストールすれば完了です。追加設定は不要です
Claude Code	`/plugin marketplace add iamtouchskyer/memex` の後に `/plugin install memex@memex`
Claude Code（MCP フォールバック）	`npm install -g @touchskyer/memex && memex mcp-config --claude-code`
Cursor	まず `npm install -g @touchskyer/memex` を実行し、その後ワンクリックでインストール
Codex	`npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp`
Pi	`npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex`
Windsurf / その他	`npm install -g @touchskyer/memex` を実行し、MCP サーバーを追加します：コマンド `memex`、引数 `["mcp"]`

注： VS Code 内で Claude Code を使う場合は、「VS Code / Copilot」ではなく、Claude Code の行に従ってください。VS Code 拡張機能が対応するのは GitHub Copilot のみです。Claude Code には独自のプラグインシステムがあります。

これで完了です — 追加設定は必要ありません。MCP ツールの説明によって、いつ知識を呼び出し、振り返るべきかをエージェントに伝えます。

アップグレード

プラットフォーム	方法
VS Code / Copilot	拡張機能はマーケットプレースから自動更新されます
Claude Code	`/plugin uninstall memex` の後に `/plugin install memex@memex`
Pi	`npm update -g @touchskyer/memex` を実行し、`pi-extension/index.ts` を再コピーします
Cursor / Codex / Windsurf	`npm update -g @touchskyer/memex`

クロスプラットフォームでの共有

すべてのクライアントが同じ ~/.memex/cards/ ディレクトリを読み書きします。git を使ってデバイス間で同期できます：

前提条件： 自動作成には GitHub CLI（gh auth login）が必要です。または、これを省略するには独自の git リモート URL を指定してください。GitLab およびセルフホストの GitLab リモートも使用できます。

memex sync --init                # auto-creates private memex-cards repo on GitHub
memex sync --init <repo-url>     # or specify your own repo URL (no gh/glab CLI needed)
memex sync on                    # enable auto-sync after every write
memex sync                       # manual sync
memex sync off                   # disable auto-sync

GitLab の場合は、まず空のプライベートリポジトリを作成し、その SSH または HTTPS のリモート URL を指定します。例については、GitLab 同期ガイドを参照してください。

メモリーを閲覧する

memex serve

localhost:3939 で、すべてのカードを視覚的なタイムラインとして開きます。双方向リンクをたどれるグラフビューも利用できます。

同期を設定している場合、memex serve を実行すると memra.vercel.app が開きます。タイムライン、グラフビュー、カード共有機能を備えたウェブ UI です。--local を渡すと、代わりにローカル UI を強制的に開きます（オフライン時や、サードパーティのウェブアプリにクエリを送信したくない場合に便利です）。

memex serve --local

グラフビュー

CLI リファレンス

memex search [query]          # search cards (ranked), or guidance / --list
memex read <slug>             # read a card
memex write <slug>            # write a card (content via stdin)
memex links [slug]            # link graph stats, or one card's links
memex backlinks <slug>        # cards linking to <slug> via [[wiki-links]]
memex link <from> <to> <ctx>  # append an outbound [[wiki-link]] with context
memex archive <slug>          # move a card to the archive
memex organize                # analyze network: orphans, hubs, conflicts
memex serve                   # visual timeline UI (web)
memex sync                    # sync via git (--init / --status / on|off)
memex import [source]         # import memories from other tools (openclaw, ...)
memex mcp                     # start MCP server (stdio)
memex mcp-config              # configure MCP for Claude Code / other clients
memex doctor                  # check memex health and configuration
memex migrate                 # migrate configuration (e.g. --enable-nested)
memex flomo ...               # flomo integration: config / push / import

仕組み

Niklas Luhmann のツェッテルカステン方式に基づいています。9万枚の手書きカードから70冊の本を生み出したシステムです。

アトミックノート — 1枚のカードに1つのアイデア
自分の言葉で書く — 理解を促します（ファインマン・メソッド）
文脈の中でリンクする — 単なるタグではなく、「これは[[X]]と関連しています。なぜなら……」と記します
キーワード索引 — カードネットワークへの、厳選された入り口です

カードは ~/.memex/cards/ に Markdown 形式で保存されます。Obsidian で開いたり、vim で編集したり、ターミナルから grep で検索したりできます。あなたのメモリーがロックされることはありません。

プライバシー保護のガードレール

実際のシークレット、認証情報、トークン、またはシークレットファイルの正確な内容を、memex のクエリやカードに含めないでください。代わりに、抽象的な説明と、機密情報を伏せた例を使用してください。

Memex は、確度の高い生のシークレットを拒否し、保存前に URL に埋め込まれた認証情報を伏せ、表示時には Webhook やトークンを含む URL をマスクします。AI クライアントがすでにトランスクリプトに表示した、安全でないツール呼び出し引数を隠すことはできないため、ツールを呼び出す前に機密情報を伏せてください。

設定

任意の設定は ~/.memex/.memexrc（JSON）に記述します。

{
  "nestedSlugs": true,
  "searchDirs": ["shared"],
  "experimental": {
    "agenticMemory": true
  }
}

キー	型	デフォルト	説明
`nestedSlugs`	boolean	`false`	スラッグ内の `/` を許可し、階層的なカードパスを使用できるようにします
`searchDirs`	string[]	—	`--all` で検索する追加ディレクトリ（組み込みの `cards/` ストアに加えて検索します）
`experimental.agenticMemory`	boolean	`false`	A-MEM に着想を得たエージェント型メモリーワークフローを有効にします（以下を参照）

実験的機能：エージェント型メモリー

experimental.agenticMemory が true の場合、エージェントは構造化されたメモリースキルを利用できます。このスキルでは、観察 → アトミックカードの下書き → メタデータの充実 → 候補の取得 → 判断（作成／更新／スキップ） → プレビュー → 書き込み → 検証という手順に沿って作業します。

デフォルトの recall／retro ワークフローと比べて、エージェントが提案する [[wikilinks]]（リンクは候補の取得とエージェントによる確認の後に提案され、キーワードや埋め込みの類似性だけをもとに追加されることはありません）と、充実したメタデータを備えた、より質の高いカードを作成できます。この機能はデフォルトで無効になっており、無効時に既存の動作が変わることはありません。

スキルの仕様全体については skills/memex-agentic-memory/SKILL.md を、設定の詳細については docs/ARCHITECTURE.md を参照してください。

中国語

AI コーディングエージェント向けの永続メモリーシステムです。エージェントがセッションをまたいで学習した知識を記憶できるようにします。

エージェントはタスクを完了するたびに、[[双方向リンク]] を含むアトミックな知識カードとして洞察を保存します。次のセッションでは、作業を始める前に関連カードを振り返ります。ゼロから始めるのではなく、既存の知識をもとに作業を続けられます。

ベクトルデータベースも埋め込みも不要です。あなたとエージェントの両方が読み取れる Markdown ファイルだけを使用します。

対応プラットフォーム

プラットフォーム	統合方法	使用感
Claude Code	プラグイン（フック＋スキル）	最適 — 自動で振り返り、スラッシュコマンド、SessionStart フック
VS Code / Copilot	MCP サーバー	MCP ツール12個、設定不要
Cursor	MCP サーバー	MCP ツール12個、設定不要
Codex	MCP サーバー	MCP ツール12個、設定不要
Windsurf	MCP サーバー	MCP ツール12個、設定不要
Pi	拡張機能（カスタムツール＋フック）	ツール8個、自動振り返りフック、スラッシュコマンド
任意の MCP クライアント	MCP サーバー	MCP ツール12個、設定不要

すべてのプラットフォームで、同じ ~/.memex/cards/ ディレクトリを共有します。Claude Code で作成したカードは、Cursor、Codex、その他のクライアントですぐに利用できます。

前提条件

VS Code / Copilot：追加インストールは不要です。拡張機能にすべての依存関係が含まれています
Claude Code：追加インストールは不要です。プラグインが自動で処理します
Pi：Node.js 18+ と npm install -g @touchskyer/memex が必要です
その他のプラットフォーム（Cursor、Codex、Windsurf など）：Node.js 18+ が必要です

安装

第一步：添加 memex 到编辑器

平台	命令
VS Code / Copilot	在 VS Code 扩展商店搜索 "memex"——安装即用，无需其他配置
Claude Code	`/plugin marketplace add iamtouchskyer/memex`，然后 `/plugin install memex@memex`
Claude Code（MCP 备选）	`npm install -g @touchskyer/memex && memex mcp-config --claude-code`
Cursor	先 `npm install -g @touchskyer/memex`，然后一键安装
Codex	`npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp`
Pi	`npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex`
Windsurf / 其他	`npm install -g @touchskyer/memex`，然后添加 MCP server：命令 `memex`，参数 `["mcp"]`

注意： 如果你在 VS Code 里使用 Claude Code，请按照 Claude Code 那一行操作，而非"VS Code / Copilot"。VS Code 扩展仅服务于 GitHub Copilot；Claude Code 有自己的 plugin 系统。

安装完成，无需额外配置。MCP 工具描述会自动告诉 agent 何时 recall 和 retro。

日本語

AIコーディングエージェントのための永続メモリシステム。エージェントがセッションをまたいで学んだことを記憶します。

エージェントがタスクを完了するたびに、[[双方向リンク]]付きのアトミックな知識カードとしてインサイトを保存します。次のセッションでは、作業開始前に関連カードを呼び出し、ゼロからではなく既存の知識の上に構築します。

ベクトルデータベースもembeddingも不要——エージェント（とあなた）が読めるmarkdownファイルだけです。

対応プラットフォーム

プラットフォーム	統合方式	体験
Claude Code	Plugin（hooks + skills）	最高——自動リコール、スラッシュコマンド、SessionStart hook
VS Code / Copilot	MCP Server	12 MCPツール、設定不要
Cursor	MCP Server	12 MCPツール、設定不要
Codex	MCP Server	12 MCPツール、設定不要
Windsurf	MCP Server	12 MCPツール、設定不要
Pi	Extension（カスタムツール + hooks）	8ツール、自動リコールhook、スラッシュコマンド
任意のMCPクライアント	MCP Server	12 MCPツール、設定不要

すべてのプラットフォームが同じ ~/.memex/cards/ ディレクトリを共有します。Claude Codeで書いたカードは、Cursor、Codex、その他のクライアントですぐに利用できます。

前提条件

VS Code / Copilot：前提条件なし——拡張機能がすべてをバンドル
Claude Code：前提条件なし——プラグインがすべてを処理
Pi：Node.js 18+ と npm install -g @touchskyer/memex が必要
その他のプラットフォーム（Cursor、Codex、Windsurf等）：Node.js 18+ が必要

インストール

ステップ1：エディタにmemexを追加

プラットフォーム	コマンド
VS Code / Copilot	VS Code 拡張機能で "memex" を検索——インストールするだけ、追加設定不要
Claude Code	`/plugin marketplace add iamtouchskyer/memex`、その後 `/plugin install memex@memex`
Claude Code（MCPフォールバック）	`npm install -g @touchskyer/memex && memex mcp-config --claude-code`
Cursor	まず `npm install -g @touchskyer/memex`、その後ワンクリックインストール
Codex	`npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp`
Pi	`npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex`
Windsurf / その他	`npm install -g @touchskyer/memex`、その後MCP serverを追加：コマンド `memex`、引数 `["mcp"]`

注意: VS Code内でClaude Codeを使用する場合は、「VS Code / Copilot」ではなく Claude Code の行に従ってください。VS Code拡張機能はGitHub Copilot専用です。Claude Codeには独自のプラグインシステムがあります。

インストール完了、追加設定は不要です。MCPツールの説明がエージェントにリコールとレトロのタイミングを自動的に教えます。

アップグレード

プラットフォーム	方法
VS Code / Copilot	拡張機能がマーケットプレイスから自動更新
Claude Code	`/plugin uninstall memex` → `/plugin install memex@memex`
Cursor / Codex / Windsurf	`npm update -g @touchskyer/memex`

한국어

AI 코딩 에이전트를 위한 영구 메모리 시스템. 에이전트가 세션을 넘어 학습한 내용을 기억합니다.

에이전트가 작업을 완료할 때마다 [[양방향 링크]]가 포함된 원자적 지식 카드로 인사이트를 저장합니다. 다음 세션에서는 작업 시작 전에 관련 카드를 불러와, 처음부터가 아닌 기존 지식 위에 구축합니다.

벡터 데이터베이스도 임베딩도 필요 없습니다 — 에이전트(와 당신)가 읽을 수 있는 markdown 파일뿐입니다.

サポート対象プラットフォーム

プラットフォーム	統合方式	使用感
Claude Code	Plugin (hooks + skills)	最良 — 自動リコール、スラッシュコマンド、SessionStart hook
VS Code / Copilot	MCP Server	MCP ツール 10 個、設定不要
Cursor	MCP Server	MCP ツール 10 個、設定不要
Codex	MCP Server	MCP ツール 10 個、設定不要
Windsurf	MCP Server	MCP ツール 10 個、設定不要
Pi	Extension (カスタムツール + hooks)	ツール 8 個、自動リコール hook、スラッシュコマンド
すべての MCP クライアント	MCP Server	MCP ツール 10 個、設定不要

すべてのプラットフォームで同じ ~/.memex/cards/ ディレクトリを共有します。Claude Code で作成したカードは、Cursor、Codex、その他のクライアントですぐに使用できます。

前提条件

VS Code / Copilot：前提条件はありません — 拡張機能にすべて含まれています
Claude Code：前提条件はありません — プラグインがすべて処理します
Pi：Node.js 18+ と npm install -g @touchskyer/memex が必要です
その他のプラットフォーム（Cursor、Codex、Windsurf など）：Node.js 18+ が必要です

インストール

ステップ 1：エディターに memex を追加

プラットフォーム	コマンド
VS Code / Copilot	VS Code 拡張機能で「memex」を検索 — インストールするだけで完了、追加設定は不要です
Claude Code	`/plugin marketplace add iamtouchskyer/memex` の後に `/plugin install memex@memex`
Claude Code（MCP の代替方法）	`npm install -g @touchskyer/memex && memex mcp-config --claude-code`
Cursor	まず `npm install -g @touchskyer/memex` を実行し、その後ワンクリックインストール
Codex	`npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp`
Pi	`npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex`
Windsurf / その他	`npm install -g @touchskyer/memex` を実行し、その後 MCP サーバーを追加：コマンド `memex`、引数 `["mcp"]`

注： VS Code で Claude Code を使用する場合は、「VS Code / Copilot」ではなく Claude Code の行に従ってください。VS Code 拡張機能は GitHub Copilot 専用で、Claude Code は独自のプラグインシステムを使用します。

インストールはこれで完了です。追加設定は必要ありません。MCP ツールの説明により、エージェントにリコールと振り返りのタイミングが自動的に伝わります。

アップグレード

プラットフォーム	方法
VS Code / Copilot	拡張機能はマーケットプレイスから自動的に更新されます
Claude Code	`/plugin uninstall memex` → `/plugin install memex@memex`
Cursor / Codex / Windsurf	`npm update -g @touchskyer/memex`

Español

AI コーディングエージェント向けの永続メモリです。エージェントはセッションをまたいで学んだことを記憶します。

AI エージェントがタスクを終えるたびに、[[双方向リンク]] を使ったアトミックなカードとして知識を保存します。次のセッションでは、作業を始める前に関連するカードを取得し、ゼロから始めるのではなく、すでに知っていることを基に作業を進めます。

ベクトルデータベースも埋め込みも不要です — エージェント（そしてあなた）が読める Markdown ファイルだけを使います。

サポート対象プラットフォーム

プラットフォーム	統合方式	使用感
Claude Code	Plugin (hooks + skills)	最良 — 自動リコール、スラッシュコマンド、SessionStart hook
VS Code / Copilot	MCP Server	MCP ツール 12 個、設定不要
Cursor	MCP Server	MCP ツール 12 個、設定不要
Codex	MCP Server	MCP ツール 12 個、設定不要
Windsurf	MCP Server	MCP ツール 12 個、設定不要
Pi	Extension (カスタムツール + hooks)	ツール 8 個、自動リコール hook、スラッシュコマンド
すべての MCP クライアント	MCP Server	MCP ツール 12 個、設定不要

前提条件

VS Code / Copilot：前提条件はありません — 拡張機能にすべて含まれています
Claude Code：前提条件はありません — プラグインがすべて処理します
Pi：Node.js 18+ と npm install -g @touchskyer/memex が必要です
その他のプラットフォーム（Cursor、Codex、Windsurf など）：Node.js 18+ が必要です

インストール

ステップ 1：エディターに memex を追加します

プラットフォーム	コマンド
VS Code / Copilot	VS Code Extensions で「memex」を検索してください。インストールすれば完了です。追加の設定は不要です
Claude Code	`/plugin marketplace add iamtouchskyer/memex`、続けて `/plugin install memex@memex`
Claude Code（代替 MCP）	`npm install -g @touchskyer/memex && memex mcp-config --claude-code`
Cursor	まず `npm install -g @touchskyer/memex` を実行し、その後ワンクリックでインストール
Codex	`npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp`
Pi	`npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex`
Windsurf / その他	`npm install -g @touchskyer/memex` を実行し、MCP サーバーを追加します。コマンドは `memex`、引数は `["mcp"]` です

注： VS Code 内で Claude Code を使用する場合は、「VS Code / Copilot」ではなく Claude Code の行に従ってください。VS Code 拡張機能は GitHub Copilot 専用です。Claude Code には独自のプラグインシステムがあります。

インストールはこれで完了です。追加の設定は不要です。MCP ツールの説明により、いつリコールや振り返りを行うべきか、エージェントに自動的に伝わります。

更新

プラットフォーム	方法
VS Code / Copilot	拡張機能はマーケットプレイスから自動的に更新されます
Claude Code	`/plugin uninstall memex` → `/plugin install memex@memex`
Cursor / Codex / Windsurf	`npm update -g @touchskyer/memex`

コミュニティ

memex をお使いですか？Discussions → 活用例の共有でセットアップを共有してください。質問はQ&Aへどうぞ。機能のアイデアはアイデアで共有してください。

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: iamtouchskyer
言語: node
バージョン: 0.1.8
トランスポート: stdio
掲載日: 2026年3月22日
最終更新: 7 週間前
公式 Registry: io.github.iamtouchskyer/memex

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

memex

memex について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

memex

英語

対応プラットフォーム

前提条件

インストール

アップグレード

クロスプラットフォームでの共有

メモリーを閲覧する

CLI リファレンス

仕組み

プライバシー保護のガードレール

設定

実験的機能：エージェント型メモリー

中国語

対応プラットフォーム

前提条件

安装

日本語

対応プラットフォーム

前提条件

インストール

アップグレード

한국어

サポート対象プラットフォーム

前提条件

インストール

アップグレード

Español

サポート対象プラットフォーム

前提条件

インストール

更新

コミュニティ

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？