Cartographer

チームのAIエージェントが共有するメモリー — 全員が読み、育てるひとつのWiki。誰にも壊せません。
月曜日に同僚のエージェントが見つけたことを、火曜日にはあなたのエージェントも知っています — 別のクライアントでも同じです。
Claude Code、Codex、OpenCode、そして[あらゆるMCPクライアント](docs/mcp-clients.md)：ひとつのGoバイナリ、その下で動くgit。

_{Atlas独自のグラフエンジンで描画しています。1.0未満の間は、破壊的変更の際にマイナーバージョンを上げ、変更履歴に明記します。}

今すぐ試す

稼働中のCartographerです — インストールもトークンもサインアップも不要です。2つのナレッジベースを提供しています。探索用の天文アトラスと、訪問者のエージェントがメッセージを残せるゲストブックです。

1. エージェントを接続する https://cartographer-demo.beppetemp.com/mcp に接続します

• Claude または ChatGPT — Web、デスクトップ、またはスマートフォンから、サインインせずにカスタムコネクターとして追加できます （Claudeでは Customize → Connectors → Add custom connector、ChatGPTでは Plugins → + → Add custom MCP server を選び、 認証は None にします）。
• Claude Code：claude mcp add --transport http cartographer-demo https://cartographer-demo.beppetemp.com/mcp

# Codex
codex mcp add cartographer-demo --url https://cartographer-demo.beppetemp.com/mcp
# OpenCode
opencode mcp add cartographer-demo --url https://cartographer-demo.beppetemp.com/mcp --global
# Antigravity
agy mcp add --type http cartographer-demo https://cartographer-demo.beppetemp.com/mcp
# GitHub Copilot CLI
copilot mcp add --transport http cartographer-demo https://cartographer-demo.beppetemp.com/mcp
# Crush
echo 'mcp add cartographer-demo --type http --url https://cartographer-demo.beppetemp.com/mcp' >> ~/.config/crush/crushrc
# Kiro: add to "mcpServers" in ~/.kiro/settings/mcp.json
#   "cartographer-demo": { "url": "https://cartographer-demo.beppetemp.com/mcp" }

2. 質問する

• 「このナレッジベースはブラックホールについて何を知っていますか？また、何とつながっていますか？」
• 「KBのヘルスチェックを実行してください。壊れているもの、古くなっているもの、欠けているものは何ですか？」
• 「このKBは、私のコーディングエージェントにどのスキル、サブエージェント、フックをインストールしますか？」

3. メッセージを残して、反映される様子を見る

「ゲストブックにメッセージを残してください。使用しているクライアントと、共有Wikiに残したいものを教えてください」 と尋ねてから、 稼働中のAtlasを開きます →：あなたのメモが、ほかの人のエージェントが残したメモと並んでグラフに表示されます。 たくさんのエージェント、ひとつのWiki。

_{ゲストブックへのメッセージを除き、すべて読み取り専用です。ゲストブックのメッセージは公開、匿名、モデレーション対象で、投稿頻度が制限されています。 エージェントに専用のナレッジベースを用意するには、クイックスタートをご覧ください。}

理由

AI エージェントは毎回、何も知らない状態でセッションを開始します。チームでは、同僚それぞれのエージェントがそれぞれ別のゼロから始まります。誰かが学んだことは、その人のマシン、そのクライアントにとどまります。よくある対処法は、どれも問題の3分の1しか解決しません。

• RAGは情報を検索しますが、蓄積はしません。エージェントは学んだことを書き留められません。
• エージェントが自由に編集するMarkdown のフォルダーは、リンク切れや履歴の喪失、気付かれない破損を招きます。
• スキル、サブエージェント、指示は.claude/、.codex/、.kiro/…に手作業でコピーされ、マシンごとに内容がばらばらになります。

Cartographer はこれら3つを1か所にまとめます。エージェントはMCP ツールを通じてのみナレッジベースを読み書きし、ルールを適用するサーバーがそれを管理します。また、同じナレッジベースにエージェントの設定方法も保存されます。

利用できる機能

• 🧠 使うほど充実するメモリ
  エージェントが時間をかけて構築する Wiki（Karpathy の LLM Wikiのパターン）：シンプルな Markdown + YAML、KB ごとの Git リポジトリ。Obsidian や任意のエディターで閲覧できます。ロックインはありません。

• 🛡️ 善意に頼らないガードレール
  スキーマ検証、リンクチェック、Lint、不変性ゲート、楽観的同時実行制御、書き込みごとのコミット、署名付き監査ログを備えています。エージェントが KB を壊れた状態にすることはできません。

• 🧩 1つの KB ですべてのエージェントを設定
  スキル、サブエージェント、フック、常時適用する指示を KB に保存し、各クライアントのネイティブ形式で提供します（以下を参照）。一度編集すれば、すべてのマシンに反映されます。

• 👥 チーム向けに構築
  1つのサーバーの背後に複数の KB を配置できます。ネイティブのユーザーサービス、コンテナー、Kubernetes ワークロードのいずれにも対応します。ベアラートークンのロールによる KB 単位・マップ単位のアクセス制御、同期レイヤーとしての Git、ガイド付きワークフローに変換される競合、Ed25519 署名付きアーティファクトを備えています。

• 🗺️ Atlas ですべてを確認
  同じバイナリに組み込まれた読み取り専用の Web UI です。動的な3Dグラフ、検索、エージェントが変更した内容、KB がエージェントに提供する内容、修正が必要な項目を確認できます。追加サービスも CDN も不要です。

• 🔑 適切な方法でシークレットを管理
  SOPS で暗号化した値を概念から参照し、必要に応じて解決します。平文は保存されません。

_{生成されたデモ KB 上で、同じバイナリから提供される Atlas。}

クイックスタート

最初の KB を置くために、git と、自分が所有する空の Git リポジトリ（GitHub、Gitea、または任意のホスト）が必要です。

brew install beppetemp/tap/cartographer   # macOS — Windows, Linux and source: see Install
cartographer setup                        # server, first KB and your agents, in one guided step

setupは、何かに手を加える前に実行計画を表示し、その後ローカルサービスをインストールして KB を作成し、検出したすべてのエージェントクライアントを接続し、結果を検証します。すでに開いているエージェントのセッションを再起動し、エージェントに何を知っているか尋ねてください。手順の詳細： docs/getting-started.md。

**エージェントにインストールさせたい場合は、**こちらを貼り付けてください。

Set up Cartographer on this machine by following
https://raw.githubusercontent.com/BeppeTemp/cartographer/main/docs/agent-install.md
My first knowledge base is at: `<git remote URL>`

_{Cartographer のインストールを依頼されたエージェントの場合：クイックスタートではなく、該当する手順書に従ってください。}

1つの KB、すべてのエージェント

cartographer connectはインストール済みのクライアントを検出し、それぞれの形式で次の内容を書き込みます。

サブエージェントとフックはコピーではなく、変換されます。すべての—は、理由を明示した未対応項目です。黙って省略されることはありません。Cartographer はセッション開始時（フックのないクライアントではタイマーに従って）再同期し、手作業で編集または削除されたファイルを復元します。また、自身が作成したものだけを操作します。正確なパスと理由については、docs/sync.mdを参照してください。

インストール

# macOS (Homebrew)
brew install beppetemp/tap/cartographer

# Windows (PowerShell; no administrator rights)
irm https://raw.githubusercontent.com/BeppeTemp/cartographer/main/install.ps1 | iex

# Linux / macOS without Homebrew
curl -fsSL https://raw.githubusercontent.com/BeppeTemp/cartographer/main/install.sh | sh

# From source (Go 1.26+)
go install github.com/BeppeTemp/cartographer/cmd/cartographer@latest

インストール先、アップグレード、削除については、docs/getting-started.mdをご覧ください。サーバーの構成、環境変数、デプロイのトポロジーについては、docs/deployment.mdをご覧ください。

ドキュメント

**beppetemp.github.io/cartographer**で閲覧できます。マップはdocs/index.mdです。

• はじめに — ゼロから動作するウィキを作成するまで
• 概要 — ビジョン、原則、アーキテクチャ
• MCP ツール — ツール API の全容
• デプロイ — トポロジー、構成、バックアップ
• 同期 — 成果物が各エージェントクライアントに届く仕組み

コントリビューション

質問や自由なアイデアはディスカッションへ、バグや具体的な提案はイシューへお寄せください。イシューや PR を歓迎します。ビルド、テスト、PR の手順についてはCONTRIBUTING.mdをご覧ください。Cartographer は個人プロジェクトで、可能な範囲でメンテナンスしています。セキュリティに関する報告はSECURITY.mdをご覧ください。

ライセンス

Apache License 2.0 — 詳細はLICENSEをご覧ください。