共通フラグ - coscli

共通フラグ

すべての cos コマンドで使用できる共通フラグの一覧です。

接続・認証

--project <name> / -p — 対象プロジェクト名 (env: COS_PROJECT)

--profile <name> — 認証プロファイル名 (デフォルト: default、env: COS_PROFILE)

出力フォーマット

--json / -J — JSON envelope 出力 { "data": ..., "meta": ... } (env: COS_JSON=1)

--plain / -P — プレーン/TSV 出力・人間向け (env: COS_PLAIN=1)

--results-only — data フィールドのみ出力・envelope を除去 (env: COS_RESULTS_ONLY=1)

--select <path> — data 内フィールドを抽出 (例: pages[].title、env: COS_SELECT)

書き込み制御

--dry-run — 書き込みをシミュレート・実際には変更しない

--no-input — 対話入力を無効化 (CI・エージェント環境で必須)

--force / -y — 確認プロンプトをスキップ

sandbox (権限制御)

--enable-commands <list> — 許可するコマンドをカンマ区切りで限定 (env: COS_ENABLE_COMMANDS)

--disable-commands <list> — 禁止するコマンドをカンマ区切りで指定 (env: COS_DISABLE_COMMANDS)

ログ・デバッグ

--verbose / -v — 詳細ログを出力

--quiet / -q — 成功時の人間向けメッセージを抑制

使用例

code:bash

# トークン節約パターン (AI エージェント推奨)

cos page list --project myproject --json --results-only --select 'pages[].title'

# dry-run で書き込みを事前確認

cos page edit "タイトル" --from-file content.txt --dry-run --project myproject

# CI・エージェント環境での削除 (対話プロンプトを回避)

cos page delete "タイトル" --force --no-input --project myproject