atlas-mind

Atlas Mind

それはあなたの思考であり、誰かのものではありません。

Notionや、あらゆるホスティング型のノートアプリでは、あなたの考えを彼らの構造に、彼らのサーバー上で、彼らの形式に落とし込むことを求められます。あなたは場所を借り、鍵は彼らが握ります。Atlas Mindはその逆です。あなたの知識は自分のgitリポジトリにあるプレーンファイルであり、一行ずつ読めるエンジンによって提供されます。ノートを一つも失うことなく、エンジンを捨てることもできます。オープンプロトコルを通じて、あなたのAIがあなたのライブラリにアクセスします。あなたの思考をAI自身の中に取り込むことはありません。

データを自分のものに。エンジンを自分のものに。思考を自分のものに。

🔗 ライブデモを試す →（オフラインビルドのため、一部機能は利用できません） · Atlas Mindとは？

Atlas Mindはセルフホスト可能なWiki／ナレッジベースエンジンであり、AIと共有する外部の脳でもあります。ドキュメントのフォルダー（マインド）から単一ページのビューアーを提供し、エンジン（コード）とコンテンツ（独立したgitリポジトリにあるノート）を明確に分離します。基盤となる考え方は3つです。

• Markdownだけでなく、複数の形式に対応。 Markdownを第一級の形式として扱い、レンダリング、リンク、検索ができます。単体のHTMLスライドやダッシュボード、PDF、Word .docx、画像、JSONはインラインでプレビューされ、ブラウザー内でレンダリングされます。どこにもアップロードされません。
• AIネイティブ。 MCPエンドポイントを公開し（マインドの読み取り、書き込み、トリアージ、マッピング、巻き戻し、監査を行う30種類のツール）、atlas initで規約（AGENTS.md、agents/、ai-sessions/）を用意するため、アシスタントがマインドの使い方を把握できます。
• 軽量で自己完結。 標準ライブラリだけを使う単一のPython HTTPサーバーです。データベースは不要で、アカウントや共有リンクはディスク上のプレーンなJSONとして保存され、フロントエンドライブラリとフォントは同梱されています。稼働中のインスタンスがコンテンツを外部に送信することは決してありません。マインドがディスクから外に出ることはなく、書き込んだ内容が誰かのモデルの学習に使われることもありません。デフォルトで行う唯一の外部リクエストは、クライアントをOAuth経由で接続する際に、MCPクライアントの公開メタデータを読み取ることです（無効に切り替え可能）。

マルチテナントSaaSでも、リアルタイム共同編集エディターでも、プラグインマーケットプレイスでもありません。インスタンスごとに一つのマインドを集中して管理でき、すべてあなたのものです。

インストール

インストールすると、自己完結したatlasコマンドがPATH上に配置されます（ビューアーのアセットはパッケージ内に同梱されるため、別途ダウンロードする必要はありません）。

# Easy way: uv or pipx (isolated env, no virtualenv to manage)
uv tool install atlas-mind        # or: pipx install atlas-mind
atlas serve ~/my-mind

# Run once without installing, straight from PyPI
uvx atlas-mind serve ~/my-mind    # or: pipx run atlas-mind serve ~/my-mind

# With pip (a virtualenv is recommended)
pip install atlas-mind

Python >= 3.11と、コンテンツ用のgitリポジトリが必要です。

クイックスタート

atlas init ~/my-mind     # scaffold a mind: atlas.toml, example docs, AGENTS.md, git init
atlas serve ~/my-mind    # build once if needed, then serve on http://127.0.0.1:8765

initは破壊的な操作を行いません（--forceを付けずに空でないディレクトリを指定すると処理を拒否し、既存のファイルはそのまま保持します）。serveはデフォルトで認証を無効にし、127.0.0.1:8765で待ち受けます。サーバーを起動せずに静的ビューアーを生成するには、atlas build ~/my-mind [--offline]を実行してください。

すべてのコマンド（user、token、share、deploy）については、atlas --helpを参照してください。

AI で使用する（MCP）

Atlas Mind は、アシスタントが読み書きする外部メモリとして設計されています。デプロイ済みのインスタンスでは、アシスタントの接続先に https://<your-atlas>/mcp を指定すると、OAuth 経由で接続されます。Atlas にサインインし（2FA を含む）、アシスタントが要求する権限（読み取り、受信トレイ、書き込み）を確認して、許可したくないもののチェックを外し、接続を許可します。この接続は 設定 → トークン に表示され、取り消すことができます。接続は自動的に更新され、30 日間使用されなかった場合にのみ、再認証が求められます。

クライアントは自動で登録する（動的クライアント登録）か、公開メタデータドキュメントの URL で識別されます。後者の場合、接続時に Atlas がそのドキュメントを取得します。atlas.toml の [oauth] client_metadata_fetch = false を設定すると、この取得を無効にできます。

Web UI の 設定 → トークン から、自分でトークンを発行することもできます。トークンはアカウントに紐付けられ、トークンを含む URL が表示されます。ローカルでの利用（またはスクリプトからの利用）では、CLI でも同じことができます。

atlas token create ~/my-mind --label claude
# → prints the MCP URL: https://<your-atlas>/mcp/<token>

MCP エンドポイントでは、6 つのグループに分かれた30 個のツールを利用できます。

• read：brief（トピックに関するコンテキストパック。トークン予算内で最適なセクションを提示）、search_docs（検索順位付きの結果。それぞれのヒットにはセクションと、どの程度信頼できるかを示す情報が付属：最終編集者、AI または人間、古さ、意見の相違）、grep_docs（該当する行を正確に検索）、read_doc（ドキュメント全体、行範囲、または 1 つのセクションを読み取り）、list_tree、recent_docs、changes_since（エージェントが保持するカーソル以降の変更内容）、resume_session（保存済みの作業セッションを再開：再開コマンド、未解決の項目とそれぞれの経過時間、その後の変更内容）
• write：create_doc、edit_doc（差分を返す。dry_run と base_version ガードにより、同時に発生した変更が上書きされることはありません）、move_doc（参照元の [[backlinks]] を修正）、delete_doc（.trash/ にソフト削除）
• graph：get_links、get_backlinks、list_by_tag、get_mind_topology
• time-travel（あなたのマインドは git リポジトリです）：doc_history、doc_at、doc_diff、search_history、changelog、doc_blame、doc_revert
• activity（帰属レイヤーの読み取り側）：activity（AI が作成者かどうかの検出機能付きで、誰が何を変更したかを表示）、agent_runs + undo_run（エージェントの作業セッションを 1 つのコミットとして取り消し）、stale（数か月間更新されていないドキュメント：陳腐化の確認）、contradictions（確認が必要な、同じトピックのドキュメントのペア）、judge_contradiction（ペアに対する判定を記録）
• inbox：create_inbox_item（エージェントが、整理のために受信トレイへファイリング準備済みの項目を登録）

名前を指定して開始するプロンプトも提供されます（Claude Code の / コマンド）。組み込みプロンプトはリアルタイムで生成されます。weekly-review（変更された内容、古くなりつつある内容、解決すべき意見の相違）、triage-contradictions、new-doc（テンプレートを使って新しいドキュメントを作成）、resume（保存済みの作業セッションを中断した箇所から再開）を利用できます。また、独自のプロンプトは content/agents/prompts/ に Markdown ファイルとして 1 つずつ保存でき、ビューアーから編集できます。{{arguments}} と {{include path/doc.md}} に対応しています。すべてのドキュメントは doc://<path> の形式のリソースでもあり、会話に添付できます（Claude Code では @atlas:doc://notes/x.md）。検索結果からは、対応するリソースへのリンクが表示されます。

MCP Apps を表示できるホスト（Web 版およびデスクトップ版の Claude、ChatGPT、Copilot 搭載の VS Code など）では、resume_session は会話内のインタラクティブビューとしても表示されます。セッションでチェックする未解決の項目、差分付きで変更されたドキュメント、同じ作業の別の保存データ、コピー用の再開コマンド、残した項目を使って再開するボタンが表示されます。Claude Code を含む Apps 非対応のホストでは、同じ内容がテキストで返されます。

Claude Code で

Atlas を一度追加すれば、すべてのプロジェクトで使えます。短い名前を付けると、その名前がプロンプトとリソースのプレフィックスになります。

claude mcp add --transport http --scope user atlas https://<your-atlas>/mcp

次に、Claude Code で /mcp を実行して atlas を選び、認証します。OAuth のサインイン画面がブラウザーで開きます。以降、プロンプトは /atlas:weekly-review、/atlas:new-doc decision "Pricing"、/atlas:resume auth のように表示され、ドキュメントは @atlas:doc://notes/x.md として添付されます。

claude.ai でも Atlas に接続している場合、Claude Code は長い名前のコネクターも検出します。ツールが二重に表示されないよう、/mcp でそちらをオフにしてください。

atlas init は AGENTS.md + content/agents/ + content/ai-sessions/ を生成します。また、エンドポイントは AGENTS.md をサーバー指示としてすべてのクライアントに渡すため、どのアシスタントも接続した時点であなたの規約に従います。ツールには読み取り専用／破壊的操作のヒントが付いており（クライアントは確認なしで読み取り操作を実行できます）、トークンには read、inbox、write のいずれか、または複数の権限を設定できます（信頼できないメールを受け取るエージェントに編集権限は不要です）。マインドの外部に書き込まれたテキスト（リモートミラー、受信トレイへの投入）は、信頼できないデータとして区切られてエージェントに渡されます。また、エンドポイントはステートレスな MCP の 2026-07-28 リビジョンと、以前の initialize ベースのリビジョンの両方に対応しています。公開済みの OpenAPI 3.1 仕様を備えた REST API v1（Bearer トークン、作成専用の書き込み）もあります。

機能

• 閲覧：GitHub 形式の Markdown（目次、構文ハイライト、読了時間、タグバー）、単体の HTML デッキ／ダッシュボードのインラインプレビュー、PDF、.docx（ブラウザー内で変換、読み取り専用）、画像（ペインに合わせて表示し、クリックで全サイズを表示）、.json（整形してハイライト表示）に対応しています。任意のファイルをオリジナルのままダウンロードできます。
• ナビゲーション：折りたたみ可能なツリー、全文検索（オンライン時はサーバー側、オフライン時はファジー検索の MiniSearch）、[[wikilinks]] + 被リンク + 「同じトピック」、フォルダー／frontmatter タグ、マインド全体のタスク集約、コマンドパレット（Ctrl-K）、ピン留めしたドキュメントと最近使ったドキュメント。
• マインド：すべてのドキュメントとタグがナビゲーション可能なノードになる、力指向レイアウトのマインドパレス。フォルダーごとに色分けされ、最近のノードは光り、孤立したノードは薄く表示されます。
• 編集：ビューアーから作成／編集／名前変更／移動／削除できます（ドキュメントを移動すると、そのドキュメントを参照する wikilinks も書き換えられます）。ドキュメントテンプレート、操作可能なタスクのチェックボックス、カテゴリ分けされた ToDo ウィジェットにも対応しています。
• 履歴：すべてのドキュメントが Git でバージョン管理され、リビジョン一覧、見やすい差分、過去のバージョンの表示／復元（復元は新しいコミットとして記録）、名前変更と移動の追跡に対応しています。
• アクティビティ：作成者情報付きの Git 履歴をホームカードに表示します。誰が何を変更したかを記録したジャーナル（AI 作成者の検出、ドキュメントごとの履歴プレビュー付き）、貢献者のコンステレーション、そして古くなったドキュメント（陳腐化）や同じトピックの矛盾候補を表示し、AI に確認を促すヘルスビューを備えています。
• 受信トレイ：エージェントが MCP 経由で登録した項目を整理する、ホーム上の個人別トリアージレーンです。一度に表示するカードは1枚です。クリックまたはキーボード（K / X / S / J）で、保持（提案されたフォルダーとタグを付けて格納）、破棄、またはスヌーズできます。
• 注釈：テキスト選択範囲に固定するメモです。後で再訪した際に再配置され、ワンクリックですべてのメモを Markdown としてコピーできます。
• 共有：クラウドモードではドキュメントごとにアクセス権を設定できます（非公開／個人またはグループと共有／チーム全体に公開）。有効期限を任意で設定できる、HMAC 署名付きの公開共有リンクにも対応しています。
• オフラインと PWA：file:// から動作する自己完結型の index-offline.html、サービスワーカー経由でインストール可能な PWA、SSE 経由のライブリロード。
• i18n：フランス語と英語に対応しています。丁寧に作り込まれたダークテーマを備え、CSS 拡張でスキンを変更できます。

セルフホスティング

• クラウドモード：アカウントとログイン（管理者／メンバーのロール）、ドキュメントごとのアクセス制御、Cookie セッション、リカバリーコード付きのオプションの TOTP 2FA、アカウント単位のロックアウトと IP ごとのログインレート制限、完全な CSRF 対策。
• デプロイ：atlas deploy ~/my-mind --target compose|systemd|fly。fly --wizard で最初から最後までデプロイできます。
• 設定：シンプルな atlas.toml（ブランドの接頭辞、ポート、認証、コンテンツのパス）。
• 更新：エンジンとコンテンツは個別に更新され、エンジンをアップグレードしてもノートには一切触れません。

ドキュメント

ドキュメント自体が Atlas のマインドです — ライブデモでご覧ください →（guides/ と features/ のセクション）。

ライセンス

AGPL v3。詳細は LICENSE をご覧ください。ビューアーとログインページの「Atlas」＋「Mind」のブランディングは、プロジェクトの固定要素です。