mindfs: READMEの実装範囲と導入時に見るべき条件

mindfsを読むための焦点

MindFSは、AIエージェントのコマンドラインツールを操作するためのブラウザインターフェースを提供するローカルサービスです。READMEでは「AI Agent Remote Access Gateway」および「Result Visualization」レイヤーと説明されています。AIモデルは同梱されておらず、MindFSを実行するマシンに少なくとも1つのエージェントCLIがインストールされている必要があります。READMEには、Claude Code、OpenAI Codex、Gemini CLI、Grok、Cursor、GitHub Copilot、Cline、Augment、Kimi、Kiro、Qwen、Qoder、OMP、Pi、Hermes、Reasonix、OpenCode、OpenClawなど、サポートされているエージェントのリストが記載されています。MindFSはインストール済みのエージェントを自動検出します。エージェントセッションに加えて、プロジェクトファイルとタスクボードも管理します。

READMEの構成手順で検証用のエージェント接続を作り、セッション管理、タスクボード、ファイルアクセスの各操作を別々に試す。リモート接続とプラグインを有効にする前に、アクセスモード、実行コマンド、対象ファイルの範囲をログで確認する。 第1章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

エージェントセッション管理

セッション機能はMindFSの中核です。エージェントの出力はトークン単位でブラウザにストリーミングされ、ツール呼び出し、思考トレース、権限プロンプト、残りのコンテキストウィンドウ容量が構造化された折りたたみ可能なカードとして表示されます。セッション中にエージェントやモデルを切り替えることができ、すべてのエージェントが同じコンテキストを共有します。セッションはタイトルまたは内容で検索でき、一致したスニペットにジャンプできます。サポートされているエージェントCLIからの外部セッションをMindFSにインポートして続行できます。また、MindFSセッションを元のCLIで再開することもできます。内部セッションと基盤となるエージェントセッションのバインディングは、サービス再起動後も維持されます。メッセージにファイルや画像を添付でき、複数のデバイスからライブ同期で同じインスタンスにアクセスできます。エージェント設定とAPIプロバイダーは、ワンクリックでバックアップ、追加、切り替えができます。CodexとClaude Codeのサブエージェントは自動検出されます。セッションは過去の返信からフォークでき、指定した時間にタスクを実行するようにスケジュールすることもできます。Codexリモートログインは /login コマンドで文書化されており、リアルタイム残高表示を備えた組み込みのトークンステージング機能があります。

READMEの構成手順で検証用のエージェント接続を作り、セッション管理、タスクボード、ファイルアクセスの各操作を別々に試す。リモート接続とプラグインを有効にする前に、アクセスモード、実行コマンド、対象ファイルの範囲をログで確認する。 第2章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

タスクボードとファイルアクセス

タスクボードは複数のタスクを並行して実行し、各タスクは独自のワークツリーで分離されます。タスクテンプレートはステージを定義し、各ステージでエージェント、モデル、プランニングモード、プリセットプロンプトなどを設定できます。ディープリンクはタスク、ワークツリー、セッション、ファイルを動的に関連付けます。クイック作成はテンプレートからタスクを生成し、ファイルアップロード、画像、スキル入力をサポートします。ファイルアクセスはプロジェクトごとに整理されます。複数のディレクトリを管理でき、セッションはプロジェクトごとに独立しています。すべての会話履歴、ファイルメタデータ、ビュー設定はプロジェクトの `.mindfs/` サブディレクトリに保存されるため、移行とバックアップはフォルダコピーで完了します。ファイルツリーブラウザは完全なディレクトリナビゲーションを提供し、Markdown、画像、コードのプレビューをサポートします。

READMEの構成手順で検証用のエージェント接続を作り、セッション管理、タスクボード、ファイルアクセスの各操作を別々に試す。リモート接続とプラグインを有効にする前に、アクセスモード、実行コマンド、対象ファイルの範囲をログで確認する。 第3章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

インタラクションとUI機能

`/` を入力するとコマンドパレットが開き、`@` はファイルをコンテキストとして添付するためのパス補完をトリガーし、`#` は保存済みのプロンプトショートカットを呼び出します。ファイルとセッションのリンクは双方向で機能します。ファイルからそのファイルを作成したセッションへ、またはセッションからそのセッションが触れたすべてのファイルへジャンプできます。UIはPWAとして提供され、アプリストアなしでデスクトップまたはモバイルのホーム画面にインストールできます。モバイルレイアウトには、親指の届く範囲の下部アクションバー、独立したパネルのスワイプナビゲーション、ソフトキーボードに適応する入力ボックスが含まれます。Web Push通知はセッションステータスの変更時に配信されますが、iOSではページをホーム画面に追加する必要があります。ユーザーは左右のサイドバーを入れ替え、単一プロジェクトと複数プロジェクトのセッションリストを切り替えることができます。

READMEの構成手順で検証用のエージェント接続を作り、セッション管理、タスクボード、ファイルアクセスの各操作を別々に試す。リモート接続とプラグインを有効にする前に、アクセスモード、実行コマンド、対象ファイルの範囲をログで確認する。 第4章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

アクセスモードとリモート接続

MindFSは起動直後にローカルモードで実行され、同じマシンのブラウザでアカウントや設定なしでアクセスできます。リモートアクセス用のリレーモードでは、a9gent.comを介した暗号化トンネルを使用してローカルインスタンスを公開インターネットに公開します。ファイアウォールポートを開く必要はなく、ローカルUIのバインドボタンをクリックしてアクティブにします。プライベートチャネルモードでは、Tailscaleなどのプライベートネットワークを介してIPとポートで直接アクセスできます。セッションとファイルはエンドツーエンド暗号化で保護できます。READMEには暗号化アルゴリズムや鍵管理の詳細は記載されていません。さらに、リレーモードでは、MindFSでローカルサービスのアドレスを設定して公開し、一意の公開ドメイン名でアクセスできるようにできます。

READMEの構成手順で検証用のエージェント接続を作り、セッション管理、タスクボード、ファイルアクセスの各操作を別々に試す。リモート接続とプラグインを有効にする前に、アクセスモード、実行コマンド、対象ファイルの範囲をログで確認する。 第5章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

プラグインシステムとコマンド実行

MindFSのプラグインは、ファイルのカスタムビューです。パターンは、ファイルコンテンツを受け取り、解析し、UIをレンダリングするというものです。エージェントはリクエストに応じてプラグインを生成できます。たとえば、エージェントに「txt小説リーダーを実装して」と指示すると、txtファイルを読書体験として表示するプラグインが生成されます。プラグインは、エージェントに構造化コマンドを送信するアクションボタンを登録でき、カスタムプラグイン、ファイルブラウジング、エージェントインタラクションのループを閉じます。コマンド実行結果はカードとして表示され、以前のコマンドの履歴候補が表示されます。出力は画面幅に適応し、シェルタイプを選択できるため、Windowsユーザーにとって重要です。各セッションは長時間存続するシェルを取得し、tmuxのようなコマンド継続が可能になります。

READMEの構成手順で検証用のエージェント接続を作り、セッション管理、タスクボード、ファイルアクセスの各操作を別々に試す。リモート接続とプラグインを有効にする前に、アクセスモード、実行コマンド、対象ファイルの範囲をログで確認する。 第6章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

インストール、構成、ライセンス

プロダクションビルドは10MB未満の単一の静的コンパイル済みバイナリで、すべてのWebアセットが埋め込まれており、ホストにNode.js、Docker、デーモンマネージャは不要です。macOS/Linux（curl）とWindows（PowerShell）用のインストールスクリプトがあります。アンインストールすると、バイナリ、Webアセット、バンドルされたデフォルトのagents.json、PATHエントリが削除されますが、ユーザー設定とプロジェクトの `.mindfs/` データは残ります。ソースからのビルドにはGo 1.22+とNode.js 20+が必要です。CLIはルートディレクトリとフラグを受け入れます。`-addr` でリスンアドレス（デフォルト127.0.0.1:7331）、`-tls` で自己署名証明書を自動生成してHTTPSを有効にし、`-e2ee` でエンドツーエンド暗号化を有効にします。`config.json` ファイルで起動オプションを指定できます。カスタムACPエージェントは追加の `agents.json` ファイルで追加できます。プロジェクトはAGPL-3.0ライセンスの下で提供されています。ライセンステキストは共有と変更の自由を付与し、ネットワークサーバー上で実行される変更バージョンはユーザーにソースコードを提供することを要求します。ライセンスの抜粋とREADMEには保証やサポート条件は記載されていません。

READMEの構成手順で検証用のエージェント接続を作り、セッション管理、タスクボード、ファイルアクセスの各操作を別々に試す。リモート接続とプラグインを有効にする前に、アクセスモード、実行コマンド、対象ファイルの範囲をログで確認する。 第7章では、この章に書かれた設定名、ファイル名、コマンド、数値のいずれを確認したかを記録し、READMEの説明と実際の出力を混同しない。

編集部の結論

mindfsは、READMEに記載された機能と前提が自分の用途に重なる場合に、検証用環境から評価を始められるプロジェクトです。READMEの構成手順で検証用のエージェント接続を作り、セッション管理、タスクボード、ファイルアクセスの各操作を別々に試す。リモート接続とプラグインを有効にする前に、アクセスモード、実行コマンド、対象ファイルの範囲をログで確認する。 本番採用に向くかは、ここで確認した入力、出力、権限、ライセンスの条件が運用要件を満たすかで判断します。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes