ZeroMind (OrigoZero game engine)

@origozero/zeromind

@origozero/zeromindは2つの要素で構成されています。1つは、エージェントのハーネス独自の設定に記述されるリモート ZeroMind MCP サーバー（https://origozero.ai/mcp）の宣言です。もう1つは、何かを構築する前に ZeroMind を確認するようエージェントに教えるスキルです。お使いのマシン上では何も実行されません。CLI はマシンを ZeroMind アカウントにリンクし、サーバーエントリーを書き込んで終了します。その後、エージェントが呼び出すすべてのツール（ZeroMind のコンテンツ検索、ワールド、および現在開いているワールドのエンジン）は、ZeroMind から HTTPS 経由で提供されるため、ZeroMind が新しいツールをリリースすると、ここで何もアップグレードしなくてもすぐに利用できます。

サポート対象の各ハーネス（Claude Code、Cursor、Codex CLI、Gemini CLI、OpenCode、Cline、Continue、Windsurf、Zed、openClaw、JetBrains Junie、Sourcegraph Amp、GitHub Copilot、Block Goose、Aider）には、そのハーネス独自のネイティブな仕組み（スキル、AGENTS.md、GEMINI.md、.cursor/rules/*.mdc、.clinerules、CONVENTIONS.md、.goosehints）を通じてオンボーディングを行い、さらにそのハーネスが読み込む設定ファイルに MCP エントリーを追加します。独自に作り込まれた連携機能がないハーネスでは、ide/README.mdに記載されている汎用的なストリーミング可能 HTTP 接続設定を使用します。

リンク後にエージェントが利用できるもの：ZeroMind ライブラリ（検索、詳細確認、プレビュー、インストール、利用）、ワールド（一覧表示、作成、フォーク、起動、接続、および元に戻せる削除／ゴミ箱への移動／復元）、そして接続中のワールドのエンジン自体（execute、guides、capture、VFS、bash）。https://origozero.ai/mcpのtools/listが現在の機能一覧です。機能は同梱されるのではなくサーバーから提供されるため、この README では列挙していません。

前提条件

zeromind link、zeromind install、zeromind upload、zeromind openを実行するには、Node.js 18 以降が必要です。PATH に通しておいてください。その後、ハーネスは HTTPS 経由でhttps://origozero.ai/mcpと通信し、ローカルでは何も起動しません。

• macOS： brew install node（または https://nodejs.org からダウンロード）
• Linux： ディストリビューションのパッケージマネージャー、または https://nodejs.org ／ nvm
• Windows： https://nodejs.org（LTS インストーラー）。インストール後、新しい PATH が反映されるよう IDE を再起動してください

node --versionで確認できます。

インストール

Claude Code

/plugin marketplace add OrigoZero/zeromind-plugin
/plugin install zeromind
npx -y @origozero/zeromind link

このバンドルにはスキルと、Authorizationヘッダーで${ZEROMIND_INSTALL_SECRET}を展開する.mcp.jsonが含まれています。zeromind linkは、この変数を~/.claude/settings.jsonのenvに書き込みます。新しい設定を読み込ませるため、その後 Claude Code を再起動してください。

その他すべてのハーネス

npx -y @origozero/zeromind install <harness>

ハーネスごとにコマンドを1つ実行します。まだリンクされていない場合は、まずマシンをリンクし、ハーネスのネイティブな指示ファイルを書き込み、そのハーネス独自の MCP 設定に/mcpエントリーを追加します。

npx -y @origozero/zeromind install claude       # .claude/skills/zeromind-{getting-started,library}/SKILL.md
npx -y @origozero/zeromind install cursor       # .cursor/rules/zeromind.mdc
npx -y @origozero/zeromind install codex        # ~/.codex/AGENTS.md (or ./AGENTS.md)
npx -y @origozero/zeromind install gemini       # ~/.gemini/GEMINI.md (or ./GEMINI.md)
npx -y @origozero/zeromind install opencode     # .opencode/skills/zeromind/SKILL.md
npx -y @origozero/zeromind install cline        # .clinerules/zeromind.md
npx -y @origozero/zeromind install continue     # .continue/rules/zeromind.md
npx -y @origozero/zeromind install windsurf     # ./AGENTS.md
npx -y @origozero/zeromind install zed          # .claude/skills/zeromind/SKILL.md
npx -y @origozero/zeromind install openclaw     # skills/zeromind/SKILL.md
npx -y @origozero/zeromind install junie        # ./AGENTS.md
npx -y @origozero/zeromind install amp          # ./AGENT.md
npx -y @origozero/zeromind install copilot      # .github/copilot-instructions.md
npx -y @origozero/zeromind install goose        # ~/.config/goose/.goosehints
npx -y @origozero/zeromind install aider        # ./CONVENTIONS.md
npx -y @origozero/zeromind install hermes       # ~/.hermes/config.yaml + plugin bundle

npx -y @origozero/zeromind install --list       # enumerate

すべてのコマンドは冪等です。共有ファイル（AGENTS.md、GEMINI.md、CONVENTIONS.md、.goosehints、copilot-instructions.md）には区切り付きの``ブロックが含まれており、同じ場所で置き換えられます。管理対象ファイル（スキル、ルールファイル）を上書きするには--forceが必要です。MCP 設定を書き込むパスがないハーネスが2つあります。openClaw の設定場所は未確認で、Aider はコマンドラインでサーバーを指定するため、インストール時に貼り付け用のエントリーが表示されます。ide/README.mdには、ハーネスごとの README を含む全体表があります。

リンク

マシンのリンクは一度だけ行います。リンクには Zero エンジンと同じものが使われます。どちらも OS の設定ディレクトリにある session.json（~/.config/zero/session.json、Windows では %APPDATA%\zero\session.json、Windows 以外ではモード 0600）を読み書きします。どちら側からリンクしても両方がリンクされ、リンクを解除すると、そのマシン上のすべてのハーネスが一度に取り消されます。

npx -y @origozero/zeromind link                       # device code, approved in the browser
npx -y @origozero/zeromind link --username <handle>   # pre-fill the approval page's agent name
npx -y @origozero/zeromind status                     # what this machine is linked as
npx -y @origozero/zeromind unlink                     # revoke it

link はこのマシンを独自の ZeroMind プリンシパルとして登録し、URL とコードを表示して、そのページで承認されるまで待機します。承認されたアカウントがエージェントの ID になります。あなたのアカウントとは別の、そのエージェント自身の ZeroMind アカウントです。

以前の実行、または同じファイルに書き込む Zero エンジンによってリンクされ、すでに承認済みのインストール情報があるマシンでは、link はそのマシンが誰として動作するかを表示し、新しいコードを求めず、引き続きシークレットを Claude Code に渡します。マシンごとにリンク済みインストールは 1 つだけです。マシンが動作するアカウントを変更するには、unlink を実行してから link を実行します。

unlink は ZeroMind でインストールを取り消し、このマシンのキャッシュから削除します。削除されるのはインストール情報のフィールドのみなので、Zero エンジンがサインインに使用したセッションと、そのサインイン先の発行者はそのまま残ります。ZeroMind から該当するインストールがないと返された場合でも、ローカルの情報は消去されます。取り消しをまったく実行できない場合は、何も消去されず、ZeroMind に接続できるようになってから再実行するようコマンドが案内します。

unlink は、取り消し対象のシークレットが ~/.claude/settings.json に保存されている場合、そこから ZEROMIND_INSTALL_SECRET も削除します。取り消しを実行する前に行うため、設定ファイルを読み込めない場合はその旨が報告されますが、リンク解除は完了します。（その 1 行は、その後自分で削除してください。）ほかのハーネスに install <harness> が書き込んだ項目には、取り消し済みのシークレットが残るため、再度リンクしてそのハーネスのインストールを実行するまで 401 が返されます。コマンドの実行時にその旨が案内されます。

ハーネスが提示する認証情報は、そのインストールのシークレットで、Authorization: Bearer ins_sec_… として送信されます。いずれかのツールから 401 / invalid_token が返された場合、マシンはリンクされていません（または、項目に古いシークレットが残っています）。link を実行し、install <harness> を再実行して項目を書き換え、ハーネスを再起動してください。

ローカルファイルをワールドにアップロードする

npx -y @origozero/zeromind upload <path> --world <name-or-guid> [--to <vfs dir>]

このマシンからワールドのエンジン VFS に、ファイル、または相対的な配置を保持したフォルダーをコピーします。配置先は、--to で指定しない限り /source です。バイトデータはディスクからワールドの write_file に base64 として送信されるため、アセットパックがエージェントのコンテキストウィンドウを通過することはありません。書き込みを行う前に、上限の 256 MiB と 10 000 ファイルが確認されます（--max-bytes / --max-files で上限を引き上げられます）。エンジンが実行されていないワールドは、途中まで書き込まずにその旨が報告されます。

このマシンでワールドを開く

npx -y @origozero/zeromind open <world guid | name | https url | zero:// url> [--play | --edit] [--native | --browser] [--dry-run]

エージェントが呼び出すすべてのツールは ZeroMind によって提供されます。ZeroMind にはブラウザーのタブも、このマシン上のエンジンプロセスもありません。world.open と world.launch はワールドを開く場所を返し、このコマンドがワールドをここで開きます。デフォルトではワールドのエディターを開き、--play を指定するとプレイヤー画面を開きます。このマシンに zero:// ハンドラーが登録されていればデスクトップエンジンに URL を渡し、登録されていなければブラウザーのタブに渡します。--native / --browser で開き方を明示でき、選択内容は session.json と同じ場所にある open.json に記憶されます。そのため、以降の呼び出しでどちらのフラグも指定しない場合は、選択した方法が使われます。--dry-run は対象と URL を表示しますが、何も変更しません。

GUID または URL を開く場合、ネットワーク呼び出しは一切行いません。名前を指定した場合は、このマシンのインストールシークレットを使って、/mcp 経由で自分のワールドから検索します。シークレットが表示されることはありません。エンジンへの接続は一切行いません。

ローカル／セルフホストの ZeroMind を指定する

2 つの環境変数で、CLI 全体の接続先バックエンドを切り替えられます。

変数	デフォルト	制御する内容
ZEROMIND_ISSUER	https://origozero.ai	すべての REST 呼び出し（/v1/installs/*、/v1/worlds、…）のベース URLと、ハーネスの設定に書き込まれる /mcp URLです。また、/link の承認ページのオリジンでもあります。
ZEROMIND_CONFIG_DIR	~/.config/zero（XDG、Windows では %APPDATA%\zero）	このマシンが Zero エンジンと共有する install_id／install_secret を含む session.json の保存先です。別の場所（例：~/.config/zero-local）を指定すると、本番環境に登録済みの認証情報を再利用するのではなく、ローカルバックエンド用の新しいインストール IDを取得できます。

ローカルの ZeroMind 開発スタックでは、イシュアーに :3001 の API 直結先ではなく、フロントドア（http://127.0.0.1:3003）を指定してください。フロントドアは /v1 REST サーフェス、/mcp、ウェブアプリ（/link と /edit/<guid> エンジンページを含む）を単一のオリジンで提供します。これは CLI が前提としている構成です。

ZEROMIND_ISSUER=http://127.0.0.1:3003 \
ZEROMIND_CONFIG_DIR=$HOME/.config/zero-local \
  npx -y @origozero/zeromind link

ZEROMIND_ISSUER=http://127.0.0.1:3003 \
ZEROMIND_CONFIG_DIR=$HOME/.config/zero-local \
  npx -y @origozero/zeromind install claude

接続先には、ローカルアドレス上で本番環境と同じ形式のエントリが設定されます。

// .mcp.json
{
  "mcpServers": {
    "zeromind": {
      "type": "http",
      "url": "http://127.0.0.1:3003/mcp",
      "headers": {
        "Authorization": "Bearer ins_sec_...",
        "X-ZM-Harness": "claude-code"
      }
    }
  }
}

Claude Code CLI を使う場合：

claude mcp add --transport http zeromind http://127.0.0.1:3003/mcp \
  --header "Authorization: Bearer ins_sec_..." \
  --header "X-ZM-Harness: claude-code"

プレーンな http:// のイシュアーでも、最初から最後まで動作します。各リクエストでは Bearer ヘッダーで認証するため、Cookie は不要で、TLS が必須という前提もありません。

更新

• ツールは https://origozero.ai/mcp から提供されます。どのハーネスも実行中のバージョンに接続するため、マシン上でアップグレードする必要はありません。
• zeromind install <harness> が書き込んだ成果物 — 指示ブロック、スキル、MCP エントリ — は、インストールコマンドを再実行すると更新されます。
• Claude Code バンドル（スキル＋.mcp.json）は /plugin 経由で更新されます。

メンテナー向け：package.json の version が信頼できる唯一の情報源です。tests/directory-manifests.test.ts は、名前が記載されたマニフェストのバージョンが異なる場合に失敗します。

ステータス

0.7.1 — プラグインは独自の MCP サーバーを実行しません。マシンをリンクし、リモートの /mcp エントリを 16 個のハーネスに書き込み、ローカルファイルをワールドにアップロードし、このマシンでワールドを開き、2 つのスキルを同梱します。ツールの提供元は ZeroMind で、https://origozero.ai/mcp からライブで提供されます。テストでは、同梱のモック ZeroMind サーバー tools/mock-zeromind/ に対して CLI を最初から最後まで実行します。

このリリースには、書き込む共有 session.json に install_secret を保持する Zero エンジンが必要です。キャッシュ済みセッションの構造体にこのフィールドがないエンジンでは、ファイルを再シリアライズする際にフィールドが削除され、次回 CLI を実行するとマシンが未リンクとして認識されます。そのため、0.7.1 はこのエンジンリリースの後に提供されます。

開発

npm install
npm test          # builds, then runs the suite against the bundled mock ZeroMind server
npm run build     # compile TypeScript
npm run lint

エージェントの正式な操作マニュアルは templates/manual.md にあります。ハーネスごとのインストーラーはすべて、このファイルを各ハーネスが求めるフロントマターでラップします。ハーネスを追加するには、src/cli-install.ts にエントリを 1 つ追加し、ide/<harness>/README.md を用意します。

ディレクトリマニフェスト

4 つのプラグインディレクトリは、このリポジトリのルートにあるマニフェストを読み込みます。

ディレクトリ	ルートファイル	読み込む内容
Claude Code マーケットプレイス	.claude-plugin/marketplace.json、.claude-plugin/plugin.json	skills/、.mcp.json
Gemini CLI 拡張機能ギャラリー	gemini-extension.json	skills/、コンテキストファイルとしての templates/manual.md
Codex プラグイン	.codex-plugin/plugin.json	skills/、dist-publishing/codex-plugin/.mcp.json
Cursor マーケットプレイス	.cursor-plugin/marketplace.json	dist-publishing/cursor-plugin/ 内のバンドル

これらのファイルや dist-publishing/ 内のバンドルを生成するものはありません。tests/directory-manifests.test.ts は CI で実行され、ルートマニフェストとバンドルに食い違いがある場合、いずれかに記載されたパスが解決できない場合、またはバンドル内の skills/ のコピーが元のものと異なる場合に失敗します。

リリース

1. package.json と、tests/directory-manifests.test.ts がバージョンを照合するすべてのマニフェストで、version を更新します。
2. git tag vX.Y.Z && git push --tags を実行すると、公開ワークフローが開始されます。

リポジトリの設定で、@origozero npm 組織にスコープを設定した NPM_TOKEN シークレットが必要です。

セキュリティ

脆弱性の報告方法については、SECURITY.md をご覧ください。

ライセンス

MIT です。LICENSE をご覧ください。