Origin CLI 安装与命令
使用 origin 管理仓库、认证、规则和 API,区分其环境变量与 Agent CLI。
Origin CLI 使用 origin 可执行文件,支持 macOS、Linux 和 Windows WSL,独立于 agent。
curl -fsSL https://downloads.cursor.com/origin/install.sh | sh
origin --version
origin auth login安装在 ~/.local/bin/origin,找不到命令时将 ~/.local/bin 加入 PATH。登录浏览器使用有 Origin 资格的 Cursor 账号,同时配置 Git credential helper。
认证
origin auth status 查看身份,auth setup-git 重设 helper,auth logout 清理已存凭据。login --local 把 helper 限在当前仓库,默认配置为全局。
CURSOR_API_KEY 已设且未给 --api-key 时,交互 login 询问是否改用 key,默认仍走浏览器;非交互 shell 自动用 key 并提示。CURSOR_AUTH_TOKEN 是直接使用的 bearer token,不同于登录 API key。
常用命令
| 命令 | 作用 |
|---|---|
| origin repo create my-project | 在账号 namespace 创建,默认 branch main |
| origin repo list | 列可访问仓库 |
| origin repo clone acme/checkout | 使用保存的登录 clone |
| origin repo create-mirrored acme/checkout | 建立 GitHub 镜像 |
| origin ruleset list | 读取 merge/push 规则集,别名 rs |
| origin ssh-key list | 查看已登记 SSH 公钥 |
| origin update | 更新当前 release channel |
repo delete 要完整 org/name;非交互删除须 --yes,不能仅传短名称。create-mirrored 可用 --namespace 指定目标,GHES 需 --github-enterprise-id。
仓库推断与 API
多数命令从 origin remote 推断仓库,-R/--repo 可给 org/name。origin api 请求公共 REST API,支持 --method、--header、--field、--raw-field、--input、--jq。
其 {owner}/{repo}/{branch} 从 -R、ORIGIN_REPO 或 remote 展开;ORIGIN_REPO 是无 origin remote 时的默认仓库。CURSOR_ORIGIN_ENDPOINT 默认 https://api.origin.cursor.com,而 origin api 文档指定的公共 REST base 是 https://api.cursor.com/v1/origin;两者用途不同,不自行给默认 endpoint 拼公共路径。
更新与帮助
默认 stable channel,可用 origin config set-channel latest 或 stable 切换,get-channel 查看。每个命令支持 --help;PR 参数见Pull requests。