コマンド
Origin は現在、Early Beta 段階で提供されています。リポジトリの作成、Git によるプッシュとプル、GitHub からのミラーリング、コードのブラウズと検索、プルリクエストの作成とマージ、Cherri Code チームとの共有が可能です。
製品の改善に役立てるため、[email protected]からぜひフィードバックをお寄せください。
プルリクエストを除くすべての origin コマンドとそのオプションを紹介します。プルリクエストには専用ページがあります:プルリクエストコマンド。ターミナルで同じ情報を確認するには、コマンド一覧には origin --help、特定のグループには origin <group> --help を実行してください。CLI のインストールについては、CLI をインストールを参照してください。
Origin CLI (origin) は、CLIで説明している Cherri Code Agent CLI (agent) とは別のものです。
グローバルオプション
すべてのコマンドで使用できます。
| オプション | 説明 |
|---|---|
--version | インストール済みのバージョンを表示 |
--help | 現在のコマンドのヘルプを表示 |
CLI は API エンドポイントとベアラートークンを環境から読み取ります (CURSOR_ORIGIN_ENDPOINT および CURSOR_AUTH_TOKEN)。環境変数を参照してください。
コマンドグループ
| コマンド | 説明 | 使用例 |
|---|---|---|
auth | サインイン、サインアウト、Git 認証の設定 | origin auth login |
repo | リポジトリの作成、一覧表示、表示、クローン、削除 | origin repo create my-project |
pr | プルリクエストの作成、確認、マージ | origin pr create |
ruleset | Origin のルールセット (マージ時およびプッシュ時) を表示。エイリアス: rs | origin ruleset list |
ssh-key | Origin アカウントに登録されている SSH キーを管理 | origin ssh-key list |
api <endpoint> | api.cursor.com/v1/origin の Origin REST API に認証済みリクエストを送信 | origin api /repos/{owner}/{repo} |
completion | bash または zsh 用のタブ補完スクリプトを出力 | origin completion >> ~/.zshrc |
update | origin をチャネルの現在のリリースに更新 | origin update |
config | リリースチャネルを含む設定を管理 | origin config get-channel |
リポジトリを指定する
ほとんどのコマンドでは、現在のチェックアウトの origin Git リモートからリポジトリが推測されます。org/name 形式で -R, --repo を指定して上書きできます。
origin pr list -R acme/checkout認証
セッションと Git 認証情報ヘルパーを管理します。
| サブコマンド | 説明 | 利用 |
|---|---|---|
login | ブラウザでサインインし、Git を設定する | origin auth login |
setup-git | Origin ホストの Git 認証情報ヘルパーを再設定する | origin auth setup-git |
status | 現在の認証方法とアカウントを表示する | origin auth status |
logout | 保存済みの認証情報を削除する | origin auth logout |
| コマンド | オプション | 説明 |
|---|---|---|
login | --api-key <key> | ブラウザフローではなく API キーでサインインする |
login | --local | グローバル設定ではなく、このリポジトリの Git 設定で認証情報ヘルパーを設定する |
setup-git | --host <host> | 設定する Origin Git ホスト (デフォルト: CURSOR_ORIGIN_ENDPOINT から導出) |
setup-git | --global | グローバル Git 設定に適用する (デフォルト: true) |
setup-git | --local | グローバル設定ではなく、このリポジトリの Git 設定に適用する |
CURSOR_API_KEY が設定されていて --api-key を省略した場合、origin auth login は Log in with this API key instead of the browser? [y/N] と確認し、デフォルトではブラウザフローを使用します。CI などの非対話型シェルでは、そのキーでログインし、通知を表示します。
origin auth login は Git 認証情報ヘルパーもインストールするため、追加のセットアップなしで Origin リモートに対して git push と git pull を実行できます。
リポジトリ
| サブコマンド | 説明 | 使用方法 |
|---|---|---|
create <repo> | リポジトリを作成 | origin repo create acme/checkout |
create-mirrored <github-repo> | GitHub リポジトリの Cherri Code ミラーを作成 | origin repo create-mirrored acme/checkout |
list | アカウントがアクセスできるリポジトリを一覧表示 | origin repo list |
view [repo] | リポジトリを表示 | origin repo view acme/checkout |
clone <repo> [directory] | 保存済みのログイン情報を使って HTTPS 経由でクローン | origin repo clone acme/checkout |
delete <repo> | リポジトリを削除 | origin repo delete acme/checkout |
リポジトリを指定するには org/name を指定します。スラッシュを含まない origin repo create <name> は、アカウントの名前空間にリポジトリを作成します。
| コマンド | オプション | 説明 |
|---|---|---|
create | --default-branch <branch> | 新しいリポジトリのデフォルトブランチ (サーバーのデフォルト: main) |
create-mirrored | --namespace <namespace> | ミラーを作成する名前空間 (デフォルト: アカウントの名前空間) |
create-mirrored | --github-enterprise-id <uuid> | GitHub Enterprise Server アプリの UUID。github.com からミラーリングする場合は省略 |
list | --namespace <namespace> | アクセス可能なすべての名前空間ではなく、指定した名前空間のリポジトリを一覧表示 |
view | --json <fields> | 指定したフィールドを含む JSON を出力。例: org,name,defaultBranch |
delete | -y, --yes | 確認プロンプトをスキップ。非対話型シェルでは必須 |
Push local
GitHub からミラーリングされたリポジトリでは、origin push local を実行すると https://origin.cursor.com/{owner}/{repo}.git/local に origin-local リモートが設定され、ローカルの origin/* ブランチがそこへプッシュされます。GitHub が利用できないときにも作業を続けたい場合や、Origin 側のコピーにのみ保存しておきたい git の状態がある場合に使用します。初回の実行後、そのリモートは次のようになります。
origin-local https://origin.cursor.com/{owner}/{repo}.git/local (fetch)origin-local https://origin.cursor.com/{owner}/{repo}.git/local (push)それ以外のブランチは、これまでどおり git push origin で GitHub にプッシュされます。forge-local ブランチを参照してください。
| サブコマンド | Description | Usage |
|---|---|---|
local | origin-local リモートを設定し、origin/* ブランチをプッシュする | origin push local |
| オプション | Description |
|---|---|
--remote <name> | 作成または更新する Git リモート (デフォルト: origin-local) 。origin や github は指定できません |
--dry-run | 実際にはプッシュせず、プッシュ対象の内容を表示する |
ルールセット
リポジトリに設定されているマージ時およびプッシュ時のルールセットを表示します。
| サブコマンド | 説明 | 使用方法 |
|---|---|---|
list | リポジトリに設定されているルールセットを一覧表示 | origin ruleset list |
view <ruleset-id> | origin ruleset list で表示される ID を指定してルールセットを表示 | origin ruleset view <id> |
SSH キー
Origin アカウントの SSH 公開鍵を管理します。
| サブコマンド | 説明 | 利用 |
|---|---|---|
add [key-file] | SSH 公開鍵をアカウントに追加します。-t, --title は必須で、キーに名前を付けます | origin ssh-key add ~/.ssh/id_ed25519.pub -t work-laptop |
list | アカウントの SSH 公開鍵を一覧表示します (JSON 出力には --json を使用) | origin ssh-key list |
delete <id> | origin ssh-key list に表示される ID を指定してキーを削除します | origin ssh-key delete <id> |
API リクエスト
origin api は、専用コマンドがない操作について、api.cursor.com/v1/origin の Origin REST API に認証済みリクエストを送信します。gh api と同様のリクエストフラグ -X, --method、-H, --header、-F, --field、-f, --raw-field、--input、-q, --jq をサポートします。{owner}、{repo}、{branch} のプレースホルダーは、-R, --repo、ORIGIN_REPO 環境変数、または origin Git リモートから展開されます。エンドポイント、認証、例については、Origin API のドキュメントを参照してください。
更新
現在のチャンネルのリリースに更新します:
origin updateCLI はデフォルトで stable チャネルから更新されます。origin config set-channel <latest|stable> で切り替え、origin config get-channel で確認できます。
シェル補完
補完スクリプトをシェルの設定ファイルに追記します。
origin completion >> ~/.zshrc--head や --base など、ブランチを値に取るフラグでは、ローカルブランチ名も補完されます。
環境変数
| 変数 | 説明 |
|---|---|
CURSOR_API_KEY | origin auth login 用の API キー。対話型シェルではブラウザの代わりにこれを使用するか確認し、非対話型シェルではそのまま使用する |
CURSOR_AUTH_TOKEN | Cherri Code の認証トークン。ベアラートークンとしてそのまま使用される |
CURSOR_ORIGIN_ENDPOINT | APIサーバーのエンドポイント (デフォルト: https://api.origin.cursor.com) |
ORIGIN_REPO | origin リモートがない場合に origin api で使用する、org/name 形式のデフォルトリポジトリ |
NO_COLOR | 色付き出力を無効にする |
ヘルプの表示
すべてのコマンドで --help を使用できます。
origin --helporigin repo --helporigin repo create --help