inkvault

InkVault

AI との会話、ブラウジング、作業のための、ローカルファーストでユーザー所有の永続メモリです。

作業の背景にある情報を保持します。何を尋ね、何を学び、どのページを開いたかを記録します。 InkVault は、対応する AI セッションと、選択したブラウザーの履歴をローカルの SQLite Vault に保存するため、 元のツールで履歴が消去された後も、再び見つけることができます。

Memory Atlas で Vault を自分で検索することも、MCP 経由で AI ツールを接続し、尋ねたときに過去のコンテキストを取得できるようにすることもできます。オプションの Windows 画面キャプチャを使うと、使用したアプリのタイムラインと、選択したアプリ内のテキストも追加できます。ソース、Vault フォルダー、バックアップは自分で管理できます。

InkVault は無料で、MIT ライセンスのオープンソースです。アカウントもテレメトリーもありません。InkVault 自体がアーカイブをアップロードすることはありません。 AI クライアントを接続した場合、クライアントに返されるメモリは、そのクライアントの設定に従ってモデルプロバイダーに送信されることがあります。

Vault を作成する

uv とターミナルが必要です。 対応するローカルセッションと、選択したブラウザーの履歴を Vault にコピーします。

uvx --from git+https://github.com/sandoreclegane/inkvault inkvault sync

ターミナルで InkVault が起動し、履歴を読み取る前に、どのブラウザープロファイルが自分のものかを確認します。検索インデックスの作成中は進行状況が表示され、最後に簡単な概要が示されます。初回起動時には検索モデルがダウンロードされます（約 130 MB）。すべての保存が完了すると、Memory Atlas が自動で開きます。これを省略するには --no-open を追加します。次回以降は inkvault dashboard を実行すると Atlas が開きます。

uvx --from git+https://github.com/sandoreclegane/inkvault inkvault dashboard

思い出したい内容を検索し、結果を選択して、前後の文脈を確認できます。毎晩 Vault を更新してバックアップするには inkvault schedule を追加するか、AI ツールを接続して会話から Vault を検索します。

保存したい Pieces アーカイブがありますか？ Pieces からの復元をご覧ください。

InkVault が保存する内容

毎晩のスケジュールを設定すると、InkVault は Claude Code と Codex がすでにディスク上に保存しているセッションファイルと、選択したブラウザープロファイルの履歴を読み取り、新しい内容をコピーします。保存されるのは、尋ねた内容、アシスタントの回答、各セッションの名前、開いたページです。これにより、元のファイルがなくなった後も、AI ツールが先月や去年に支援した内容や、読んでいた内容を検索できます。

• Claude Code：~/.claude/projects 内のすべてのプロジェクトです。同期されたメッセージは、ソース側で削除された後も Vault に残ります。
• Codex：~/.codex/sessions 内の、保存されたすべてのセッションです。
• Claude デスクトップアプリ（エージェントモード、Windows）：監査ログにのみ記録されるプロンプトも含まれます。
• ブラウザー：Chrome、Edge、Comet、Brave、Arc、Vivaldi、Opera、Firefox に対応しています。自分のものだと指定したプロファイルのみ対象です （方法）。ブラウザー独自のクリーンアップ後も保存されます。

前回の同期以降に追加された内容のみが取り込まれます。ツールの出力と添付ファイルは除外され、ウェブアドレスからサインインコードとトークンは削除されます（プライバシーをご覧ください）。

得られるもの

• 自分で管理する保管庫：保存されたセッション、選択したブラウザー履歴、任意の画面アクティビティ、復元できた場合はPiecesの記録を、ローカルのSQLiteファイルvault.dbにまとめます。記録を作成したツールとは独立して保管できます。
• AIツール向けの検索機能：search_memories（キーワードと意味による検索を統合）、timeline（「3月に何をしていましたか？」）、get_memory、memory_statsを備えたMCP サーバーです。
• Memory Atlas：inkvault dashboard（またはWindowsでinkvault dashboard --shortcutを実行して作成したInkVault Atlasアイコン）から開けます。1年の活動を表示します。日ごとの活動時間（特定の日に何をしていたかは、その日をポイントすると表示）、作業する時間帯、プロジェクト同士のつながり、時間の経過に伴うプロジェクトとトピック、使用頻度の高いアプリとサイトを確認できます。すべてのグラフにテーブル表示があります。検索ビューでは保管庫全体から項目を探し、閲覧画面で元の内容を開けます。このコンピューター上（127.0.0.1、非公開リンク、アイドル時に停止）でのみ動作し、インターネット接続は不要です。
• Daily Light（v0.3.2）：厳選されたパブリックドメインの文章32編から、ローカルの日付に基づいて毎日の引用を選びます。履歴は使用しません。現在のAtlasセッション中は非表示にできます。今日の日付に一致する過去の年のインデックス済みアクティビティがある場合は、この日の記録から検索画面で開けます。キーワードを入力せずに開始日と終了日の両方を指定して、任意の日付範囲を閲覧することもできます。これらの日付閲覧機能の追加はAtlasのみが対象で、MCP ツールに変更はありません。
• Claude Code、Codex、Claudeデスクトップのセッション：プロンプトと返信を、ほかの保存された履歴と並べて保存します。チャットとして検索でき（Claude Code · project: titleのような名前が付きます）、タイムライン、ダイジェスト、ダッシュボードにも表示されます。
• ブラウザー履歴：自分のものとして指定したブラウザープロファイルから、Chrome、Edge、Comet、Brave、Arc、Vivaldi、Opera、Firefoxで開いたページを保存します。ブラウザーから削除された後も、すでにコピーされた訪問記録は保管庫に残ります。webとして検索でき、タイムライン、ダイジェスト、ダッシュボードにも表示されます。
• 画面キャプチャ（任意、Windows）：使用したウィンドウのタイムラインと、選択したアプリのウィンドウ内のテキストを保存します。画像は保存しません。画面キャプチャを参照してください。
• 毎日のダイジェスト（任意）：Ollamaを通じてローカルモデルが各日の概要を2～3文で作成します。保存したアクティビティを、ホスト型モデルに送信せずに要約できます。

AIツールを接続する

Claude Code

claude mcp add inkvault --scope user -- uvx --from git+https://github.com/sandoreclegane/inkvault inkvault serve

Codex（~/.codex/config.toml）

[mcp_servers.inkvault]
command = "uvx"
args = ["--from", "git+https://github.com/sandoreclegane/inkvault", "inkvault", "serve"]

Hermes、Claude Desktop、その他のMCPクライアント：stdio経由でuvx --from git+https://github.com/sandoreclegane/inkvault inkvault serveを実行します。

次のように質問できます：「3月10日の週は何をしていましたか？」、「保存したあのリトライ用ヘルパーを探して」、「最後にStripeダッシュボードを見たのはいつですか？」

ブラウザーの履歴

ブラウザープロファイルは他の人のものである可能性があるため、InkVault は選択されるまで読み取りません。

inkvault browsers

検出したすべてのプロファイル（ブラウザー、名前、サインイン中のメールアドレス）を一覧表示し、どれが自分のものかを確認します。新しいプロファイルを見つけたときは、sync と rescue も確認します。夜間実行では確認せず、選択されていないプロファイルはスキップします。このコンピューターで他の人がブラウザーを使い始めた場合は、もう一度 inkvault browsers を実行してください。InkVault は Windows と macOS で置き換えられたプロファイルを検出します。また、プロファイルのサインイン中のアカウントが変わった場合も検出しますが、常に判別できるとは限りません。

• inkvault browsers --no "chrome/Profile 2" --forget はプロファイルのコピーを停止し、ブラウザーをアンインストールした後でも、コピー済みのデータを削除します。
• inkvault browsers --skip-site mybank.com はそのサイトとサブドメインを保存せず、保存済みのデータも削除します。

削除すると、検索とダッシュボードが再構築され、削除した各訪問日のダイジェスト（UTC）と、その前後の日のダイジェストが削除されます。処理が中断された場合は、次回の inkvault sync、inkvault index、または夜間実行で完了します。それまでは検索が無効になります。AI ツールがすでに受け取った回答や、すでに開いているダッシュボードのタブまでは取り消せません。夜間バックアップには、削除した訪問がローテーションで消えるまで（7 晩）引き続き保存されます。

保存されるもの： 各ページのアドレスとタイトル、および開いた日時です。何かを保存する前に、InkVault はサインインコード、トークン、署名付きリンク、パスワードリセット用トークン、メールアドレス、ユーザー名が含まれるアドレスの部分を削除します。検索語（?q=…）は保持されます。一般的な形式には対応しますが、あらゆる秘密情報を検出できるわけではありません。コピーはブラウザーの実行中に行われるため、直近の数件の訪問は次回の同期まで反映されない場合があります。

Safari はまだサポートされていません（macOS では Full Disk Access がないと読み取れません）。

画面キャプチャ（Windows）

inkvault watch を使うと、前面に表示されているウィンドウのローカルタイムラインを追加し、選択したアプリからテキストを読み取れます。 ウォッチャーをインストールするまで、画面キャプチャはオフのままです。現在は Windows のみ対応しています。macOS と Linux では、 inkvault watch はその旨を表示して終了します。

記録される内容

• どのウィンドウもタイムラインに記録。 前面に表示されたウィンドウはすべて 区間 になり、アプリ名、整形されたタイトル、開始時刻と終了時刻が記録されます。ちらっと見るだけのウィンドウは保存されません。また、離席中（5 分間入力がない場合、または画面がロックされている場合）の時間はカウントされません。
• 選択したアプリのテキスト。 ウィンドウが 30 秒間表示されたままだと、InkVault はそのテキストを読み取り（お使いのマシン上で Windows 独自の OCR を使用）、変更があった場合に保存します。同じウィンドウを読み取るのは 2 分に 1 回までです。
• 画像は一切保存されません。 ウィンドウ画像は読み取りに必要な間だけメモリ上に存在し、ディスクに書き込まれることはありません。
• 何かを保存する前に、タイトルとテキストに含まれるシークレット（API キー、トークン、JWT、password: ... の値）はマスキングされ、URL は整理されます。一般的な形式には対応しますが、あらゆるシークレットを検出できるわけではありません。

テキストを取得するアプリ。 デフォルトでは、Comet と Edge、Claude、ChatGPT、Perplexity と Codex、Windows Terminal、VS Code と Cursor、Notion、Obsidian と Notepad、Microsoft 365 アプリ（Word、Excel、PowerPoint、Outlook、new Outlook、OneNote）が対象です。それ以外のアプリはタイムラインのみ記録されます。2 つのグループは、明示的に許可するまでオフになっており、--install の実行時に確認されます。

• メッセージアプリ（Discord、WhatsApp、Telegram、Teams、LinkedIn）。これらを読み取ると、他の人のメッセージや名前が保存されます。また、Discord のタイトルには、会話中の相手の名前が表示されます。「はい」と答えない限りオフです。
• Chrome。 ウィンドウタイトルにはページ名と「Google Chrome」だけが表示され、プロファイル名が含まれないため、InkVault は自分の Chrome プロファイルと他の人のプロファイルを区別できません。「はい」と答えない限りオフです。

ターミナルを使わない場合（スクリプトによるインストールなど）、どちらのグループもオフのままです。アプリは自分で追加または削除できます。

Windows アカウントを使う全員が記録対象になります。 ウォッチャーは、インストールしたアカウントでサインイン時に起動します。そのアカウントを他の人も使う場合、その人の操作も記録されます。記録対象にしたくない人には、別の Windows アカウントを使用してください。

記録されないもの。 パスワードマネージャーと Windows のサインインおよびアクセス許可の確認画面（1Password、Bitwarden、KeePass、KeePassXC、ロック画面、UAC）は完全にスキップされ、区間もテキストも記録されません。タイトルに InPrivate、Incognito、Private Browsing が含まれるウィンドウも同様です。また、--never-app や --never-title で追加した項目も記録されません。

インストール

uv tool install "inkvault[screen]"
inkvault watch --apps       # preview: shows the settings, records nothing
inkvault watch --install    # asks about messaging apps and Chrome, then starts at every sign-in

--apps はプレビュー用です。テキストを取得するアプリと、記録対象外のアプリを表示しますが、何も起動しません。--install はタスク スケジューラにタスクを登録し、サインイン時にウォッチャーを起動して、停止した場合は再起動し、「画面キャプチャがオンです」と表示する前に、実際に実行中であることを確認します。また、デスクトップに「画面キャプチャを一時停止（1 時間）」と「画面キャプチャを再開」の 2 つのショートカットを追加します。screen エクストラがない場合、または Windows に OCR 言語がインストールされていない場合でも、ウォッチャーはタイムラインを記録します。テキストが取得できない理由は inkvault status に表示されます。

操作

コマンド	内容
inkvault watch --apps	テキストを取得するアプリと、取得対象外のアプリを表示します。設定は変更しません
inkvault watch --install	画面キャプチャを今すぐ開始し、サインインのたびに自動で開始します
inkvault watch --stop	実行中のウォッチャーを停止します（次回のサインイン時に再開します）
inkvault watch --pause 30m, 1h または until-tomorrow	しばらく記録を停止します。夜間の実行中でも有効です
inkvault watch --resume	一時停止を終了します
inkvault watch --add-app EXE / --remove-app EXE	このアプリのテキストを読み取るようにします／タイムラインのみの状態に戻します
inkvault watch --never-app EXE	このアプリを一切記録しないようにします
inkvault watch --never-title TEXT	タイトルにこのテキストを含むウィンドウをすべて除外します
inkvault watch --reset-settings	デフォルト設定に戻します
inkvault watch --uninstall	ウォッチャーを停止し、サインインタスクを削除します

設定は InkVault フォルダー内の screen.json に保存されます。ウォッチャーは数秒以内に変更を反映します。ファイルを読み取れないか、内容が無効な場合は、修正されるまで記録しません。実行ファイル名の大文字と小文字は区別されません。

検索

• timeline には画面上のアクティビティがリアルタイムで表示されます。範囲内のウィンドウを新しい順に一覧表示する独立した 画面 セクションがあり、現在開いているウィンドウも含まれます。
• search_memories は、夜間のインデックス作成後（または inkvault index の実行後）に、画面上のテキストとウィンドウタイトルを検索します。結果にはインデックスがどこまで作成されているかが示されます。画面上のアクティビティのみを対象にするには、source="screen" を指定します。
• 画面上の検索結果に対して get_memory を実行すると、ウィンドウのアプリ、タイトル、時刻、および最新のテキストが表示されます。
• inkvault status には、ウォッチャーの状態（実行中、一時停止中、前面のアプリ、最後に発生したエラー）、サインインタスク、保存された時間帯とテキストの読み取り回数が表示されます。
• ダッシュボードには 画面使用時間 タイルと アプリ別の画面使用時間 グラフがあり、日次ダイジェストにはアプリ別の画面使用時間と、最も長く表示されていたウィンドウが含まれます。ダイジェストに画面上のテキストが含まれることはありません。

削除

inkvault forget --screen --app Discord.exe
inkvault forget --screen --since "2026-10-12 09:00" --until "2026-10-12 11:30"

時刻はローカル時刻です。--since に日付を指定すると、ローカル時刻の午前0時を意味します。--until に日付を指定すると、その日全体が対象になります。正確な時刻を指定するには、Z またはオフセットを追加してください。--until は --since と併用する場合に限り指定できます。--app を指定すると、そのアプリの記録をすべて削除します。ウィンドウは全体が削除されます。範囲と重なる時間帯はテキストも含めて削除され、コマンドは確認を求める前に実際の削除範囲を表示します。検索結果、ダッシュボード、ダイジェストは削除後の内容で再構築されます。それ以前に作成された夜間バックアップには、バックアップのローテーション（7夜）が行われるまでデータが残ります。また、AI ツールがすでに受け取った回答を取り消すことはできません。削除されるのは過去の記録のみです。アプリの記録を停止するには、--never-app を使用してください。

制限事項

• 銀行などの機密性の高いサイト。 ブラウザー履歴の skip_sites リストにはドメインが登録されていますが、ウィンドウタイトルにドメインが含まれることはまれなため、ここでは適用できません。銀行のページタイトルに表示されるテキストを --never-title に指定してください（例：--never-title "Example Bank"）。
• プライベートウィンドウ。 マーカー（InPrivate、Incognito、Private Browsing）は英語です。ローカライズされたブラウザーでは別の語が使われていたり、マーカーがなかったりする場合があります。その場合は、独自の語を --never-title に追加してください。
• わずかなタイミングの差。 InkVault は読み取りの直前と直後にウィンドウを確認し、変更されていた場合はテキストを破棄します。最後の確認から画面が描画されるまでの間にウィンドウが変化した場合は検出できません。
• 検索は夜間、timeline はリアルタイムです。 新しい画面上のアクティビティは、すぐに timeline に表示され、次回のインデックス作成後に検索結果に表示されます。
• ストアアプリはタイムラインのみです。 Windows ストア（UWP）アプリはテキストを含まないフレームウィンドウ内で実行されるため、タイムラインには表示されますが、テキストは読み取られません。
• Windows のみ。 macOS と Linux はサポートされていません。

最新の状態を保つ

サポート対象のセッションと選択したブラウザー履歴を最新の状態に保ち、検索と Atlas を再構築して、毎晩ボルトをバックアップします。

uvx --from git+https://github.com/sandoreclegane/inkvault inkvault schedule

このコマンドは InkVault を永続的な inkvault コマンドとしてインストール（uv tool install を使用。古いバージョンがあれば更新）し、システム標準のスケジューラーを使って毎晩 03:00 に実行するよう設定します。Windows ではタスク スケジューラ、macOS では launchd、Linux では systemd ユーザータイマー（または cron）を使用します。uv のツールフォルダーが PATH に含まれていない場合は、uv tool update-shell を実行するよう案内します。

各実行では、新しいキャプチャをエクスポートし（PiecesOS が実行中の場合）、新しい Claude Code および Codex のセッションと、選択したプロファイルの新しいブラウザー履歴をコピーして、その直後に日付付きの vault.db のコピーを backups/ に保存します（直近 7 件を保持）。その後、検索を再構築し、新しいダイジェストを書き込み（Ollama が実行中の場合）、ダッシュボードを再構築します。どれかのステップが失敗しても、ほかのステップは停止しません。実行中はコンピューターがスリープしないようにします（Windows と macOS）。エクスポートには時間制限があります。大量の未処理データを時間内に処理できない場合、実行は正常に停止し、そこまでのデータをバックアップします。翌晩、停止したところから続行します。

夜間実行中は rescue を開始できず、再試行するよう案内されます。夜間実行の開始時に rescue が実行中の場合、夜間実行は最大 1 時間待機します。rescue は完了時に独自のバックアップを作成します。

inkvault status では、スケジュールと直近の実行結果を確認できます。スケジューラー自体を確認し、タスクが無効になっている場合、別のボルトを実行する場合（コンピューターユーザーごとに夜間実行は 1 つだけ設定できるため、別のボルトをスケジュールすると置き換わります）、または InkVault のインストール先が存在しなくなっている場合は、その旨を表示します。また、実行が予定時刻を過ぎている場合（26 時間以内に実行されていない場合）にも警告します。各実行のログは InkVault フォルダー内の nightly.log に記録されます（nightly.log に書き込めない場合は、その隣の nightly-fallback.log に記録されます）。

スケジュールはボルトのフォルダーに紐付けられるため、最初に --home を指定した場合は、同じ --home を指定して schedule を実行してください。

実行時にコンピューターがスリープ中または電源オフの場合：

• Windows と systemd では、コンピューターが次に起動したときに実行されます。
• macOS ではスリープ後に実行されますが、電源オフの後には実行されません。
• cron では未実行分は実行されません。

Windows のタスクは、ログイン中にのみ実行されます。実行時にコンピューターをスリープ解除することもできます。

• Windows：schedule が確認します。電源プランでスリープ解除タイマーを許可する必要があります。また、一部のノート PC（Modern Standby）ではタイマーが無視されます。
• macOS：schedule が確認した後、1 回限りの sudo pmset repeat ... コマンドを表示します。実行してください。すでに設定されている pmset repeat のスケジュールは置き換えられます。
• Linux：ユーザータイマーではコンピューターをスリープ解除できません。systemd はログイン中にタイマーを実行します。loginctl enable-linger $USER を実行すると、常時実行されます。

inkvault schedule --at 02:30 で時刻を変更できます。--wake または --no-wake を指定すると確認を省略できます。--off で無効にし、uv tool upgrade inkvault で InkVault を更新します。

コマンド

コマンド	内容
inkvault rescue	エクスポート、インデックス作成、ダイジェスト作成（Ollama が起動している場合）、ダッシュボードの構築と表示を行います
inkvault export	PiecesOS からすべてをコピーします。停止して再実行しても安全です。新しいものだけを追加します
inkvault sync	新しい Claude Code と Codex のセッション、およびブラウザー履歴をボルトにコピーし、検索インデックスを再構築します
inkvault browsers [--yes|--no KEY] [--forget] [--skip-site HOST]	自分のブラウザープロファイルと、保存しないサイトを選択します
inkvault index	検索インデックスを再構築します
inkvault digest [--model M] [--redo]	ローカルモデル（デフォルトは qwen3.5:4b）を使って日次ダイジェストを作成します
inkvault dashboard	Memory Atlas を再構築して表示します
inkvault serve	MCP サーバーを実行します
inkvault status	ボルトの内容と保存場所に加え、スケジュールと直近の夜間実行を表示します
inkvault watch ...	画面キャプチャ（Windows）：プレビュー、インストール、一時停止、停止を行います。画面キャプチャを参照してください
inkvault forget --screen --app EXE / --since T --until T	ボルトから画面キャプチャを削除します
inkvault schedule [--at HH:MM] [--wake|--no-wake] [--off]	毎晩ボルトを更新してバックアップします
inkvault nightly	今すぐ更新とバックアップを1回実行します（スケジュールで実行される処理です）

プライバシー

これは、あなたの画面履歴、チャット、ブラウジング履歴、コードです。InkVault はアーカイブをローカルに保存し、検索します。

• すべてアプリデータフォルダー（%LOCALAPPDATA%\InkVault、~/Library/Application Support/InkVault、 または ~/.local/share/inkvault）、あるいは INKVAULT_HOME の指定先に保存されます。コードフォルダー内には保存されません。
• テレメトリー、アカウント、クラウドはありません。
• InkVault 自体がアーカイブをアップロードすることはありません。MCP 経由で AI クライアントを接続すると、返されたメモリーが、そのクライアントの設定に従ってモデルプロバイダーに送信される場合があります。クライアントと設定は慎重に選んでください。
• ダウンロードされるものは1つだけです。検索モデル（Hugging Face から一度だけダウンロードする約130 MB）です。Atlas はネットワークリクエストを送信しません。グラフライブラリ（ECharts）は同梱されているため、オフラインでも動作します。
• ダイジェストには、お使いのマシン上の Ollama を使います。--no-digest を指定するとスキップできます。
• Claude Code と Codex のセッションからは、入力した内容、アシスタントの返信、セッションタイトルを InkVault が保存します。Claude Code の返信にはツール呼び出しが含まれるため、書き込まれたファイルはそのまま保存されます。ツールの出力（読み込んだファイルやコマンド出力）、貼り付けた画像、添付ファイルは除外されます。これらは各ファイルの大部分を占め、秘密情報が含まれやすいためです。これによりリスクは軽減されますが、入力またはテキストとして貼り付けた内容はすべて保存されるため、リスクを完全に排除することはできません。
• ブラウザー履歴を読み取るのは、選択したプロファイル（inkvault browsers）だけで、ブラウザーのファイルのコピーから読み取ります。InkVault は各ページのアドレス、タイトル、開いた時刻を保存します。その際、サインインコード、トークン、署名付きリンク、リセットトークン、メールアドレス、ユーザー名を含むアドレスの一部は削除されます。すべての秘密情報を検出できるとは限りません。保存したくない情報は inkvault browsers --skip-site と --no … --forget で削除できます。
• 画面キャプチャ（Windows。インストールするまでは無効）は、ウィンドウタイトルと、選択したアプリについてはそのテキストを保存します。画像は保存されません。タイトルとテキストに含まれる秘密情報は、保存前にマスキングされます。検出できない情報については、画面キャプチャを参照してください。画面のメモリーにも、上記の接続クライアントとの境界が適用されます。
• キャプチャしたテキストやページタイトルは、他の人、アプリ、ウェブサイトによって書かれたものです。MCP サーバーは、AI ツールに対して、それらを指示ではなくデータとして扱うよう伝えます。

ボルトをバックアップしてください。 ファイルは1つだけです。InkVault フォルダー内の vault.db です。ほかのすべては inkvault index で再構築できます。

Pieces からの救出

InkVault は Pieces のメモリーを保存する方法として始まりました。救出は引き続きサポートされている用途ですが、Pieces を使わずにボルトを開始して維持することもできます。

エクスポートが安全に完了するまで、PiecesOS をインストールしたまま起動しておいてください。

uvx --from git+https://github.com/sandoreclegane/inkvault inkvault rescue

エクスポートでは、PiecesOS が返す生のレコード（キャプチャ、要約とそのテキスト、チャット、スニペット、タグ、ウェブサイト、人物）が保持されます。

時間がかかります。 PiecesOS がレコードを渡す速度は毎秒約 8 件のため、1 年分のキャプチャ（約 100,000 件）には 3〜4 時間ほどかかります。実行したままにするか、いつでも Ctrl+C を押してください。InkVault はそれまでに保存した内容をすべて保持し、現在の状況をダッシュボードに表示します。同じコマンドを後で再度実行すると、中断したところから再開します。

知っておくと便利なこと

• ダッシュボードの プロジェクト は、セッションのタイトルで繰り返し使われているフレーズから検出されます。自分で選ぶには、InkVault フォルダーに themes.txt を作成し、Website = website|landing page|stripe のような行を記述して、inkvault dashboard を実行してください。
• トピック は、Pieces が各セッションの要約に付けたトピックタグから取得されます。継続中 のトピックは数か月にわたって繰り返し現れ、集中期間 のトピックは数週間に集中しています。次回の inkvault index（rescue と夜間実行の一部）後に表示されます。このアイデアをくれた Pieces の Anthony に感謝します。
• Claude Code と Codex のセッション は、~/.claude/projects と ~/.codex/sessions から読み込まれます（設定している場合は CLAUDE_CONFIG_DIR と CODEX_HOME を使用します）。rescue と夜間実行でも読み込まれます。inkvault sync は単独で実行でき、Pieces がなくても動作します。前回の同期以降に追加されたものだけを読み込みます。
• Claude デスクトップアプリのセッション（エージェントモード、Windows）は、アプリ独自のフォルダー（%LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\local-agent-mode-sessions）から読み込まれ、Claude desktop · project: title という名前が付けられます。macOS と Linux では、まだ読み込まれません。
• PiecesOS のポート：InkVault はまず PiecesOS が独自の設定（.port.txt）に保存したポートを読み込み、次に前回動作したポートを使い、その後 39300 と 1000 を試します。ポートを指定するには、INKVAULT_PIECES_PORTS を設定するか、--pieces-ports を渡してください（夜間実行の場合：inkvault --pieces-ports 39301 schedule）。
• Pieces 独自のエクスポートツール：Pieces は提供すると言っていました。そちらも使ってください。コピーは 1 つより 2 つあるほうが安心です。その形式を InkVault にインポートする機能は、今後対応予定です。
• Windows で PiecesOS 12.6.2 と 120,000 件のキャプチャを含むボルトを使ってテスト済みです。macOS と Linux でも動作するはずです。報告をお待ちしています。inkvault schedule は Windows で最初から最後までテスト済みですが、macOS と Linux では今のところ自動テストのみで確認しています。実機の Mac または Linux からの報告が大変助かります。

Pieces とは無関係です

InkVault は独立したプロジェクトです。「Pieces」は、その所有者の商標です。

MIT ライセンス。制作：T. Matthew Chase / Logos 7。