Edith Second Brain

Edith セカンドブレイン

AI のためのセカンドブレイン。

edithapp.ai · macOS 版をダウンロード · VS Code 拡張機能

Edith は、Claude が読み書きできる、ローカルのプレーンな Markdown ナレッジベースです。Claude に過去のセッションを振り返るよう頼むと、Claude 自身が内容を整理してリンク付きのノートにまとめます。API キーもアカウントも不要で、独自の推論も行いません。

Claude session ──MCP──▶      Edith.app      ──▶  the graph lights up
                              │
                              └── vault/notes/*.md

できること

• API キー不要。アカウント不要。推論なし。 Claude は、すでに利用料金を支払っているプランの範囲内で、自身のセッションを通じてノートを読み書きします。Edith は保存場所であり、キャンバスです。
• Claude が代わりに入力します。 「最近のセッションを振り返って、残す価値のあるものを保存して」と頼むと、Claude は list_sessions / read_session でトランスクリプトを読み、save_note でノートを書き戻します。
• MCP 経由で Claude に提供します。 search_brain、read_note、list_notes、save_note を使えます。セッション中に Claude はブレインから読み取ることも、ブレインに書き込むこともできます。
• 取得内容を確認できます。 検索すると、Claude が「検討した」ノートが淡く光ります。ノートを開くと、実際に「使用した」ノートが明るく光ります。ハイライトは 30 秒後に消えます。
• セッションの横に表示するミニモード。 Edith を最小化すると、画面左端にドッキングした細いパネルになり、ブレインを表示して Claude が参照するノートを光らせます。ウィンドウとパネルが同時に表示されることはありません。ウィンドウを閉じるか最小化すると、Claude のセッション開始時にパネルも自動で開きます。フォーカスを奪うことはなく、レールと同じ幅の細いバーに折りたたむか、隅に小さな四角形として縮小できます。どちらもライブグラフだけを表示します。パネルを閉じると、そのセッションの残りの間は閉じたままです。自動で開く機能は 接続 からオフにできます。
• 自分のコンテンツも取り込めます。 コンテンツを追加 では、.md、.markdown、.txt、.mdx ファイルや、貼り付けた内容をインポートできます。ファイルの既存のフロントマターは保持されるため、Markdown ボルトをインポートしてもノートが重複せず、ID とリンクがそのまま保たれます。書かれた内容のままインポートするか、概念にまとめられます。
• プレーンな Markdown。 ディスク上のファイルが信頼できる唯一の情報源です。どのエディターでも編集できます。インデックスを削除すると、自動的に再構築されます。

インストール

Edith は Apple Silicon 搭載の Mac で動作し、macOS 13 以降が必要です。また、 ターミナルまたは VS Code 拡張機能で Claude Code を使用できる必要があります。

Edith をダウンロード — Apple による署名と公証を受けているため、セキュリティ警告なしで開けます。.dmg を開き、Edith を「アプリケーション」にドラッグして、そこから開きます。すでに起動中の Claude Code セッションがあれば、再起動してください。

Windows をお使いですか？ Windows 版は Edith-Windows にあります。

VS Code で使う

Edith 拡張機能 は、エディター内で Edith を MCP サーバーとして登録するため、mcp.json を記述したり、ポートを調べたりする必要はありません。

code --install-extension raghavchari.edith-second-brain

起動中のアプリを検出し、エディターにライブ接続を渡します。エディターがサーバーを起動しようとしたときに Edith が起動していない場合は、拡張機能から起動できます。ソースは vscode-extension/ にあります。

Edith は、公式 MCP レジストリにも io.github.Rchari1/edith-second-brain として登録されているため、レジストリを参照するクライアントは、この手順を使わなくても Edith を見つけられます。

または自分でビルドする

Node.js 22.12 以降と、ネイティブデータベースモジュール用の Xcode コマンドラインツール （xcode-select --install）が必要です。

git clone https://github.com/Rchari1/Edith-SecondBrain.git
cd Edith-SecondBrain
npm install
npm run dist

.dmg は release/ に出力されます。自分でビルドしたものは公証されていませんが、自分のマシンでコンパイルしたものは macOS が信頼するため、そのまま開けます。

初回起動時の動作

Edith は 127.0.0.1:4319 でブレインサーバーを起動し、Claude に接続します。アカウントも API キーも必要ありません。Claude に 「最近のセッションを確認して、保存する価値のあるものを保存して」 と頼めば、ブレインへの登録は Claude が行います。

自身のフォルダーの外では、Edith は次のものを追加します。

内容	場所
Claude がブレインにアクセスできるようにするサーバーエントリー	~/.claude.json。Claude Desktop をお使いの場合は、その設定ファイルにも追加されます
ブレインの存在を Claude に知らせるセッション開始フック	~/.claude/settings.json
/edith コマンド	~/.claude/skills/edith
スターター用のスキル一式	~/.claude/skills/。Skills パネルから管理します

メモは ~/Library/Application Support/Edith/vault にプレーンな Markdown 形式で保存されます。

更新

cd Edith
git pull
npm install
npm run dist

Edith を終了し、新しいビルドを Applications にドラッグして、古いものと置き換えてください。

トラブルシューティング

• Edith を開くとすぐに終了します。 VS Code のターミナルから起動した場合は、代わりに Applications または Dock から開いてください。VS Code のターミナルは、アプリの起動を妨げる環境変数を設定します。
• Claude がブレインをまったく使いません。 Edith の初回起動後に Claude Code を再起動し、Edith の Connection を開いて、セッションプライマーがインストール済みと表示されていることを確認してください。

アンインストール

Edith を終了し、Applications から削除してください。続いて、追加されたものを削除します。~/.claude.json の mcpServers の下にある edith エントリー、コマンドが # edith:session-context で終わる ~/.claude/settings.json のフック、~/.claude/skills/edith フォルダー、および不要になったスターター用スキルを削除してください。~/Library/Application Support/Edith を削除するまでは、メモはそのまま残ります。

動作の仕組み

段階	動作
監視	~/.claude/projects を chokidar で監視し、セッションが落ち着くのを待ちます
解析	leafUuid をたどって放棄された分岐を除外しながら、JSONL を標準形式の Session に変換します
保存	Markdown と YAML のフロントマターで保存し、SQLite FTS5 でインデックスを作成します
提供	プロセス内の MCP サーバーをローカル HTTP 経由で提供します
点灯	すべてのツール呼び出しで、レンダラーにイベントを直接送信します

Claude が利用できるツール

ツール	機能
search_brain	メモを検索します
read_note	1 件のメモを全文読み込みます
list_notes	ブレインに保存されている内容を確認します
save_note	洞察をブレインに書き戻します
list_sessions	過去の Claude セッションと、すでに記録されているセッションを確認します
read_session	ツールのノイズを取り除いたトランスクリプトを 1 件読み込みます

最後の 2 つのツールにより、プラン内で、どこにもキーを設定せずに、Claude 自身が内容を要約できます。

Edith は MCP サーバーを起動するのではなく、サーバー自体をホストします。これによってハイライトが瞬時に表示されます。ツール呼び出しと光る表示が、同じタイミングで発生するためです。

独自のコンテンツを追加する

サイドバーの コンテンツを追加 を開くと、2 つのモードがあるインポートダイアログが表示されます。

モード	機能	コスト
原文のまま保持	ファイルまたはテキストをそのままメモとして保存します	無料
概念に要約	セッションで使われるものと同じ抽出処理を実行します	API 呼び出し 1 回

ファイルを再インポートすると、重複を作成するのではなく、既存のメモが深まります。そのため、フォルダーを繰り返し同期しても安全です。フロントマターが壊れたファイルでは、コンテンツではなくメタデータが失われます。

メモの形式

---
id: dynamic-port-binding
title: Dynamic Port Binding
type: concept
created: 2026-08-25
updated: 2026-08-25
origin: distilled
sources:
  - session: 11111111-2222-3333-4444-555555555555
    project: -Users-u-myapp
    at: 2026-08-25T10:00:00Z
links: [mcp-registration]
---
Bind the next free port and rewrite the MCP config to match.

各メモには、その元となったセッションが記録されます。この来歴は初日から記録されるため、概念を元の会話までたどる機能は、移行ではなく表示機能として実現されています。

知っておくとよいこと

旧名称からのアップグレード。 Edith は以前、SecondBrain という名前でした。初回起動時に、既存の vault と設定を旧保存場所からコピーし、~/.claude.json 内の古い secondbrain エントリーを edith に置き換えます。これにより、Claude に同一のツールセットが 2 つ表示されるのを防ぎます。旧ディレクトリは、フォールバックとしてそのまま残されます。

API キーでは claude.ai の履歴にアクセスできません。 Messages API はステートレスで、過去の会話を一覧表示するエンドポイントはありません。Edith は Claude Code のローカルトランスクリプトを読み取ります。API キーは、それらを要約するためだけに使用されます。

~/.claude/projects にある .jsonl ファイルの大半はセッションではありません。 サブエージェントやワークフローのトランスクリプトはセッションディレクトリの下にネストされており、通常、実際のセッションの約 9 倍の数があります。Edith はパスの形式に基づいて分類するため、これらがノートになることはありません。

トランスクリプトはツリー構造です。 Claude を中断すると履歴が分岐し、放棄されたブランチがファイルに残ります。パーサーは last-prompt.leafUuid からたどることで、実際に起きたことだけを要約します。

設定は安全です。 登録では ~/.claude.json に単一のキーをマージし、アトミックに書き込み、最初の変更前にファイルをバックアップします。

開発

npm run dev        # run the app with hot reload
npm test           # 235 tests
npm run typecheck  # tsc --noEmit
npm run build      # bundle main, preload, renderer
npm run icon       # rebuild the icon set from assets/wordmark.svg
npm run release:mac  # signed and notarised, needs the certificate and the edith-notary profile

テストでは、パス分類、分岐の解決、不正な形式の行への耐性、vault のマージセマンティクス、設定書き込みの安全性、HTTP 経由での実際の MCP クライアント、および API 呼び出しをモックしたパイプライン全体のエンドツーエンドテストを網羅しています。

v1 には含まれないもの

claude.ai のエクスポートのインポート - セッション層のグラフ表示 - マシン間の同期 - セマンティック検索。検索は SearchProvider インターフェースの背後にあるため、後からハイブリッド検索を追加する際に変更するのは 1 つのファイルだけです。

ライセンス

Edith は、Functional Source License, Version 1.1, MIT Future License（FSL-1.1-MIT）に基づくソース公開ソフトウェアです。競合する商用製品またはサービスとして提供すること、またはそれに実質的に類似したものとして提供することを除き、あらゆる目的で閲覧、使用、変更、共有できます。各リリースは、公開から 2 年後に MIT ライセンスとなります。

© 2026 Raghav Chari and Kate Bonner.