githippo

Claude はコンテキストが圧縮されるとすべてを忘れてしまいます。
githippo は忘れません。

Claude とあらゆる MCP クライアント向けの長期記憶です。あなたが所有する git リポジトリに、プレーンな Markdown として保存されます。ハイブリッドなセマンティック検索、ナレッジグラフ、自動メモリー、コンテキスト圧縮後の記憶維持を備え、1 ターンあたりのツールオーバーヘッドは約 790 トークンです。すべての記憶は、読んだり、差分を確認したり、元に戻したりできる git コミットです。

curl -fsSL https://raw.githubusercontent.com/AnxovatomicaES/githippo/main/install.sh | sh

インストールはこれだけです。アカウントも、トークンも、質問も不要です。ローカルのメモリーボルトをセットアップし、Claude Code（フック、MCP、ステータスライン）を接続して、セマンティック検索をバックグラウンドで取得します。Claude Code を再起動して、あとは普通に話しかけてください。記憶してくれます。

バックアップを取り、複数のマシン間で同期したいですか？githippo sync --github を実行すると、既存の GitHub CLI ログインを使ってプライベートリポジトリを作成し、変更のたびにプッシュします。まず試してみたいですか？npx -y github:AnxovatomicaES/githippo#v3.9.3 demo を実行すれば、何もインストールせずに 30 秒で動作を確認できます。

_{ワンクリックで → claude.ai やスマートフォンから利用できます}

なぜ、また新しいメモリーサーバーを作ったのですか？

世の中にある優れたアイデアは、それぞれ別のツールに分かれているからです。githippo はそれぞれの優れた点を取り入れ、使いづらい部分を改善します。

そのほかの機能：

• コンプライアンスガード。 秘密鍵（PGP を含む）や API トークン（Anthropic、OpenAI、GitHub、AWS、Slack、Stripe、Google、SendGrid、npm、Hugging Face、JWT）、パスワードやシークレットの代入（password: …、DB_PASSWORD=…、AWS_SECRET_ACCESS_KEY=…）、パスワードが埋め込まれた接続文字列、カードのセキュリティコード、IBAN（mod-97 で検証し、スペースやハイフンにも対応）、カード番号（Luhn アルゴリズムで検証し、隣接する数字がほかにあっても検出）、スペインの DNI/NIE、フランスの NIR（チェックサムを検証）、英国の国民保険番号（大文字表記）、米国の SSN が git の恒久的な履歴に残る前にブロックします。見た目が似た文字、ほかの文字体系の数字、ゼロ幅文字を読み取り、「password: required」、「tokens: 128000」のような通常の文章や「12/10/26」のようなスペイン式の日付には反応しません。また、不透明な Authorization: Bearer/Basic ヘッダー、GitLab、Google OAuth、Slack、Discord の Webhook トークンやボットトークン、Telegram、Twilio、Mailgun、Azure、Shopify、PyPI、DigitalOcean のトークン、STRIPE_KEY= 形式の環境変数行、PIN、引用符付き JSON、Markdown の太字、「the password is …」形式のパスワードも検出します。base64 でエンコードされたもの、単語の途中で分割されたもの、URL エンコードされたものは検出できません。これは最後の防御策であり、DLP ではありません。
• コンパクションに耐える設計を 3 つの方法で実現しています（詳細は以下をご覧ください）。
• 言語をまたいだ想起。 デフォルトの多言語エンベッダーはローカルで実行されます。スペイン語で質問して、英語で書かれたメモを見つけられます。
• 更新が重複と誤認されることはありません。 「ローンチは第 1 四半期末」と「第 2 四半期末」は、ほぼ同じようにエンベッドされます。githippo は数字、日付、名前も比較するため、更新内容は保存され、古い行にはフラグが付き、maintain が矛盾の可能性を報告します。測定結果はdocs/calibration.mdをご覧ください。各事実に、もう一方にはない内容語が 1 つある場合（「暗い」／「明るい」、「毎週」／「毎月」、「読み取り」／「書き込み」）、どちらも重複とは判定されません。キーワードの一致度もエンベッディングも、類義語と反対の意味を区別できないためです。新しい事実は保存され、更新の可能性を示すフラグが付き、maintain はその組み合わせを矛盾の可能性として一覧表示します。（このルールが導入される前は、このような 12 組のうち半数がキーワードモードでひそかに削除されていました。）
• 楽観的同時実行制御。 同じメモリを 2 つのセッションが編集しても互いの変更を上書きしません。競合した側には最新のファイルが返され、それをマージできます。

圧縮を越えて、3 層で記憶を保持

Claude Code が長いセッションを圧縮すると、会話が要約され、細部は失われます。githippo は大切な情報を確実に残します。

flowchart LR
  A[Context fills up] --> B[PreCompact hook]
  B -->|parse transcript, no LLM| C[checkpoint: goal, todos, files, where it stopped]
  C --> D[(local ~/.githippo)]
  C --> E[(repo sessions/)]
  F[Compaction] --> G[SessionStart hook, source=compact]
  D --> G
  G -->|injects the state itself, not a reminder to read it| H[Claude continues exactly where it stopped]
  I[MCP instructions + core memory] -.->|system prompt, never compacted| H

1. システムプロンプト内のコアメモリ。 MCP サーバーの指示は会話の一部ではないため、圧縮の影響を受けません。ピン留めした事実は、どの MCP クライアントでも常に参照できます。
2. フックによるチェックポイント（Claude Code）。よくある不満として、状態ファイルを再読込するよう Claude に促すだけの圧縮後フックは、うまくいくこともあれば、いかないこともあります。githippo は内容を直接挿入します。チェックポイントは約 900 トークンに制限されています。セッションがその量を超える場合は、価値の低い情報から順に削除します（以前の要約、コマンド、古い依頼、完了したタスク）。目標、未完了のタスク、停止した箇所は決して削除しません。
3. checkpoint ツール（claude.ai を含む、すべてのクライアント）。Claude は節目ごとにタスク、状態、次のステップを保存します。コンテキストを失った後は、引数なしで checkpoint を実行すると復元できます。

さらに、同じプロジェクトとブランチで 24 時間以内に新しいセッションを開始すると、「前回は…」という簡単なメモが表示され、以降に Git で発生した変更（コミット、他のユーザーによるコミット、ブランチの切り替え、削除されたファイル）も含まれます。UserPromptSubmit フックは、一致の確度が高い場合に、関連性の高いメモリを最大 3 件、先回りして提示します。300 トークンに制限されており、些細なプロンプトは対象外で、セッション内で同じ内容を繰り返すことはありません。プロンプト内にある、ボールトが一度も見たことのない単語は、一致度の判定で不利に働きます。そのため、「refactor」や「use」など、メモと共通する一般的な単語が 2 つあるだけの通常のコーディング用プロンプトでは、メモリは提示されません。1,000～10,000 件のメモを使ったテストでは、関連のないコーディング用プロンプト 20 件のうち挿入が発生したものはなく、意図的に用意した質問 40 件ではすべて、適切なメモが提示されました（test/report6-hook.test.js）。圧縮の前には、githippo は圧縮処理に保持すべき内容も伝えます。圧縮後は、圧縮処理が生成した要約をチェックポイントとともに保持します。

フックが説明どおりに動作することは、どのように確認しているのでしょうか。仕様は Claude Code 自身のコード（2.1.258）から確認しました。PreCompact は、成功した各フックの標準出力をカスタム指示として圧縮処理に渡します（Claude Code も、そのテキストをトランスクリプトに「PreCompact … completed successfully」と表示します）。PostCompact は compact_summary を受け取ります。すべてのフックは session_id、transcript_path、cwd を受け取ります。SessionStart のソースは startup、resume、clear、compact、fork です。

リコール機能は、実際に使用する情報も学習します。Claude に繰り返し渡されるメモリには小さな加点が加わります（キーワードスコアは最大 +40%、セマンティックスコアは最大 +10%）。使用されない場合、この加点は 30 日ごとに半減します。加点は生のスコアに適用されるため、順位が入れ替わるのはほぼ同点の結果だけです。明確に一致する結果が 1 位から押し出されることはありません（以前のバージョンではランク統合後に適用していたため、そのようなことがありました。test/report6-ranking.test.js を参照してください）。使用回数はユーザーごとに管理され、マシン上に保存されます。使用データがない場合、ランキングは使用データがない場合とまったく同じです。

<private>…</private> で囲んだ内容はメモリに保存されません。開始タグを閉じ忘れると、その後のすべてが非公開になります。また、remember は事実を保存せず、その理由を伝えるため、隠すつもりだった一部だけが黙って保存されることはありません。ファイルを編集せずにフックをオフにできます。GITHIPPO_HOOK_PROFILE=minimal または GITHIPPO_DISABLED_HOOKS=prompt,steer を設定してください。

品質の測定結果（および未測定の項目）

小規模なラベル付きセット（52 件のクエリ）と LongMemEval-S（500 件の質問、検索のみ、LLM なし）での検索結果：

最初の結果は githippo eval で再現できます。手法、言語別の内訳、分類と重複の精度、メモリ使用量、規模の数値は docs/benchmarks.md にあります。このセットは小規模で、作者が手作業で作成したドメイン内のものです。回帰チェックと大まかな目安としてお使いください。リーダーボードではありません。

まだ測定されていない、最も重要な数値： githippo を使うことで、回答の質が上がるのか、またはセッションのコストが下がるのかという点です。eval/qa.js と eval/behavior.js はまさにそれを測定するために用意されていますが、実行には ANTHROPIC_API_KEY が必要で、まだ実行されていません。実行されるまでは、「トークンを節約する」とは、各ターンに一定のコストが加わり（下記）、想起した事実によって説明し直したり再発見したりする手間が省けた場合にのみ、そのコストを取り戻せるという意味で捉えてください。実行した場合は、結果を issue #3 に投稿してください。

githippo を使うべきですか？

• Claude の組み込みメモリは、設定不要の選択肢です。自分で読んだり、差分を確認したり、Obsidian で編集したり、バックアップしたりできるファイルとしてメモリを保持したい場合、Claude Code、Claude Desktop、claude.ai、その他の MCP クライアントで同じメモリを使いたい場合、または Claude Code のコンテキスト圧縮後もメモリを保持したい場合は、githippo をお使いください。
• basic-memory は最も近い代替製品です。こちらも Markdown 形式で Obsidian と相性がよく、より成熟しており、Python 製で、AGPL ライセンスです。githippo との違いは、Git の履歴と時間を遡る機能、コンテキスト圧縮フック、フォルダー権限付きの OAuth チーム保管庫、シークレットガードです。
• mem0 などのホステッドサービスは、LLM で事実を抽出してクラウドに保存するため、実行するものはありません。githippo は事実の保存に LLM を呼び出すことはなく、すべてを自分が所有するリポジトリ内に保持します。
• 新しいプロジェクトです。 githippo はメンテナーが 1 人のプロジェクト（最初のコミットは 2026 年 10 月）で、見知らぬ利用者による大規模な運用実績はまだありません。ベンチマーク、200 件以上のテスト、毎晩実行するシード付きファザー、5 回の監査で見つかった問題（test/report*.test.js：各問題をまず再現し、その後、回帰テストを追加して修正）、リリースノートを公開していますので、ご自身で評価できます。ただし、まだ粗削りな部分があることをご了承ください。

Claude ネイティブ機能（オプトイン、測定済み）

最後の3つは実行ごとに API クレジットを消費するため、オプトインになっており、結果はまだこの README に掲載していません。

トークン予算（githippo bench で測定）

方法：簡潔なスキーマ、tools/list から冗長な $schema URL を削除、整形済み JSON の代わりにコンパクトなテキストレスポンス、ウィキリンクを通常の単語として表示、フロントマターを削除、8文字のバージョンハンドル、デフォルトでは History／index／sessions／core を想起対象から除外、すべてのパックにトークン予算を設定しています。

最悪の場合、1ターンあたりにかかるのは、ツールスキーマ約790 ＋ 指示約200 ＋ コアメモリ最大400（CORE_BUDGET_TOKENS）で、約1,400トークンです。これに、プロンプトごとのフックが確度の高い一致を見つけたプロンプトでは最大300トークンが加わり、さらに recall の返却分（mode=brief では約47トークン、デフォルトのパックでは最大1,000トークン）が加わります。スキーマ、指示、コアは安定したプレフィックスなので、プロンプトキャッシュを使うクライアントでは、実際のカウントより少なくなります。githippo は導入するだけでトークンを節約するわけではありません。想起した事実によって、何かを再説明したり再発見したりする必要がなくなるときに、トークンを節約します。

時間面でも、フックはすべてのプロンプトの前に実行され、ステータス行は常時表示されるため、起動処理を最小限に抑えています（サーバーコードは読み込みません）。開発マシンでの githippo bench の報告値は、フックが約57 ms、ステータス行が約60 msで、node 単体の39 msと比べるとこの値です。サーバーのインポートを遅延読み込みにする前は125 msでした。githippo bench を実行して、ご自身の環境で確認してください。

ツール

セットアップ

プラットフォーム：Linux と macOS は変更のたびに CI でテストしています。Windows はまだサポートされていません（動作しない理由は docs/platforms.md を参照）。WSL では Linux と同様に動作するはずです。

Claude Code（フル機能：フック ＋ MCP）

curl -fsSL https://raw.githubusercontent.com/AnxovatomicaES/githippo/main/install.sh | sh

実行内容を確認したい場合は、短いシェルスクリプトを使ってください。Node 20 以降を確認し、npm i -g github:AnxovatomicaES/githippo#v3.9.3 を実行してから、githippo setup を実行します。setup は何度実行しても安全で、すでに設定されているステータス行を保持し、変更前に ~/.claude/settings.json のバックアップを作成します。その後、githippo doctor ですべてをチェックできます（チェックに失敗すると、ゼロ以外の終了コードを返します）。githippo uninstall はフック、ステータス行、MCP エントリを削除し、メモリには手を加えません。githippo <command> --help で各コマンドの説明を確認でき、オプションを誤入力すると実行せずに候補を提示します。

公式のリファレンスメモリサーバーから移行する場合は、githippo import ~/path/to/memory.jsonl を実行すると、エンティティ、観察事項、関係をメモと型付きリンクに変換できます（シークレットの保護と重複排除が適用されるため、再実行しても安全です）。 プラグイン経由で使う場合：上記のインストール手順を実行して（githippo コマンドをインストール）、次に /plugin marketplace add AnxovatomicaES/githippo と /plugin install githippo を実行してください。プラグインがフックと MCP サーバーを提供するため、githippo setup／githippo install はプラグインを検知し、重複して追加しません（以前はすべてのフックが二重に実行されていました）。すでに両方を導入している場合は、githippo uninstall を実行し、プラグインを残してください。または、エージェントに INSTALL_FOR_AGENTS.md を渡してください。

githippo sync --github            # creates a private repo "githippo-memory" with your gh login

githippo users add john --acl "shared/:write,people/:read"   # prints his password once
githippo users list

プレーンな Markdown で、Obsidian と互換性があります。リポジトリを保管庫として開けば、グラフビューをそのまま利用できます。

---
name: billing-v2
title: Billing v2
type: project
description: Billing rewrite
aliases: [billing rewrite]
---

## Decisions
- Use idempotency keys on every write endpoint
- owner:: [[sam-okafor]]
- Launch target is end of Q1

## History
- ~~Launch target is end of Q4~~ (until 2026-09-30)

構成：core.md（固定）、index.md（目次）、inbox.md（振り分け前の事実）、people/、projects/、topics/、decisions/、sessions/（チェックポイント）。examples/memoryを参照してください。

ノート名には、スペース、アクセント記号、あらゆる文字体系を使用できます（my notes.md、café.md、笔记.md）。そのため、Obsidian と同期した保管庫をそのまま使用できます。どこでも安全でない名前（制御文字、\ < > : " | ? *、隠しファイル名）のみ拒否されます。フロントマターは信頼できない入力として扱われます。異常な値（title: []、巨大なフィールド、__proto__）によって検索が壊れることはなく、読み取れないノートがあっても、メモリ全体を停止させるのではなく、警告を出してそのノートをスキップします。未解決の git コンフリクトマーカーを含むノートは、インデックス登録も書き込みもされません。また、マージまたはリベースが完了していない間、githippo は書き込みを拒否します。

設定

どの設定にも共通するルールは、環境変数、次に ~/.githippo/config.json、最後にデフォルト値の順で適用することです。多くの方が変更する設定は、VAULT_DIR（デフォルトは ~/.githippo/vault）、EMBEDDINGS（local、static、voyage、none のいずれか）、GITHIPPO_CONFIRM（auto、strict、off のいずれか）、PROMPT_RECALL=0（プロンプトごとのフックを無効化）です。リモートサーバーやチーム用保管庫の環境変数を含むその他すべての設定については、docs/configuration.mdを参照してください。

セキュリティモデルについて、率直に

• ファイルもデータも、あなたのものです。 githippo にはバックエンドがありません。メモリはお使いのマシン上のフォルダーに保存され、バックアップ先はご自身が所有するプライベートリポジトリです。githippo は、バックアップ先のリモートが誰でも読み取れる状態かどうかを匿名で GitHub に問い合わせます。公開状態の場合、githippo doctor は失敗し、githippo sync はそこへプッシュせず、バックグラウンドのプッシュも拒否します（意図的に許可するには GITHIPPO_ALLOW_PUBLIC_BACKUP=1 を設定します）。確認できるのは GitHub のリモートだけです。別のホストの場合は、リポジトリの公開設定をご自身で確認してください。
• ローカルでの使用にはトークンを保存しません。 同期には git の既存のログイン情報（GitHub CLI、SSH、またはキーチェーン）を使用します。トークンが必要なのはリモートサーバーだけです。対象を1つのリポジトリに限定し、Contents の読み書き権限だけを持つ、きめ細かなトークンを作成してください。
• リモート認証には OAuth 2.1 を使用します（PKCE S256 のみ、動的クライアント登録、1回限りのコード、/mcp リソースおよびユーザーの現在のパスワードと ACL に紐付けられたトークン）。リフレッシュトークンはローテーションされます。各トークンは1回だけ使え、使用済みのトークンを提示すると（コピーされた兆候と見なされます）、そのサインインに関連するすべてのトークン（アクセストークンを含む）が無効になります。認可コードを再利用した場合も同様です。署名はステートレス（HMAC）なので、再起動してもログアウトされません。以前の URL 内シークレット方式（/mcp/<secret>）は、URL がプロキシログに残るため、LEGACY_SECRET_URL=1 を設定しない限り無効です。サーバーは不正なリクエストを受け取っても停止せずに 400 を返し、すべての本文を検証し、ログイン失敗の繰り返しを制限し、1回の呼び出しあたりの JSON-RPC バッチ数を上限管理してカウントし、ソケットアドレスごとにレート制限を適用します。
• ガードは最後の砦であり、DLP ではありません。 よくあるシークレットや ID の形式を検出します。forget は現在のファイルから行を削除しますが、git の履歴には残ります。完全に削除するには、履歴を書き換える必要があります。
• フォルダー権限は細工にも耐えます。 チームボールトのパスは一度だけ正規化され、権限チェックとストアで同じパスが使われるため、空白、不可視文字、..、大文字と小文字を区別しないディスクでの大文字と小文字の違い（macOS と Windows による ſ、ß、fi の折りたたみ方も含む）を悪用してルールをすり抜けることはできません。index.md には、各閲覧者が読み取りを許可されたメモだけが表示されます。また、読み取り可能な2つのメモが同じ名前を主張している場合、推測はせず、その事実を受信箱に送ります。他のユーザーの users/<id>/ フォルダーは、すべてに適用されるルールの対象外です。
• コアメモリは最も信頼度の高いテキストなので、書き込み口は1つだけです。 ツール経由で書き込めるのは pin のみです（クライアントが対応している場合は確認を求め、外部ソースからの事実は拒否します）。remember about:"core" や files ツールからは書き込めません。外部ソースに由来する行はコアメモリに読み込まれず、読み込み対象のトークン予算には厳格な上限があります。
• リモートセッションでは確認を求められません。 確認には MCP のエリシテーションを使いますが、ステートレスな HTTP リクエストには確認を行うチャネルがありません。そのため、リモートサーバーでは GITHIPPO_CONFIRM=auto を設定しても確認は行われません。外部ソースからの事実、コアメモリへのピン留め、削除を未確認のまま許可せずに拒否したい場合は、そこで GITHIPPO_CONFIRM=strict を設定してください。
• 誰でも任意の名前で OAuth アプリを登録できます。 動的クライアント登録はオープンです（claude.ai はこの方法で接続します）。そのため、サインインページにはブラウザーの次の遷移先が表示され、開始した接続であることを確認してから続行するよう案内されます。
• 外部のテキストはデータとして扱います。 Web ページ、ファイル、ツール出力から得られた事実には [external] のマークが付けられ、移動、書き換え、統合後もそのマークが保持されます。AI に向けた指示のように読めるテキストは拒否されます（書き込み経路すべて、つまり remember、files ツール、メモリツール、LLM による書き換えで検査します。書かれたままの状態と、想起時に表示される状態の両方を確認するため、コメント、リンクの別名、不可視文字で隠すこともできません）。この検査はよくある言い回しを対象とするヒューリスティックであり、保証ではありません。言い換えは通過するため、コアメモリには専用の書き込み口があり、外部の事実にはマークが付けられています。チェックポイントではこの種のテキストが無害化され、セクションを偽造することはできません。
• Git の状態を尊重します。 githippo は、開始したマージやリベースに干渉せず、コンフリクトマーカーをコミットすることもありません。また、bisect の実行中、detached HEAD、リンクされた worktree は「ビジー」として扱い、その旨を通知します。
• フックがセッションを妨げることはなく、githippo が PATH 上になくても動作します。 失敗時はすべて、短いタイムアウトの後に終了コード 0 で終了します。macOS と Linux では、setup が node と githippo の絶対パスをフック、ステータス行、MCP エントリーに書き込みます。そのため、Claude Desktop や IDE から Claude Code を起動した際にシェルより PATH が短くても動作します。node の場所が変わっている場合は、PATH 上の node、次に githippo を試します。どちらも実行できない場合（githippo がアンインストールされている場合）は何もしません。移動または再インストール後に githippo setup を再実行すると、以前のエントリーが更新されます。また、固定されたパスが存在しない場合は githippo doctor が通知します。（Claude Code プラグインのフックは、引き続き PATH 上から githippo を探します。）
• 既知の制限事項。 .mcpb バンドルにはまだコード署名がありません。削除した事実は、履歴を書き換えるまで git の履歴に残ります。また、回答品質への効果はまだ測定されていません（上記を参照）。

開発

npm ci && npm test      # 200+ tests: unit, hooks, adopted features, bug regressions, local vault, setup, end-to-end over Streamable HTTP with the official MCP client
npm run fuzz            # seeded fuzzing of every entry point (FUZZ_SEED=<n> FUZZ_ITERATIONS=<k> to reproduce or go deeper); runs nightly in CI with a fresh seed
npm run bench           # token cost of the tool surface
node scripts/versions.mjs   # every version string and pinned tag agrees (CI and the release check this)

ロードマップ

署名付き.mcpbリリース · チームのボールト向けOAuth IDプロバイダーとしてのSSO（GitHub／Google） · 50,000件を大幅に超えるノートを保存するボールト向けの、任意で生成できるSQLiteインデックス · Claude Codeで標準搭載されたらMCP Apps（チャット内メモリブラウザー） · ClaudeのクライアントがMCPサンプリングを宣言するようになった場合はMCPサンプリング（Claude Code 2.1.302が宣言しているのはrootsとelicitationのみであるため、統合とコンテキスト検索には引き続きANTHROPIC_API_KEYが必要です）

MITライセンスです。PRを歓迎します。