CLI サービスとファイル

onemind CLI サービスとファイルのページでは、バックグラウンドサービス、Mind ライブラリ、更新手順、各インストール済みコンポーネントのローカル状態を説明します。

バックグラウンドサービス

インストーラーはユーザーごとのサービスを登録します。

• macOS: ~/Library/LaunchAgents/com.onemind.cli.daemon.plist の LaunchAgent
• Linux: ~/.config/systemd/user/onemind.service の systemd ユーザーサービス

次のようにして確認してください。

onemind service status

次のようにして再起動します。

onemind service stop
onemind service start

バイナリを移動するかインストールを修復した後、その定義を再作成します。

onemind service install

macOS では、デーモン出力は ~/Library/Logs/OneMind/daemon.log（標準出力）と ~/Library/Logs/OneMind/daemon-error.log（エラー出力）に書き込まれます。

Mind ライブラリ

Mind ライブラリは Project 単位のプライベート ファイル領域です。既定では、onemind files は現在の作業ディレクトリを含む最も具体的な通常 Project binding を解決し、Team Project へ暗黙にフォールバックしません。Team Project を意図する場合だけ --team を指定します。同じファイルは onemind BETA アプリの Mind ライブラリページでも利用できます。

onemind files を使用して、ライブラリ全体とそのクォータの概要をリストします。--prefix を追加して 1 つのディレクトリのようなパスを検査するか、--json で機械可読出力を得られます。

onemind files
onemind files list --prefix skills/writing
onemind files list --prefix assets --json
onemind files list --team

管理対象の AI 指示が使用する最小限のタスクごとの鮮度確認には、次を実行します。

onemind files check --quiet --wait --ai codex

バックグラウンドサービスは通常、起動時、関連サーバーイベント、認証またはネットワーク再接続時、およびバックオフ対応の 15 分フォールバックで、AI を介さず承認リクエストを作成または再利用しながら割り当て済みファイルを確認します。管理対象の指示は割り当て済み相対パスを列挙し、複数ツールの Project でも曖昧にならないよう、--ai で正確な呼び出し元を常に指定します。コマンドは projectIDs と aiTargets の割り当てがそのバインディングに完全に一致するファイルのみを対象とします。ローカルの通常ファイルをハッシュし、シンボリックリンクや特殊ファイルを拒否し、メタデータのみをサーバーへ送信します。現在の待機中は完全に無音です。承認時は Updated <path>. のみを出力します。拒否は project_file_refused と終了コード 3 を返し、そのファイルに依存する作業を停止し、自動再試行は禁止です。リクエスト期限に基づくネットワークまたはサーバーの再試行予算を使い切ると、project_file_wait_exhausted と終了コード 4 を返し、自動再試行も禁止します。保留もリクエストが残っている間は非ゼロ終了コードを返します。終了コード 0 になった場合、呼び出し元は依存する前に更新済みローカルファイルを読む必要があります。

古いファイルは 1 件のデバイススコープリクエストを作成または再利用します。onemind BETA アプリの Project ファイル更新ページで承認、拒否、保留、またはキャンセルしてください。保留は状態を pending のままにします。公開状態は pending、refused、approved_awaiting_apply、applied、expired、conflict、failed に限定されます。状態待ちは認証済みの有界ロングポーリングと再接続バックオフを使い、頻繁なポーリングは行いません。一回限りの承認後、シングルライター実行プロセスが両方のハッシュと選択した Project head を再検証し、ダウンロード済みコンテンツを検証して、チェックアウト外の onemind 所有のアプリケーション状態に正確な復旧コピーを保存し、フラッシュ済みの隣接一時ファイルで置き換え、結果を確認します。ローカル、リモート、バインディング、シンボリックリンク、特殊ファイル、または有効期限のいずれかが変化すると失敗します。待機コマンドを閉じてもリクエストはキャンセルされないため、サービスは後の承認を適用できます。

適用済みの ID は OS の onemind アプリケーション状態ディレクトリ内のバージョン付きチェックポイントマニフェストに記録されます。ローカルのリクエスト・置換証跡と復旧コピーはその隣に保存され、Project checkout 内には置かれません。進行中の適用はクラッシュ後に同じ一回限りの認可を回収または再開できるよう、デバイス固有の試行 ID、確認冪等キー、ネゴシエート済みプロトコル、段階、回転する短期リースを mode 0600 マニフェストに永続化します。旧サーバーの grant は再クレームなしに永続的に再開されます。terminal 状態では秘密情報を削除します。復旧領域は 100 MiB に制限され、保護されていないコピーは 7 日後に削除されます。

管理対象チェックのターゲットキー：codex、cursor、qoder、claude_code、antigravity、openclaw、opencode、hermes、pi、grok_build、deepseek_harness、trae、workbuddy。Mind 割り当てアップロードのターゲットキー：codex、cursor、qoder、claude_code、antigravity、openclaw、opencode、hermes、pi、grok_build、deepseek_harness、trae、workbuddy。

Mind パスは、スラッシュで区切られた相対パスです。アップロードごとに --ai が必須で、そのファイルを使用できる AI 対象を明示します。上記の Mind 割り当てアップロードのターゲットキーを使い、複数の対象には --ai codex,cursor のようなカンマ区切りを使用します。--to を使用せずに単一のファイルを送信すると、そのローカル ファイル名が使用されます。たとえば、これは ChatGPT（codex）と Cursor 用の release-review.md を提案します。

onemind files upload --ai codex ./release-review.md

--to を使用して、明示的な Mind パスを選択します。プロンプト ファイルは通常、prompts/ 以下に保管されます。

onemind files upload --ai codex,cursor --to prompts/release-review.md ./release-review.md

ディレクトリは再帰的にアップロードされます。 --to は Mind の宛先ルートであり、すべての子孫はその相対パスを保持します。このローカル スキル ディレクトリがあるとします。

writing/
├── SKILL.md
├── examples/
│   └── example.json
└── references/
    └── style.md

次のようにアップロードします。

onemind files upload --ai codex,claude_code --to skills/writing ./writing

保留中のレビュー キューは skills/writing/SKILL.md、skills/writing/examples/example.json、および skills/writing/references/style.md の変更提案を受け取ります。ディレクトリの事前検証で未対応形式が見つかった場合、ファイルを送信する前にアップロードを停止します。

--to がない場合、ディレクトリはローカル ディレクトリ名を Mind ルートとして使用します。サーバーは各送信ファイルを承認済みの Mind main と比較します。存在しないパスは「新規ファイル」、既存パスの変更は「新しいバージョン」として分類され、同一内容は変更なしと報告されて提案を作成しません。新規ファイルと新しいバージョンの提案は、管理者が選択したプロジェクトの Mind ライブラリ ページで明示的に承認または拒否するまで保留されます。

複数ファイルの提案は順次送信されます。後のファイルが失敗した場合、以前の提案は保留されたままですが、承認済みの Mind main は変更されません。エラーを解決し、ライブラリ ページの保留中キューを確認してからコマンドを再実行してください。完全に同一の再試行は既存の保留中提案を再利用し、重複を作成しません。承認時にのみ、不変の Mind コミットが追加され、古いバージョンがプロジェクト履歴に保持され、クォータ使用量が更新されます。

ダウンロードでは、1 つの正確な Mind ファイルがアドレス指定されます。 --output を指定しないと、CLI はMind ファイルのベース名を現在のディレクトリに書き込みます。 --force が存在しない限り、既存のローカル ファイルの上書きは拒否されます。

onemind files download skills/writing/SKILL.md
onemind files download --output ./writing-SKILL.md skills/writing/SKILL.md
onemind files download --force --output ./writing-SKILL.md skills/writing/SKILL.md

削除には常に --yes が必要です。 --recursive を使用しない場合、パスは 1 つのファイルと正確に一致する必要があります。 --recursive の場合、削除には / パス セグメント境界の後の正確なパスと子孫が含まれます。同様の名前の兄弟プレフィックスは選択されません。

onemind files delete --yes prompts/release-review.md
onemind files delete --recursive --yes skills/writing

再帰的削除も順次実行され、アトミックではありません。後の削除が失敗した場合、操作の以前に削除されたファイルは削除されたままになります。残りのプレフィックスを調べてエラーを解決し、確認済みの同じコマンドを再実行してクリーンアップを終了します。

ライブラリ ファイルは不活性ストレージです。プロンプト ファイルをアップロードしても、アクティブなプロジェクト Mind の変更、チームメモリの公開、提案と管理者レビューの迂回は起きません。スキル、スクリプト、フック、アセットもアップロードだけではインストールも実行もされません。onemind sync はスキルを変更しません。onemind skills status の後、読み取り専用の onemind skills resolve NAME で最新スキルの検証済み SKILL.md パスを取得できますが、ホストのタスク開始時スキル一覧が更新されたとは主張しません。install、update、uninstall は正確な名前を明示的に選択してください。onemind はダウンロード、ローカル変更、Project 境界を検証し、回復可能な隔離と監査記録を保持します。

onemind を更新する

リリースを読み取り専用で確認するには onemind update --check を実行します。コマンドパレットのアップデートを確認も同じ読み取り専用確認を実行します。引数なしの onemind update は、公式の署名付きインストーラーの手順を表示し、何も変更せず、安定した操作必須ステータス 3 で終了します。そのため、自動処理が更新完了と誤認しません。どちらもサービスの停止や起動、成果物のダウンロード、CLI バイナリの置換、ローカル状態の変更を行いません。

バックグラウンドサービスは起動時と 6 時間ごとに新しいリリースを確認し、新しいバージョンが見つかると stderr に 1 行の通知を出力し、macOS と Linux ではデスクトップ通知も送信します。同じバージョンに対して通知は繰り返されません。

リリースをインストールするには、CLI クイックスタート からオペレーティングシステム用の公式インストールコマンドを再実行してください。公開されている macOS／Linux の更新コマンドは CLI 専用で ONEMIND_INSTALL_APP=0 を使用し、macOS では OneMind.app と OneMind BETA.app のダウンロード、置換、設定、起動を行いません。公式インストーラーは、CLI、署名済み AI ツール連携バンドル、インストールバインディングをまとめて更新しますが、AI ホストプラグインは変更しません。CLI バイナリだけを置き換えると、完全な署名付きリリースがインストールされるまで連携状態が repair_required になる可能性があるため、単独で置き換えないでください。その後、受動的な onemind integrations list --json を実行し、必要な操作を示すターゲットのみを明示的にインストール、更新、修復してください。

ファイルとローカル状態

同じ Project とルートにあるすべての有効なツール binding は、このキューを共有します。デーモンによる決定的な binding 選択は、アップロード認証ルートにのみ使われます。schema v11 の LearningEvent には生成ツールの識別情報がなく、提案レスポンスにも生成ツールの識別情報は含まれません。この欠如は生成元を帰属できないことを意味し、選択されたアップロード用ツールが生成したことを意味しません。保持されるデバイスとアカウントは、認証された送信ルートと提出者を示すだけで、生成プロセスを示しません。

管理対象マーカーを手動で編集しないでください。マーカーの欠落、重複、反転、または形式が不正な場合、ユーザー所有のコンテンツが危険にさらされる代わりに、同期が停止します。