環境変数一覧

cos コマンドはすべてのフラグを環境変数で代替できます。CI やスクリプトでの利用に便利です。

認証・接続

COS_SID — connect.sid セッション ID。設定するとログイン済みとして扱われます (--profile 未指定時のみ有効)

COS_PERSONAL_ACCESS_TOKEN — Personal Access Token (PAT)。設定すると最優先で使用されます (読み取り専用)

COS_SERVICE_ACCOUNT_KEY — Service Account Access Key。COS_PERSONAL_ACCESS_TOKEN の次に優先されます

COS_PROJECT — デフォルトプロジェクト名。--project フラグの省略に使えます

COS_PROFILE — 使用するプロファイル名 (--profile フラグより優先度は低い)

出力フォーマット

COS_JSON — 1 を設定すると --json と同等

COS_PLAIN — 1 を設定すると --plain と同等

COS_RESULTS_ONLY — 1 を設定すると --results-only と同等

COS_SELECT — セレクタを設定すると --select と同等 (例: pages[].title)

sandbox (権限制御)

COS_ENABLE_COMMANDS — 許可するコマンドをカンマ区切りで指定 (例: page.list,page.get)

COS_DISABLE_COMMANDS — 禁止するコマンドをカンマ区切りで指定 (例: page.delete)

認証解決の優先順位

1. COS_PERSONAL_ACCESS_TOKEN → PAT

2. COS_SERVICE_ACCOUNT_KEY → SA キー

3. COS_SID (--profile 未指定時のみ)

4. --profile フラグ → キーチェーン

5. COS_PROFILE 環境変数 → キーチェーン

6. config.defaultProfile → キーチェーン

7. "default" プロファイル → キーチェーン

使用例

code:bash

# CI 環境での最小設定 (SID)

export COS_SID="your-connect-sid"

export COS_PROJECT="myproject"

cos page list --json --results-only

# PAT を使った読み取り専用エージェント

export COS_PERSONAL_ACCESS_TOKEN="pat_xxxx..."

export COS_ENABLE_COMMANDS="page.list,page.get,page.text,page.context,search"

cos page list --project myproject

# SA Key を使った CI 環境

export COS_SERVICE_ACCOUNT_KEY="cs_xxxx..."

export COS_PROJECT="myproject"

cos page list --json --results-only