跳至指南

CLI 快速開始

onemind CLI 快速開始指導 macOS 和 Linux 用戶完成 CLI 安裝、登入、連接 AI 工具並執行首次同步。

CLI 檢測到倉庫後，仍需在設置流程中把精確目標顯式綁定到普通 Project，才能運行 onemind sync；檢測不會授予寫入或上傳權限。原生 BETA 用戶請按 Projects 與資料夾操作：它準備兼容且已連接的目標，並保持上傳關閉。

如果你通過 macOS 或 Linux 終端使用 onemind，請按順序完成本頁步驟：

  1. 運行僅 CLI 安裝程序。它會安裝並驗證 CLI、已簽名集成包、安裝綁定和後台服務。在 macOS 上，它不會下載、替換、配置或打開 OneMind.app 或 OneMind BETA.app，也不會更改 AI 宿主插件。
  2. 在代碼倉庫中運行 onemind，然後選擇登入。
  3. 打開對應 AI 工具指南，並按照其中的連接步驟操作。
  4. 運行 onemind sync。
  5. 運行 onemind status，然後在 AI 工具中新建會話。

支持的系統

BETA 0.4.15 發佈契約包含以下平台的原生 CLI：

操作系統架構
macOSarm64、amd64
Linuxarm64、amd64

Windows 實現仍處於實驗性、僅源碼階段。它提供手動原生 AMD64 與 ARM64 測試，但沒有公開簽名壓縮包或安裝程序，也不屬於本 BETA 的支持範圍。請勿把尚未發佈的 PowerShell 安裝程序用作 BETA 分發路徑。

CLI 需要終端、到 onemind 伺服器的網絡連接，以及可用的操作系統憑據存儲。Linux 後台運行還需要可用的 Secret Service/keyring 和 systemd --user。

安裝

官方安裝程序會下載最新版本，校驗 SHA-256 checksum 和版本，安裝二進制檔案，並註冊後台服務。再次運行安裝程序可以安全地修復當前版本或升級到新版本。

公開的 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 芯片 macOS、Intel macOS 和 Linux 使用同一條失敗即關閉的集成包路徑；安裝程序不會信任應用內嵌副本，也不需要另行安裝 Cosign。升級時會優先使用此前已安裝的驗證器來核驗集成包。

macOS 應用

BETA 0.4.15 為 Apple 芯片 Mac 發佈 bundle ID 為 com.onemind.beta 的 OneMind BETA.app。DMG 與更新 ZIP 由已簽名的新加坡生產 receipt 認證；由於本次發佈不使用 Apple 帳戶，App 本身使用 ad-hoc 簽名且未經公證。首次打開時，可能需要按住 Control 點擊 App、選擇打開並確認 macOS 警告。BETA App 使用獨立鑰匙串會話，不會替換已安裝的 Alpha OneMind.app。ONEMIND_INSTALL_APP=0 仍是僅安裝 CLI 的路徑。舊的 ONEMIND_INSTALL_CODEX_PLUGIN 變量仍會被拒絕；安裝程序不會在沒有明確集成操作時更改宿主插件。

在 Apple 芯片 Mac 上同時安裝 CLI 與獨立 BETA App，請運行：

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

默認安裝位置是 ~/.local/bin/onemind。如果安裝程序提示該目錄不在 PATH 中，請將它加入 shell 配置，然後打開新的終端。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 網站登入，查看請求的 OAuth 權限並批准連接。只有完成這一步，Codex 才真正連接並可使用雲端狀態、已批准的記憶和同步請求；本機 CLI 更新和服務控制仍需要在該設備安裝 CLI。

首次運行和登入

請從準備連接的程式碼倉庫啟動 onemind：

cd /你的/程式碼倉庫/路徑
onemind

退出登入時，命令面板會顯示登入和檢查更新。

  1. 選擇登入，然後按 Enter。
  2. onemind 會在瀏覽器中打開授權頁面。
  3. 在網站中登入，並批准發起請求的終端。
  4. 返回終端。onemind 會把會話保存在操作系統的憑據存儲中，並顯示已授權的帳戶和設備。
  5. 按 Escape 返回命令面板。

瀏覽器請求在未及時完成時會過期。再次選擇登入即可創建新請求。你不需要在 CLI 中輸入密碼。

登入後，請偵測當前目錄，將其設為 AI 工具的 Project 目標。以 Codex 為例：

onemind project codex /path/to/your/repository

onemind 會輸出確認訊息並將該目標標記為未啟用。請在 onemind BETA 應用或網頁完成同步設定，將偵測到的目錄綁定到普通 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.」，說明安裝程序未同時安裝 macOS 應用。請使用上述 ONEMIND_INSTALL_APP=1 安裝命令，或忽略此訊息；它不影響 CLI 同步。