bovedia

BovedIA

Claude Code のためのパーソナルメモリー：Markdown のメモを、自分のものとして、いつまでも。

プロジェクトの状況（2026年8月28日）。 BovedIA は毎日開発を続けていますが、プライベートリポジトリ内で進めています。日々の作業は実際の環境で行っており、テストには顧客データや個人の予定が含まれるため、そのまま公開するのは責任ある選択ではありません。

ここにあるのは、安定していて、完全で、テスト済みのバージョン（v2.8.1、89件のテスト）です。正常に動作し、引き続きインストール可能で、MIT ライセンスも変わりません。放棄されたわけではなく、意図的に凍結しています。

公開可能な状態に整ったもの（Apple 向けの予定管理モジュール、アクティベーションによるメモリー、ローカルのセマンティック検索）ができたら、ここで公開します。時期は未定です。

---

BovedIA とは

BovedIA（bóveda［保管庫］＋ IA［AI］）は、Claude Code やあらゆる MCP クライアントに永続的なメモリーを提供する MCP サーバーです。メモはプレーンな Markdown ファイルとして自分のディスクに保存でき、必要に応じてクラウドと同期できます。AI は、どの作業セッションでもメモを読み取り、作成し、検索し、整理できます。

しかし、BovedIA は単なるエンジンではありません。AI が毎回の会話に軽快で集中した状態で臨めるよう、すべてのコンテキストを一度に持ち込むのではなく、メモリーを整理する方法でもあります。その方法は、このリポジトリの vault-example/ に含まれており、すぐにカスタマイズできます。

---

根本にある考え方：すべてを一度に読み込まない

ほとんどのメモリーシステムは、各セッションですべてのコンテキストを読み込みます。BovedIA はその反対の考え方に基づいています。必要なものだけを、必要なときに取り込むのです。読み込みすぎは、無駄な作業になるだけではありません。回答に先入観を与え、余計な情報を混ぜてしまいます。

これを実現するため、保管庫を階層ごとにたどります（ピラミッド）。

1. ルーター（Inicio）。 会話を始めるたびに必ず読み込む唯一のメモです。作業内容ではなく、何をいつ読み込むかを判断する基準が書かれています。手がかりが明確なら AI が行動し、そうでなければ質問します。
2. 各分野のトップページ。 プロジェクト、顧客、インフラなど、大きな分野ごとにトップページがあり、話題がその分野に入ったときだけルーターが読み込みます。
3. メモ。 実際の内容で、各分野のトップページまたは検索からたどり着きます。

これとは別に、魂という層があります。考えや感情、根本にある理由、考え方、仕事の見方などを書き留めるフォルダーです。ドキュメントではありません。メモリーを単なる書類保管庫から継続性のあるものへと変える要素です。

---

この方法を選ぶ理由

• シンプル： サーバーファイルは 1 つ（index.js）、依存関係も 1 つです。
• 自分のもの： メモは自分のディスクにある .md ファイルです。データベースも外部 API も必要ありません。
• 持ち運び可能： iCloud、OneDrive、Google Drive、Dropbox、または任意のローカルフォルダーで動作します。
• 透明性： どのテキストエディターでもメモを開いて編集できます。

---

ボルトの構造：各フォルダーの役割

vault-example/ には、そのまま使える参照用の構造が含まれています。これは制約ではありません。作業に必要なカテゴリを作成してください。ただし、すべての方法を示しています。

フォルダー／ファイル	役割
Inicio.md	ルーターです。 各セッションで最初に読むノートで、何をいつ読み込むかを決めます。無差別に読み込むことはありません。
HOME.md	マップです。 各フォルダーの役割と、各項目の保存先を示します。
una-tarea-pendiente.md	日付のない未完了タスクの例です。ルートに置かれ、#pendiente が付いています。
programado/	有効化日（> APARECER: AAAA-MM-DD）が設定されたノートです。日付になるとルーターが通知します。
sistema/	すべての仕組みです。ピラミッド（最上位のルール）、ブランチのトップページ、セッションプロトコルが含まれます。
alma/	哲学と考え方、自分の考えや気持ちを書き出す場所です。背景情報であり、運用情報ではありません。
proyectos/	あなた自身のプロジェクトです。
clientes/	クライアントごとのサブフォルダーがあり、それぞれにプロフィールとコンテキストが含まれます。
conocimiento/	再利用できる実務知識です。problemas-resueltos/ も含まれます。
referencias/	参照するものの、頻繁には変更されないガイド、手法、リソースです。

---

インストール

クイックスタート：npx

クローンする必要はありません。クライアントの MCP 設定（Claude Code、Claude Desktop など）に以下を追加し、出発点として vault-example/ を自分のフォルダーにコピーしてください。

{
  "mcpServers": {
    "bovedia": {
      "command": "npx",
      "args": ["-y", "bovedia"],
      "env": { "KB_MEMORY_ROOT": "/ruta/absoluta/a/tu/boveda" }
    }
  }
}

このセクションの残りは手動インストール（リポジトリをクローンする方法）です。コードを変更したい場合に便利です。

要件

• Node.js 18 以降
• Claude Code（npm install -g @anthropic-ai/claude-code）
• クラウド同期フォルダー（iCloud、OneDrive、Google Drive、Dropbox）、または任意のローカルフォルダー

1. リポジトリをクローンする

git clone https://github.com/jmpdsevilla/BovedIA.git
cd BovedIA/server
npm install

2. ボルトを作成する

サンプルボルトを同期フォルダーにコピーし、HOME.md と Inicio.md をカスタマイズしてください。

# Mac + iCloud
cp -r vault-example ~/Library/Mobile\ Documents/com~apple~CloudDocs/mi-boveda

# Windows + OneDrive (PowerShell)
xcopy /E /I vault-example "%USERPROFILE%\OneDrive\mi-boveda"

# Linux + Dropbox
cp -r vault-example ~/Dropbox/mi-boveda

3. Claude Code を設定する

KB_MEMORY_ROOT 変数（~ を含むパスに対応）を使って、サーバーの接続先をボルトに設定してください。

{
  "mcpServers": {
    "bovedia": {
      "command": "node",
      "args": ["/ruta/absoluta/a/BovedIA/server/index.js"],
      "env": {
        "KB_MEMORY_ROOT": "/ruta/absoluta/a/tu/mi-boveda"
      }
    }
  }
}

KB_MEMORY_ROOT（およびそのエイリアス MEMORY_PATH）を定義しない場合、BovedIA はデフォルトで ~/Documents/bovedia を使用します。

4. 確認する

Claude Code を再起動し、Inicio を読むよう依頼するか、get_index を実行してください。ボルトが表示されるはずです。

---

作成者情報の注釈（任意）

BovedIA は、Markdown Annotations に任意で対応しています。これは、iA Writer が当初作成したオープンな仕様で、各ノートのどの部分を誰が書いたかを記録します。有効にすると、AI が書いたノートの末尾に本文の作成者が &Claude であることを示すブロックが付加されます。人間が対応エディターでノートを編集すると、その人の範囲に @nombre が付けられ、次回 BovedIA がノートを変更する際には、その作成者情報が上書きされずに保持されます。

デフォルトでは無効です。 有効にするには、サーバーの環境に KB_ENABLE_ANNOTATIONS=1 を追加してください。

{
  "mcpServers": {
    "bovedia": {
      "command": "node",
      "args": ["/ruta/absoluta/a/BovedIA/server/index.js"],
      "env": {
        "KB_MEMORY_ROOT": "/ruta/absoluta/a/tu/mi-boveda",
        "KB_ENABLE_ANNOTATIONS": "1"
      }
    }
  }
}

このオプションを有効にすると、2 つのツールが使用可能になります。read_authorship（誰が何を書いたかの概要）と migrate_annotations（既存のすべてのノートにブロックを追加します。まず dry_run: true で実行してください）です。署名は KB_AUTHOR_NAME と KB_AUTHOR_EMAIL でカスタマイズできます。

この仕様に対応したエディターを使う場合にのみ有効にしてください。対応していないエディターでは、ブロックがファイル末尾にプレーンテキストとして表示されます。

---

ツール

全部で 38 個あります。最初の 36 個は常に使用できます。作成者情報関連の 2 個（read_authorship、migrate_annotations）は、KB_ENABLE_ANNOTATIONS=1 を設定してサーバーを起動した場合にのみ公開されます。

ツール一覧は各セッションで送信され、コンテキストを消費します。クライアントのコンテキストウィンドウが小さい場合は、KB_TOOLS=core を設定して起動すると、日常的に使う 15 個だけが公開されます（トークンを半分に抑えられます）。デフォルトではすべて公開されます。

基本の読み書き

ツール	説明
write_note	ノートを作成または更新します（完全な upsert）
read_note	ノートを読み込みます（すべてのカテゴリを検索します）
search_notes	フリーテキストで検索します（AND ロジック、アクセント記号を区別しません）
list_notes	カテゴリまたはタグで絞り込んでノートを一覧表示します
get_index	カテゴリのマップを取得します（詳細を表示するには full: true）
delete_note	ノートを削除します（バックリンクを通知します）
create_category	フォルダーを作成します
move_note	ノートを移動／名前変更します（wikilink を更新します）
delete_category	空のフォルダーを削除します

対象を指定した編集

ツール	説明
edit_note	ノート内を検索／置換します
append_to_note	内容を末尾に追加します
prepend_to_note	内容を先頭に挿入します
update_section	見出しで指定したセクションを置き換えます
insert_after_section	別のセクションの後に新しいセクションを挿入します

wikilink とタグのメンテナンス

ツール	説明
list_broken_links	Vault 内のすべての壊れた wikilink を一覧表示します
find_backlinks	ノートのバックリンクを検索します（内容は読み込みません）
find_orphans	バックリンクも発リンクもないノートを検索します
rename_wikilink	Vault 全体で [[viejo]] を [[nuevo]] に置き換えます
list_tags	すべての #snake_case ハッシュタグとその件数を一覧表示します
update_frontmatter	本文に触れずに YAML フィールドを更新します

低コストの読み込み

ツール	説明
peek_note	Frontmatter と最初の段落を取得します
read_section	セクションだけを読み込みます
list_sections	ノートの見出しのインデックスを、内容を含めずに一覧表示します
read_frontmatter	YAML だけを読み込みます

Vault のメンテナンス

ツール	説明
recently_updated	過去 N 日間に変更されたノートを一覧表示します
move_category	フォルダー名を変更します（各ノートの frontmatter を更新します）
validate_note	frontmatter、ハッシュタグ、「関連項目」、壊れたリンクを確認します
bulk_move	複数のノートを同じカテゴリに移動します
due_notes	今日取り出すタイミングの、スケジュール済みノートの一覧です。すでに完了しているか重複しているように見えるノートも通知します。一覧のみ表示し、タスクを選んだときに内容を読み込みます
audit_tags	タグの状態を確認し、形式が正しくないタグを修正します
prune_tags	タグのバリエーションを統合し、タグが多すぎるノートを整理します
vault_health	1 回の呼び出しで Vault の状態レポートを取得します
create_snapshot	必要に応じて完全なバックアップを作成します
list_snapshots	利用可能なバックアップを確認します
restore_snapshot	以前のバックアップに戻します（デフォルトではシミュレーションを実行します）
migrate_yaml_tags	YAML frontmatter に残っているタグを本文に移します

作成者情報（KB_ENABLE_ANNOTATIONS=1 の場合）

ツール	説明
read_authorship	誰がどの範囲を書いたかの概要を表示します
migrate_annotations	既存のノートに作成者情報ブロックを追加します

全リファレンスは docs/tools-reference.md を参照してください。

---

使用プロトコル

最大限に活用するには、次の指示を CLAUDE.md またはアシスタントの設定に追加してください。

Al empezar cada sesión: leer Inicio (el router). Revisar la carpeta programado/
y avisar de lo que ya toca. No cargar nada más "por si acaso".
Guardar lo que merezca recordarse: credenciales, soluciones, decisiones, comandos.
Enlazar las notas con wikilinks [[slug]]. Cada nota termina con una sección
"Ver también" con 2-5 wikilinks.

---

Wikilink

ノート同士は [[slug]] 形式でリンクします。

## Ver también

- [[proyecto-ejemplo]] — proyecto donde se usa esto
- [[cliente-ejemplo]] — cliente al que pertenece

ルール：

• ファイル名の slug を使用します（kebab-case、.md なし）。
• パスは使用しません：[[referencias/x]] → [[x]]。
• エイリアスは使用しません：[[x|otro texto]] → [[x]]。

ノートの名前を変更すると、その wikilink は自動的に更新されます。

---

詳細なインストールガイド

• Mac + iCloud Drive
• Windows + OneDrive / Google Drive
• Linux + Dropbox / Google Drive

---

作者

José Manuel Pérez が作成しました。santa marta crea の創設者です。— デジタルエージェンシー。コロンビア、サンタ・マルタ。

• Web: santamartacrea.com
• GitHub: @jmpdsevilla

---

ライセンス

MIT — 自由に使用、変更、配布できます。