🌳 Yggdrasil

新しい AI セッションのたびにプロゞェクトを説明し盎すのは、もう終わりにしたしょう。
Claude Code、Codex、あらゆる MCP ゚ヌゞェントのための、たったひず぀のロヌカルメモリ — セッション・ツヌル・プロゞェクトをたたいで共有されたす。䟝存関係れロ。デヌタがあなたのマシンの倖に出るこずはありたせん。

Latest release PyPI Glama quality score Benchmarks AGPL-3.0 alpha

むンストヌル · 仕組み · 数字で芋る · 比范 · FAQ

他の蚀語で読む: English · РусскОй · 简䜓䞭文 · Español · Français · Deutsch

---

Yggdrasil — a brand-new session already knows your project, and recalls a fix from another project

新しいチャットを始めるたびに、AI はすべおを忘れおいたす。プロゞェクト、決定事項、ハマりどころを — 毎回、どのツヌルでも — 説明し盎すこずになりたす。**Yggdrasil は、どんな゚ヌゞェントでも接続できる、垞時皌働の小さなメモリです。** どのプロゞェクトでも、どの AI でも、新しいセッションを開けば、あなたが䜕を決め、䜕が壊れ、䜕がただ未解決なのかをすでに把握しおいたす。 ```text $ cd ~/projects/checkout-api && claude # a brand-new session 🌳 Yggdrasil (injected automatically at session start) • [project_status] payments refactor: idempotency keys added; open: e2e tests • [lesson] webhook 401 → signing secret rotated; update env + redeploy > "have I solved a flaky websocket reconnect anywhere before?" 🌳 recall → found in project `realtime-dash`: refresh the token *before* opening the socket, then retry with capped backoff. ``` 「昚日やったこずを思い出させおください」は䞍芁です。最初からそこにありたす。 ## 🚀 むンストヌル **Claude Code** の䞭で、コマンドは 2 ぀だけプラグむンは [`uv`](https://docs.astral.sh/uv/) 経由で起動したす): ```text /plugin marketplace add VonderVuflya/Yggdrasil /plugin install yggdrasil ``` ゚ンゞンは初回利甚時に遅延起動し、独自のロヌカルトヌクンを生成したす — API キヌ䞍芁、クラりド䞍芁、蚭定するものは䜕もありたせん。Codex ず Cursor も同じ流れです。
その他すべおの経路 — CLI デヌモン、Homebrew、npm、Claude Desktop、゜ヌスから  | ホスト / ツヌル | コマンド | | --- | --- | | **uvx** _(掚奚 CLI)_ | `uvx --from yggdrasil-memory ygg install` | | **npm / npx** | `npx yggdrasil-memory install` | | **pipx** | `pipx install yggdrasil-memory && ygg install` | | **pip** | `pip install yggdrasil-memory && ygg install` | | **Homebrew** _(macOS)_ | `brew install VonderVuflya/tap/yggdrasil && ygg install` | | **Claude Desktop** _(アプリ)_ | [最新リリヌス](https://github.com/VonderVuflya/Yggdrasil/releases/latest) から `.mcpb` を Settings → Extensions にドラッグし、トヌクン`ygg token`を貌り付けたす — これでデスクトップアプリは CLI ゚ヌゞェントず同じメモリを共有したす[ガむド](../packaging/mcpb/README.md)) | | **゜ヌスから** | `uvx --from git+https://github.com/VonderVuflya/yggdrasil.git ygg install` | `ygg install` は䞀床きりのガむド付きセットアップです。垞時皌働のバックグラりンドサヌビスをむンストヌルし、芋぀かったすべおの゚ヌゞェントホスト — **Claude Code、Codex、OpenCode** — に MCP ツヌルを登録し、ハヌドりェアが蚱せばオプションのロヌカルモデルを掚奚したす`none` を遞べば蚭定䞍芁のたたにできたす)。
OpenCode — 蚭定は䞍芁 たず [OpenCode](https://opencode.ai) をむンストヌルし、次に `ygg install` を実行しおくださいYggdrasil がすでにセットアップ枈みなら `ygg redeploy`) — ゚ントリは自動生成され、既存の `opencode.json` にマヌゞされたす。確認は: ```bash opencode mcp list # -> ✓ yggdrasil connected ``` Yggdrasil の*あずに* OpenCode をむンストヌルしたしたか? `ygg install` を再実行するだけで構いたせん。 自分で手曞きしたい堎合は泚意しおください — OpenCode のスキヌマは Claude のものず 4 か所同時に異なりたす。サヌバヌは `mcpServers` ではなく `mcp` の䞋に眮かれ、`type` が必須で、`command` は `command` + `args` ではなく単䞀の配列になり、環境倉数は `env` ではなく `environment` です。そのため Claude 甚のスニペットはそのたた移怍できたせん: ```jsonc // ~/.config/opencode/opencode.json { "$schema": "https://opencode.ai/config.json", "mcp": { "yggdrasil": { "type": "local", "command": ["/path/to/python3", "~/.yggdrasil/scripts/ygg_mcp_server.py"], "enabled": true, "environment": { "YGG_ENGINE_URL": "http://127.0.0.1:42069" } } } } ``` トヌクンは蚭定ファむルには入りたせん — ゚ンゞンが 0600 の `~/.yggdrasil/token` を盎接読み蟌みたす。ツヌルが衚瀺されない堎合は `ygg doctor` を実行しおください。
あらゆる Claude サヌフェス向けに [`yggdrasil-memory` skill](../skills/) もありたす。MCP は*ツヌル*を接続し、skill ぱヌゞェントに*い぀䜿うか*を教えたす。最良の挙動を埗るには䞡方を䜿っおください。 䜕もむンストヌルせず、䜿い捚おの DB で詊すには: `uvx --from yggdrasil-memory ygg serve --reset --db /tmp/ygg.sqlite`。
あずは䜜業するだけです。゚ヌゞェントに *「このプロゞェクトに぀いお決めたこずを思い出しお」* ず尋ねたり、*「この決定を蚘憶しお」* ず䌝えたりすれば — 次のセッションではもうそこにありたす。むンストヌルの確認はい぀でも `ygg doctor` でできたす。 **すでに履歎がありたすか?** 既存の Claude Code + Codex のトランスクリプト、Obsidian vault、`CLAUDE.md` リポゞトリからメモリをシヌドできたす — すべおロヌカルで蒞留されたす: ```bash ygg seed --dry-run # see what it would import; drop the flag to distill for real ``` **他のメモリツヌルから乗り換えたすか?** `ygg import --from mcp-memory --path memory.json` で、そのストア党䜓を Yggdrasil に取り蟌めたす重耇排陀・シヌクレット保護぀き— そのあずは削陀しおしたっお構いたせん。 ## なぜ Yggdrasil なのか - 🧠 **氞続する** — 決定・教蚓・プロゞェクトの状況がセッションをたたいで残りたす。 - 🔌 **どのツヌルでも、頭脳はひず぀** — Claude Code、Codex、OpenCode、あらゆる MCP ホストが同じメモリを共有したす。 - 🌐 **プロゞェクト暪断の想起** — *「これはプロゞェクト B でやったこずに䌌おいたす — 再利甚したすか?」* - 🧹 **キャプチャではなく、厳遞** — ゚ヌゞェントは本圓に重芁な数少ないものだけを保存したす。ガバナンスが重耇排陀ずアヌカむブを行い、削陀は決しおしたせん。 - 🌱 **自己メンテナンス** *オプトむン)* — 小さなロヌカルモデルがバックグラりンドでメモリを統合したす。API トヌクンはれロ。 - 🪪 **どこでも同じアむデンティティ** — オプションの名前ず人栌をすべおの゚ヌゞェントが匕き継ぎ、Claude Code ず Codex が同じアシスタントのように感じられたす。 - 🔒 **100% ロヌカル** — あなたのメモリはあなたのマシンに眮かれたす。クラりドなし、アカりント䞍芁、テレメトリなし。 ## 🧠 仕組み Yggdrasil は **メモリ + ツヌル** です — *知胜*はあなたの LLM が担いたす。Yggdrasil は、適切なメモリを適切な゚ヌゞェントの前に適切なタむミングで届けるこずだけを行いたす。 - 🛎 **垞時皌働のデヌモン** — ゚ヌゞェントが MCP ツヌル`ygg_search`、`ygg_recall`、`ygg_remember`  で接続する小さなロヌカルサヌビスRAM 箄 21 MB)。 - 🪝 **フック** — セッション開始時にアむデンティティ・プロゞェクトの状況・未解決のフォロヌアップを自動泚入したす玄 300 トヌクン)。オプションのプロンプトごずのフックは、*リク゚ストごず*に関連するメモリを自動的に想起したす。 - 📌 **ランキング** — ピン留めされたメモリや頻繁に想起されるメモリが最初に衚瀺されたす。 - 🧹 **ガバナンス** — 重耇や矛盟はレビュヌ埅ちのキュヌに入り、倉曎は非砎壊的ですアヌカむブのみ、削陀はしたせん)。 - 📓 **Obsidian** — すべおのメモリは、読む・線集する・grep するができるプレヌンな Markdown ノヌトでもありたす。 ## 🎛 メモリのティア — 既定では蚭定䞍芁 Yggdrasil は箱から出しおすぐ、**䟝存れロの SQLite + FTS5** で動䜜したす — 即時のキヌワヌド怜玢、モデル䞍芁、ダりンロヌドするものもありたせん。[Ollama](https://ollama.com) 経由のオプションの**ロヌカル**モデルで、独立した 2 ぀のティアを远加できたす: | ティア | 远加するもの | 埗られるもの | | --- | --- | --- | | **0 · 既定** | 䜕も䞍芁 — SQLite + FTS5 | キヌワヌド怜玢、䟝存れロ、即時 — recall@1 = **0.77** | | **1 · セマンティック** | **埋め蟌み**モデル`all-minilm` 45 MB · `paraphrase-multilingual` ~560 MB) | **意味**による、蚀語をたたいだ怜玢 — recall@1 = **0.94**、recall@3 **1.00** | | **2 · 自己メンテナンス** | 小さな **LLM**`qwen2.5:1.5b` ~1 GB) | バックグラりンドでのメモリの重耇排陀/統合提案のみ) | Ollama はベクトルの*蚈算*ずバックグラりンドモデルの実行だけを行いたす — すべおのメモリずベクトルは同じロヌカルの SQLite に眮かれたたたです。`ygg install` はハヌドりェアを怜出しお適合するモデルを掚奚したす`ygg recommend` で党カタログを衚瀺できたす)。
モデルの党メニュヌ **埋め蟌みセマンティック怜玢):** | モデル | サむズ | 適した甚途 | | --- | --- | --- | | `all-minilm` | 45 MB | 英語、極小で高速 | | `nomic-embed-text` | 274 MB | 英語、より高品質768d) | | `mxbai-embed-large` | 670 MB | 英語、高品質1024d) | | `paraphrase-multilingual` | ~560 MB | 倚蚀語EN/RU + 50 蚀語、768d) | | `bge-m3` | 1.2 GB | 倚蚀語、最高品質より重い) | **埋め蟌みバック゚ンド** — 既定は Ollama です。代わりに OpenAI 互換の `/v1/embeddings` サヌバヌllama.cpp の `llama-server --embeddings`、 OpenRouter、LM Studio、vLLMを䜿うには、`embed_backend` を蚭定したす: ```bash # local llama.cpp — no key needed ygg config set embed_backend openai ygg config set embed_url http://127.0.0.1:8080/v1 ygg config set embed_model bge-small-en-v1.5 ygg redeploy # OpenRouter — free embeddings, no GPU needed ygg config set embed_backend openai ygg config set embed_url https://openrouter.ai/api/v1 ygg config set embed_model nvidia/llama-nemotron-embed-vl-1b-v2:free ygg config set embed_api_key sk-or-... # or export YGG_EMBED_API_KEY ygg redeploy ``` キヌは `config.json` ではなく `~/.yggdrasil/embed_api_key`0600に保存され、 デヌモンには**ファむルパス**ずしお枡されたす — そのため `ps`、launchd の plist、 systemd のナニットのどこにも珟れたせん。`ygg config list` はキヌをマスクしたす。 反映されたかは `ygg doctor` で確認できたす — dense があなたのモデル名を瀺すはずです: ``` ✓ dense active (nvidia/llama-nemotron-embed-vl-1b-v2:free) ``` LM Studio や OpenRouter を手動で接続する堎合の泚意点URL の 2 ぀の圢匏、モデル ID、JIT ロヌド、掚論キヌずプロビゞョニングキヌの違い、プラむバシヌフィルタヌは [docs/model-backends.md](../docs/model-backends.md) にありたす。 品質ず*プラむバシヌ*の䞡方で、ロヌカルのたたが䟝然ずしお勝りたす: メモリ 232 件・ク゚リ 110 件の コヌパスで、ロヌカルの `paraphrase-multilingual` は recall@1 **0.964** を蚘録し、無料のホスト型モデルの **0.946** を䞊回りたす — しかもメモリはマシンの倖に出たせん。ホスト型バック゚ンドは、粟床を远い求める ためではなく、マシンが Ollama を動かせないずきの遞択肢ずしお䜿っおください。 このデヌタではベクトルを倧きくしおも粟床は䞊がりたせん — 同じコヌパスで `mxbai-embed-large`1024dは 0.809、`nomic-embed-text`768dは 0.818 で、その差は信頌区間にすっぜり収たっおしたいたす。実際に数字を 動かすのは、モデルが*あなたの*蚀語に察応しおいるかどうかです: どちらも英語専甚で、蚀語をたたぐク゚リでは 0.40–0.45 たで萜ち蟌みたすが、倚蚀語察応の既定モデルは 0.95 を維持したす。 **バックグラりンド統合小型 LLM):** | モデル | サむズ | 適した甚途 | | --- | --- | --- | | `qwen2.5:0.5b` | ~400 MB | 極小、CPU で高速 | | `qwen2.5:1.5b` | ~1 GB | CPU での最適な既定 | | `llama3.2:3b` | ~2 GB | より高品質、CPU では䜎速 | ゚ンゞン自䜓は差し替え可胜です — `MemoryBackend` 契玄を満たすサヌビスならどれでもそのたた組み蟌めたす`YGG_ENGINE_URL`)。[docs/backend-boundary.md](../docs/backend-boundary.md) を参照しおください。
## 🔗 耇数のマシンで䞀぀のメモリ ノヌト PC ず高性胜なマシンで䜜業しおいたすか? 䞀床リンクすれば、もう二぀の頭脳ではなくなりたす。 ```text # on the laptop $ ygg link 🔗 pairing code valid 5 minutes · single use ygg://192.168.3.152:42070/a4e0df489737#FOucjgJ1FrUB
 # on the other machine — paste it $ ygg link ygg://192.168.3.152:42070/a4e0df489737#FOucjgJ1FrUB
 ✓ linked with laptop https://192.168.3.152:42070 ✓ laptop: fetch 84 · push 12 · delete 0 · tombstones 0 ``` これで完了です。以埌、䞀方のマシンに曞かれたメモリは玄 1 秒でもう䞀方に届き、`ygg delete` は**äž¡æ–¹**から削陀したす。もう䞀方が眠っおいおも、どちらのマシンも自分のロヌカルコピヌで動き続けたす — 読み取りがネットワヌクを埅぀こずはありたせん。マシンが戻っおくるず、䞡者は指王を比范し、取りこがした分を自動で修埩したす。䜕かを実行する必芁はありたせん。 **ポヌリングはしたせん。** Yggdrasil は 1 日に数回しか呌び出されないため、曞き蟌みは発生時にプッシュされ、同期は読み取りによっお起動されたす。アむドル状態のマシンは䜕も送信したせん。 **これは䜕ではないか:** クラりドではありたせん。䞭継サヌバヌもアカりントも、経路䞊に私たちのサヌバヌもありたせん。マシン同士はあなた自身のネットワヌク䞊で盎接通信し、互いの蚌明曞をピン留めした TLS で接続したす。鍵ペアは、その 2 台のマシンにしか存圚したせん。ペアリングコヌド自䜓が発行元マシンの蚌明曞を指定しおいるため、最初の接続でさえ怜蚌されたす — 別の䜕かがネットワヌク䞊で代わりに応答するず、コヌドの秘密が送られる前に拒吊されたす。`ygg link` を実行するたではネットワヌクポヌトを䞀切バむンドしたせん — Yggdrasil をむンストヌルしおも、これたでどおりルヌプバックにずどたりたす。 ```text ygg link --list # what's linked, and whether writes are actually arriving ygg link --sync # reconcile now, don't wait for a read ygg unlink # revoke that machine's key here ```
詳现: 䜕が送られ、䜕が残り、い぀ ygg sync を䜿うか **送られるもの:** メモリ、それらの関係、そしお削陀。**残るもの:** あなたがメモリを開いた回数ず、どのマシンで読んだか — これは知識ではなくロヌカルのランキングです。埋め蟌みベクトルも通垞はロヌカルに残りたすが、䟋倖が䞀぀ありたす: 䞡方のマシンが同じ埋め蟌みモデルを実行しおいる堎合、ベクトルも䞀緒に送られるため、蚈算甚マシンがノヌト PC の分たで埋め蟌みを行い、ノヌト PC は䞀床もモデルを動かさずに枈みたす。 **新しい線集が勝ちたす。** 二台が通信する前に、䞡方のマシンで同じメモリを線集した堎合、より新しい線集が䞡方に残りたす短い蚂正であっおも同じです。 **削陀が勝ちたす。** 䞀方のマシンでメモリを削陀し、同時にもう䞀方で線集した堎合、削陀が勝ち、線集は倱われたす。これは意図的な蚭蚈です: 「挏掩したトヌクンを削陀した」は、二぀の時蚈が食い違っおいおも成立しなければなりたせん。「考えが倉わった」ずいう意味なら、代わりにアヌカむブしおください — 䜕も倱われず、`ygg unarchive` で䞡方のマシンに戻せたす埌の刀断が勝ちたす。 **ファむアりォヌルはペアリング時に怜出されたす。** コヌドを衚瀺したマシンは、すぐにもう䞀方ぞ折り返し接続したす。そこに届かない堎合、`ygg link` がその旚を衚瀺し、そのマシンだけにポヌトを開ける 1 ぀のコマンドを出力したすufw、firewalld、Windows。その埌も `ygg link --list` ず `ygg doctor` が確認し続けたす。ピアに ✓ が衚瀺されるのは曞き蟌みが届いたず確認できたずきだけで、それ以倖の堎合ぱラヌず埅機䞭の倉曎数が衚瀺されたす。DHCP で新しいアドレスを受け取ったマシンは、次に通信したずきに再び芋぀かりたす。 **`ygg sync`gitは匕き続き存圚したす**。こちらは別の圹割を担いたす: 互いに芋えないマシン、別のネットワヌクにある職堎のノヌト PC、持ち歩いおいる USB メモリ䞊のベアリポゞトリなどです。同じネットワヌク䞊のマシンには `ygg link`、それ以倖には `ygg sync` を䜿っおください。䞡者は同じマヌゞ芏則を共有するので、䜵甚できたす。䞡方のマシンが Tailscale の tailnet 䞊にあれば、`ygg link --tailscale` でネットワヌクをたたいでも䜿えたす。 **ペアリングコヌドが誀ったアドレスを衚瀺する堎合**実際の Ethernet や Wi-Fi を、VM のブリッゞや VPN より優先したす。それでも掚枬を誀るこずがありたす、固定しおください: `ygg config set sync_host 192.168.3.152` — たたはもう䞀方のマシンでコヌドを衚瀺させおください。コヌドを入力する偎は、経路が実際に通るアドレスを垞に䜿いたす。
## 📊 数字で芋る [`eval/ygg_eval.py`](../eval/ygg_eval.py) で枬定 — メモリ 232 件、ラベル付きク゚リ 110 件、ランキングの重みは *dev* 分割のみで調敎しおいるため、**holdout こそがバむアスのない数字**ですrecall@1、`paraphrase-multilingual` モデル): | 怜玢ビュヌ | holdout recall@1 | recall@3 | 䟝存れロの字句 | | --- | --- | --- | --- | | **プロゞェクト内**実際の経路、プヌル玄 11) | **0.94** | **1.00** | 0.76 | | **ストア党䜓**フィルタなし、プヌル 232) | 0.72 | **0.87** | 0.69 | **プロゞェクト内 — あなたが実際に䜿う経路 — では、正しいメモリはク゚リの 0.94 で 1 䜍になり、毎回トップ 3 に入りたすrecall@3 = 1.00。** フィルタなしでストア党䜓を怜玢するのはより難しくなりたすrecall@1 0.72、recall@3 0.87、党 232 件にわたっお。䟝存れロの字句モヌドは、キヌワヌドずコヌド識別子のク゚リをすでに解決できたす1.00。ロヌカルモデルは意味ず蚀語暪断を加えたすcrosslingual 0.25 → 0.95。[BENCHMARKS.md の完党な内蚳](../BENCHMARKS.md)では 95% 信頌区間、プヌルサむズ、クラス別スコアを瀺しおいたす — そしお玄 1 分で再実行できたす: `python3 eval/ygg_eval.py --report`。 **コヌパスの芏暡も数字の䞀郚です。** 実際の 4,799 件のストアでは、既定の倚蚀語埋め蟌みは字句ベヌスラむンrecall@1 0.55たで萜ち蟌みたす。`bge-m3` ではそこで 0.775 を保ちたす。ストアが数千件に育぀なら `bge-m3` を遞んでください — 詳现は [BENCHMARKS.md](../BENCHMARKS.md) にありたす。 ## 🆚 Yggdrasil ず他ツヌルの比范 他のツヌルは、トランスクリプトを自動キャプチャするか、クラりドを売り぀けるかのどちらかです。Yggdrasil の賭けはこうです: **本圓に重芁な数少ないもの**だけを、厳遞・重耇排陀しお、あなたが所有する玠のレコヌドずしお保持し — それを**すべお**のツヌルずプロゞェクトで共有するこず。 | | **Yggdrasil** | 組み蟌みメモリ (Claude Code · Codex) | [claude-mem](https://github.com/thedotmack/claude-mem) | [mem0](https://github.com/mem0ai/mem0) / OpenMemory | [basic-memory](https://github.com/basicmachines-co/basic-memory) | | --- | --- | --- | --- | --- | --- | | 厳遞された決定 / 教蚓 / 状況トランスクリプトではなく) | ✅ | ⚠ 自動メモ | ❌ すべおキャプチャ | ⚠ | ⚠ 自由圢匏ノヌト | | **ツヌル暪断**の単䞀メモリ | ✅ | ❌ ベンダヌ内に閉じる | ✅ | ✅ | ✅ | | **プロゞェクト暪断**の想起「プロゞェクト B で解決枈み」) | ✅ | ❌ リポゞトリ単䜍 | ⚠ | ⚠ | ⚠ | | 既定で **100% ロヌカル** | ✅ | ✅ | ⚠ クラりド同期アドオン | ❌ ホスト型が䞻 | ✅ | | **䟝存れロ**stdlib + SQLite) | ✅ | — | ❌ Node + Bun + 垞駐ワヌカヌ | ❌ Docker + Qdrant + LLM キヌ | ❌ | | **LLM も API キヌも䞍芁**で動䜜 | ✅ | ✅ | ❌ AI で圧瞮 | ❌ | ✅ | | **完党ロヌカルのセマンティック怜玢** | ✅ オプトむンの Ollama | ❌ grep のみ | ⚠ オプションの Chroma | ⚠ API キヌか Docker スタックが必芁 | ❌ | | あなたが所有するプレヌンな **Markdown**Obsidian 察応) | ✅ | ✅ | ❌ | ❌ | ✅ | **最も近い隣人 — claude-mem:** すべおのセッションを蚘録しお AI で圧瞮する「すべおをキャプチャする」メモリですNode 20+ *ず* Bun、垞駐ワヌカヌデヌモンが必芁。Chroma はオプション)。Yggdrasil はその正反察の賭けです: 増え続ける奔流ではなく、小さく高信号なストア。**mem0** は、*アプリ*が*そのナヌザヌ*を蚘憶するための SDK + ホスト型プラットフォヌムで、セルフホストでも LLM の API キヌが必芁です。**組み蟌みメモリ**は本圓に䟿利です — そしお構造的に閉じおいたす: ひず぀のベンダヌ、ひず぀のリポゞトリ、ひず぀のマシン、文字どおりの grep。Yggdrasil はその䞀段䞊のレむダヌですそしお `ygg seed` は、たさにそのトランスクリプトから自身をブヌトストラップできたす)。たったく別のレむダヌずしお: [context-mode](https://github.com/mksglu/context-mode)ラむブなコンテキストりィンドりず [Context7](https://github.com/upstash/context7)最新のラむブラリドキュメント) — どちらも Yggdrasil ず問題なく䜵甚できたす。 ## 🧰 コマンド ゚ヌゞェントには 6 ぀の MCP ツヌルが芋えたす: `ygg_health`、`ygg_bootstrap`、`ygg_search`、`ygg_recall`、`ygg_remember`、`ygg_materialize` — プラグむンたたは `ygg install` により自動登録されたす。
ygg CLI の完党リファレンス **メモリ操䜜** | コマンド | 䜕をするか | | --- | --- | | `ygg recall --query "
"` | **プロゞェクト暪断**怜玢 — 「これをどこかでやったこずはあるか?」 | | `ygg search --project P --query "
"` | プロゞェクトに絞った怜玢`--type`、`--tag`、`--limit`、`--json`) | | `ygg remember --project P --type lesson --content "
"` | 氞続メモリを保存シヌクレット保護぀き、重耇排陀あり) | | `ygg bootstrap --project P` | 䜜業を始める前にプロゞェクトのメモリを取り蟌む | | `ygg pin --id ID` · `ygg unpin --id ID` | メモリをピン留めしお確実に衚瀺されるようにする | | `ygg supersede --id ID` | 新しいメモリが眮き換える叀いメモリをアヌカむブする | | `ygg unarchive --id ID` | アヌカむブされたメモリを戻すリンク枈みのマシンにも反映 | | `ygg materialize --id ID --project P` | 1 ぀のメモリを Obsidian ノヌトに゚クスポヌトする | | `ygg export-native --project P` | 厳遞したダむゞェストを `AGENTS.md`/`MEMORY.md` に曞き出す — Claude Code ず Codex のネむティブメモリに䟛絊する | | `ygg import --from TOOL --path P` | 他のメモリツヌルのストアを Yggdrasil に移行する`mcp-memory`、`basic-memory`。たず `--dry-run` を) | | `ygg review [--apply]` | ガバナンスキュヌを凊理する — 重耇を統合し、叀い/矛盟するメモリにフラグを立おるアヌカむブのみ、取り消し可胜) | | `ygg delete --id ID` · `ygg reset 
` | 1 ぀のメモリを完党削陀する · 倱敗した `ygg seed` を䞀括取り消しする芁確認) | **コヌルドスタヌト** | コマンド | 䜕をするか | | --- | --- | | `ygg seed` | Claude Code + Codex のトランスクリプト、Obsidian vault、`CLAUDE.md` リポゞトリを蒞留 — 増分的・重耇排陀枈み・完党ロヌカル | | `ygg seed --dry-run` · `--force` | 発芋ず芋積もりのみ · すべおを再蒞留 | | `ygg link` · `ygg link ` | **自分の**2台のマシンを同䞀ネットワヌク䞊で盎接リンク — ラむブで共有されるメモリ、ピン留めされた TLS、䞭継なし | | `ygg link --list` · `ygg unlink ` | リンク枈みのマシンを衚瀺 · 1 台の接続を取り消す | | `ygg distill --source PATH` | 1 ぀のディレクトリ/ファむルを教蚓ぞ蒞留 | | `ygg reindex` | 欠けおいる埋め蟌みを補完密な想起を埩元) | **サヌビスずセットアップ** | コマンド | 䜕をするか | | --- | --- | | `ygg install` · `ygg doctor` · `ygg update` | ガむド付きセットアップ · 実行可胜な修正぀きの蚺断 · アップグレヌド | | `ygg config` | 氞続的な蚭定の衚瀺/倉曎`list` · `get` · `set` · `unset`) | | `ygg status` · `start` · `stop` · `restart` · `logs` | 垞時皌働デヌモンを管理 | | `ygg hooks` · `unhooks` · `register` | SessionStart フックの有効化/無効化 · MCP の(再)登録 | | `ygg recommend` · `token` · `uninstall` | モデルカタログ · 認蚌トヌクンの衚瀺 · すべおを削陀 | 人栌を䞎えたしょう — `~/.yggdrasil/identity.json` を線集したす: ```json { "name": "Jarvis", "persona": "concise, proactive, dry wit", "user_facts": ["prefers TypeScript", "ships small PRs"] } ``` シヌドが重く、ラップトップが非力? 蒞留凊理を LAN 䞊の*どんな*マシンにでも向けられたす — Ollama、LM Studio、llama.cpp を動かすデスクトップ、**ロヌカル LLM サヌバヌアプリを動かす iPhone でも構いたせん**: `ygg config set distill_url http://:11434`。Yggdrasil は API の方蚀Ollama か OpenAI 互換かを自動刀別したす。デヌタがあなたのネットワヌクの倖に出るこずは倉わらずありたせん — 詳现は [docs/ygg-cli.md](../docs/ygg-cli.md) を参照しおください。
## ❓ よくある質問
Claude Code にはすでに組み蟌みメモリがありたす — なぜ Yggdrasil が必芁? 組み蟌みメモリはベンダヌごず・リポゞトリごず・マシンごずに閉じおおり、取り出しは文字どおりのテキスト䞀臎です。Yggdrasil はその䞀段䞊のレむダヌです: Claude Code、Codex、あらゆる MCP ホストで*同じ*メモリ、プロゞェクトを*たたいだ*想起、オプションのセマンティック怜玢 — それでいお 100% ロヌカル。䞡者は組み合わせられたす: ネむティブのメモリはそのたたに、`ygg seed` に既存の履歎を蒞留させお共有の頭脳に取り蟌みたしょう。
コヌドやメモリをクラりドに送信したすか? いいえ。゚ンゞン、デヌタベヌス、オプションのモデルはすべおロヌカルで動䜜したす。アカりントもテレメトリもありたせん。唯䞀の倖向き通信は PyPI ぞのバヌゞョンチェックです。 `ygg link` で自分の 2 台のマシンをリンクするず、メモリは自分のネットワヌク䞊で**その 2 台のマシンの間**を移動したす — 盎接、固定蚌明曞による TLS で、䞭継もこちらのサヌバヌも経由せずに。そのコマンドを実行するたでは、ルヌプバックより倖で埅ち受けるものは䜕もありたせん。
悪意のあるリポゞトリがメモリに指瀺を仕蟌めたすか? 想起されたメモリは、*指瀺ではなく参考メモ*ずしお明確に枠付けされお泚入されたす。各メモが由来する堎所ず、別のプロゞェクトに属する堎合の目印も添えられるため、゚ヌゞェントはそれをデヌタずしお扱い、そこに含たれるものに基づいお行動する前に確認を求めたす。シヌクレットは蒞留の前にトランスクリプトから削陀され、曞き蟌み時には拒吊されたす。それでも、メモリは曞き蟌たれた内容ず同じ皋床にしか信頌できたせん — ずきどき `ygg review` を確認しおください。
すべおを自動的に蚘憶したすか? いいえ — 意図的な蚭蚈です。取り出しは自動ですが、*曞き蟌み*は意図的です゚ヌゞェントは氞続的な教蚓のために `ygg_remember` を呌び出したす)。すべおをキャプチャするずメモリが汚染されトヌクンを浪費するため、そうはしたせん。オプションのバックグラりンドモデルは、すでに保存枈みのものを統合したす提案のみ)。
GPU や API キヌは必芁ですか? いいえ。既定は玔粋な字句怜玢です — 䟝存れロで即時。セマンティック怜玢はオプトむンで、Ollama 経由の*ロヌカル*モデルを䜿いたす。むンストヌラヌがあなたのハヌドりェアに適合するモデルを掚奚したす。
どれくらい重く、トヌクンはどれくらいかかりたすか? ゚ンゞンのアむドル時は **RAM 箄 21 MB**字句怜玢の既定、CPU 箄 0%。ディスクはメモリ 1 件あたり数十 KB です。セッション開始時に玄 300 トヌクンが泚入され、各ツヌル呌び出しは小さな抜粋を返したす。重い凊理むンデックス䜜成、埋め蟌み、統合はすべお LLM の倖偎、あなたのマシン䞊で実行されたす。
メモリを手䜜業で線集・削陀できたすか? はい。メモリは Obsidian vault 内の Markdown ノヌトずしお具珟化されたす — 他のファむルず同じように読んだり、線集したり、削陀したりできたす。ガバナンスずレビュヌは䜕も削陀したせん — アヌカむブするだけで、これは取り消せたす。完党削陀は、あなたが明瀺的に `ygg delete` を実行したずきだけ行われたすリンクされたマシンでは、その削陀は䞡方に及びたす。
## 🚊 ステヌタスずロヌドマップ **アルファ版です。** ハッピヌパスずガバナンスルヌプはゲヌトテスト枈みです`scripts/run_gates.sh`)。マルチナヌザヌや本番甚途向けにはただ堅牢化されおいたせん。珟圚は macOS 察応で、Linux/Windows のサヌビスむンストヌラヌは実装枈み・デバむス䞊での最終テスト䞭です。 最近リリヌスされたもの: 🔗 マシン間のメモリ共有`ygg link`· 関係グラフ`ygg relate`: `solves` / `supersedes` / `contradicts`。 次の予定: 🛰 サヌフェス暪断の同期CLI・Web・スマヌトフォンをたたぐ単䞀のメモリ — HTTP ファサヌドは導入枈みで、[docs/cross-surface.md](../docs/cross-surface.md) を参照 · 🐧 Linux/Windows の GA。 ## 🀝 コントリビュヌト Issue や PR を歓迎したす。提出前に `scripts/run_gates.sh` ず `python3 -m unittest discover -s tests` を実行しおください — すべおのゲヌトがグリヌンを保぀必芁がありたす。 ## 📜 ラむセンス **GNU AGPL v3.0** — [LICENSE](../LICENSE) を参照しおください。自由なオヌプン゜ヌスです: 䜿甚・改倉・セルフホスト・再配垃が可胜です。改倉する堎合、たたはネットワヌクサヌビスずしお提䟛する堎合は、同じラむセンスで゜ヌスコヌドを公開する必芁がありたす。