CLI クイックスタート

macOS または Linux から onemind CLI をインストールして有効化し、AI ツールへのレビュー済みチームメモリの同期を始めましょう。

CLI でリポジトリを検出しても、設定フローで正確なターゲットを通常 Project に明示的に関連付けるまでは無効です。onemind sync の前に有効化してください。検出だけで書き込み・アップロードは許可されません。ネイティブ BETA は Project とフォルダを使い、対応する接続済みターゲットを準備してアップロードは無効に保ちます。

macOS または Linux のターミナルから onemind を使用する場合は、このページを上から下まで実行してください。

CLI 専用インストーラーを実行します。CLI、署名済み連携バンドル、インストールバインディング、バックグラウンドサービスをインストールして検証します。macOS では OneMind.app と OneMind BETA.app のダウンロード、置換、設定、起動を行わず、AI ホストプラグインも変更しません。
リポジトリから onemind を実行し、サインインを選択します。
AI ツールのガイドを開き、その接続手順に従います。
onemind sync を実行します。
onemind status を実行し、AI ツールで新しいセッションを開始します。

サポートされているシステム

BETA 0.4.15 リリース契約には、次のネイティブ CLI ビルドが含まれます。

オペレーティングシステム	アーキテクチャ
macOS	arm64、amd64
Linux	arm64、amd64

Windows 実装は実験的なソース限定のままです。手動のネイティブ AMD64／ARM64 テストはありますが、公開署名済みアーカイブやインストーラーはなく、この BETA のサポート対象ではありません。未公開の PowerShell インストーラーを BETA の配布経路として使用しないでください。

CLI には、端末、onemind サーバーへのネットワークアクセス、および動作するオペレーティングシステムの資格情報ストレージが必要です。Linux バックグラウンドでの使用には、使用可能なシークレットサービス/キーリングと systemd --user が必要です。

インストール

公式インストーラーは最新リリースをダウンロードし、その SHA-256 チェックサムとバージョンを確認し、バイナリをインストールし、バックグラウンドサービスを登録します。再度実行すると、現在のバージョンが安全に修復されるか、新しいバージョンがインストールされます。

公開されている CLI クイックスタートのコマンドは CLI 専用です。macOS では OneMind.app と OneMind BETA.app のダウンロード、置換、設定、起動を行わず、以下に記載する CLI リリースのコンポーネントだけをインストールします。Intel Mac も CLI 専用です。Intel 版メニューバーアプリは現在公開されていません。

macOS と Linux

実行:

curl -fsSL https://onemind.team/downloads/install-onemind.sh | ONEMIND_INSTALL_APP=0 sh

この CLI 専用コマンドは、公開署名済み連携バンドルを別途ダウンロードして保存し、正確なバイト列とタグ付き GitHub リリースワークフローを確認します。クリーンインストールでは、マシン向けの公式 Cosign v2.6.2 バイナリを一時的にダウンロードし、審査済み GitHub リリースホストへの HTTPS リダイレクトだけを許可して、実行前に内蔵されたサイズと SHA-256 を照合します。一時検証器はインストーラー終了時に削除され、Unix のインストールに Python は不要です。インストーラーは、候補由来のバイナリを実行したり資産一覧を信頼したりする前に、正規形式のリリース候補を認証します。CLI、バンドル、インストールバインディング、バックグラウンドサービスをインストールしますが、OneMind.app と OneMind BETA.app のダウンロード、置換、設定、起動は行いません。また、Codex や他の AI ホストプラグインをインストール、更新、修復、削除することもありません。ホストの変更には、onemind integrations install、update、repair、uninstall の明示的な実行が必要です。Apple シリコン／Intel macOS と Linux は同じフェイルクローズのバンドル経路を使用し、アプリ内蔵コピーを信頼せず、別途 Cosign をインストールする必要もありません。更新時は連携バンドルの検証に既存の検証器を優先します。

macOS アプリ

BETA 0.4.15 は、Apple シリコン Mac 向けに bundle ID com.onemind.beta の OneMind BETA.app を公開します。DMG と更新 ZIP は署名済みのシンガポール本番 receipt で認証されますが、今回は Apple アカウントを使用しないため、アプリ自体は ad-hoc 署名で公証されていません。初回起動時は Control キーを押しながらアプリをクリックし、開くを選択して macOS の警告を確認する必要がある場合があります。BETA アプリは独立した Keychain セッションを使用し、インストール済みの Alpha OneMind.app を置き換えません。ONEMIND_INSTALL_APP=0 は引き続き CLI 専用インストール経路です。旧式の ONEMIND_INSTALL_CODEX_PLUGIN 変数は引き続き拒否され、明示的な連携操作なしにインストーラーがホストプラグインを変更することはありません。

Apple シリコン Mac に CLI と独立した BETA アプリを同時にインストールするには、次を実行します。

curl -fsSL https://onemind.team/downloads/install-onemind.sh | ONEMIND_INSTALL_APP=1 sh

デフォルトのインストール場所は ~/.local/bin/onemind です。インストーラーがそのディレクトリが PATH 上にないと言ったら、それをシェル構成に追加し、新しいターミナルを開きます。 zsh の場合:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

インストールの確認

onemind version

期待される出力:

onemind 0.4.15

正確なバージョン番号は、インストールされているリリースによって異なります。

Codex Plugin

onemind インストーラーは Codex プラグインをインストールまたは更新しません。onemind のインストール後、受動的な onemind integrations list --json を実行し、Codex の状態を確認し、必要な場合にのみ onemind integrations install codex、update codex、repair codex を明示的に実行します。インストールだけでは Codex は onemind アカウントに認証接続されません。

onemind integrations install codex は同梱の onemind-app marketplace と Codex プラグインだけをインストールします。この限定操作は CLI のインストールや修復、macOS アプリの置換、サービスの再起動、アプリの起動を行いません。CLI コンポーネントには CLI クイックスタートを使用し、macOS アプリを明示的に必要とする場合だけ、そこで個別表示された完全アプリのオプトインを使用してください。

新しい Codex タスクを開始して @OneMind をメンションします。初回利用時に onemind に接続 を選び、onemind の Web サイトにサインインして、要求された OAuth 権限を確認し、接続を承認します。この手順が完了して初めて Codex は接続され、クラウドの状態、承認済みメモリ、同期リクエストを使用できます。ローカル CLI の更新とサービス制御には、そのデバイス上の CLI が引き続き必要です。

最初の実行とサインイン

接続するリポジトリから onemind を起動します。

cd /path/to/your/repository
onemind

サインアウトすると、パレットに サインイン と アップデートを確認 が表示されます。

サインイン を選択し、Enter キーを押します。
onemind はブラウザーで認証ページを開きます。
Web サイトにサインインし、要求元の端末を承認します。
ターミナルに戻ります。onemind は、オペレーティングシステムの資格情報ストアにセッションを保存し、承認されたアカウントとデバイスを報告します。
Esc キーを押すとコマンドパレットに戻ります。

ブラウザのリクエストは、時間内に完了しないと期限切れになります。新しいリクエストを作成するには、もう一度 サインイン を選択します。パスワードが CLI に入力されることはありません。

サインイン後、現在のディレクトリを AI ツールの Project ターゲットとして検出します。Codex の場合：

onemind project codex /path/to/your/repository

onemind は確認を出力し、ターゲットを非アクティブとしてマークします。onemind BETA アプリまたは Web で同期設定を完了し、検出されたディレクトリを通常の Project に関連付けます。関連付け後、onemind sync を実行します。検出だけでは書き込み・アップロードは許可されません。同期設定が完了するまで onemind sync はエラーを出力します。ツール固有の検出コマンドについては、AI ツールガイドの各ガイドをご覧ください。

macOS のメニューバーについては、macOS アプリをご覧ください。

macOS で onemind を実行したときに「OneMind is running in Terminal, but the menu-bar app is not installed. Re-run the official installer to add it.」が表示された場合、インストーラーが CLI と一緒に macOS アプリをインストールしていません。上記の ONEMIND_INSTALL_APP=1 インストーラーコマンドを使用するか、メッセージを無視してください。これは CLI の同期に影響しません。