CLI を使い始める

クイックスタート

初めての登録はアカウント作成、同じアカウントで別の対象を始める場合は新しいワークスペースへ進みます。このページは既存アカウントで認証し、最初のデータを読む手順です。

1. ログインする

orc auth login

端末に表示されたURLをブラウザーで開き、サインインしてCLIの認可を完了します。認証情報はCLIに保存されます。通常の利用のたびに登録や認証を繰り返す必要はありません。

ブラウザーが自動で開かなければ、端末のURLを開きます。非対話の端末からブラウザー認証を明示的に開始する場合はorc auth login --webを使います。

orc auth status --json

シークレット管理ツールから API キーを環境変数へ設定している場合は、標準入力から初期化できます。

printf '%s' "$ORCHESTOR_API_KEY" | orc init

orc workspace current
orc workspaces list
orc workspace use YOUR_WORKSPACE_ID

YOUR_WORKSPACE_ID を一覧に表示された ID に置き換えます。データ操作ごとに --workspace で対象を指定することもできます。

ブラウザーのログイン完了表示だけでは、ワークスペースへのアクセス成功は確認できません。招待や初回の組織設定が残っている場合はWelcomeで進めます。

orc brands list --format table
orc prompts list --json
orc reports visibility get --json

新しいワークスペースではブランド一覧が空でも正常です。認証・対象の選択・実際のデータ取得をそれぞれ確認します。

エージェントを接続して取得を確かめるで、Skills の追加とクライアント別の hosted MCP 認証を進めます。

ブランドや回答がまだない場合は、初回観測で設定候補の生成・確定・結果取得まで進めます。

別の資格情報を保存する場合は名前付きプロファイルを使います。

orc auth login --profile my-project
ORCHESTOR_PROFILE=my-project orc auth status --json
ORCHESTOR_PROFILE=my-project orc workspaces list --json

同じアカウントで新しいワークスペースを作るだけなら、別のプロファイルや再ログインは不要です。ワークスペース作成へ進みます。

APIキーを環境変数に設定している場合は、保存されたサインイン情報より優先されます。orc status --jsonで使用中の認証元を確認します。人が操作しないCIはAPIキーの設定とCIの権限設定を参照してください。