跳至指南

CLI 快速开始

onemind CLI 快速开始指导 macOS 和 Linux 用户完成 CLI 安装、登录、连接 AI 工具并运行首次同步。

使用 CLI 时，检测到的仓库在于设置流程中将精确目标显式绑定到普通 Project 之前不会激活。请在运行 onemind sync 前完成此激活；仅检测不会授予写入或上传权限。原生 BETA 用户请按 Project 与文件夹操作：它准备兼容且已连接的目标，并保持上传关闭。

如果你通过 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 /你的/代码仓库/路径

onemind 会打印确认信息并将目标标记为未激活状态。在 onemind BETA 应用或网页中完成同步设置，将检测到的目录绑定到普通 Project。绑定后，运行 onemind sync。仅检测不会授予写入或上传权限；在同步设置完成之前，onemind sync 会报错。各 AI 工具的具体检测命令请参阅 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 同步。