CLI

コンソールでできることを、ターミナルや CI から行います。

Agent を作って試すにはコンソールが便利です。うまく動くようになったら、subako CLI を使って同じことをターミナルから行えます。設定をファイルで管理すればプルリクエストでレビューでき、CI からどの環境にも同じ手順で公開できます。

インストール

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/subako-ai/subako-cli/releases/latest/download/subako-cli-installer.sh | sh

インストーラーは subako を、$XDG_BIN_HOME が設定されていればそこに、設定されていなければ ~/.local/bin に置きます。macOS と Linux で動作します。

サインイン

subako login --org acme
subako whoami

サインインすると、ブラウザーで Organization のサインインページ (コンソールと同じサインイン) が開き、Credential が ~/.config/subako/credentials.json に保存されます。--profile を指定すると別の名前で保存されるので、複数の Organization や、staging と production のログインを併用できます。切り替えには subako profile list と subako profile use を使います。

Workspace を一度選択しておくと、以降のコマンドはその Workspace で実行されます:

subako workspace list
subako workspace use production

subako cloud signup --org <handle> --name <name> を使うと、コンソールのサインアップと同じようにターミナルから Organization を作成できます。

Agent

Agent のバージョンは 1 つの JSON ドキュメントで表します。フィールドはバージョンの編集画面に表示されるものと同じで、詳しくは Agent config リファレンスで説明しています。config-example を実行すると、公開できる最小限の設定が出力されます:

subako agent config-example --format openai_responses > agent.json
subako model-provider list           # プロバイダーの id とそのモデル
subako agent create --name support-triage
subako agent publish <agent-id> --config agent.json --model-provider <provider-id>
subako agent versions <agent-id>

プロバイダーはファイルの中ではなく公開時に指定するので、同じファイルを staging にも production にも公開できます。

Skill

subako skill create ./refund-policy      # ルートに SKILL.md があるフォルダー。バージョン 1
subako skill push <skill-id> ./refund-policy
subako skill list

Function

subako function create dist/orders.tar.gz         # バージョン 1
subako function push <function-id> dist/orders.tar.gz
subako function list

どちらのコマンドにも、Archive の代わりに Bundle のディレクトリを渡せます。詳しくは Package とバージョンを参照してください。

Vault と API key

シークレットはフラグではなく必ず stdin から読み込むので、シェルの履歴やプロセス一覧に残りません:

subako vault create --display-name "Acme production"
subako vault add-credential <vault-id> --protocol mcp \
  --target https://mcp.acme.example/orders --display-name "Orders" < credential.json

subako api-key mint --label "support backend" \
  --permission session.create --permission session.read --permission session.manage

CI での利用

CLI は保存されたログインを使って、人として認証します。CI では、シークレットとして保管した Credential ファイルを --credentials-file (または SUBAKO_CREDENTIALS_FILE) で指定するか、ジョブに必要な権限を持つ API key で API を直接呼び出してください。subako token はサインイン中の Credential を JSON で出力します。自分の権限で API を呼び出す独自のプログラムに使えます。

すべてのコマンド、フラグ、引数は CLI リファレンスに載っています。