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

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

## インストール

```bash
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 で動作します。

## サインイン

```bash
subako login --org acme
subako whoami
```

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

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

```bash
subako workspace list
subako workspace use production
```

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

## Agent

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

```bash
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

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

## Function

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

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

## Vault と API key

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

```bash
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](/ja/console/api-keys) で API を直接呼び出してください。`subako token` はサインイン中の Credential を JSON で出力します。自分の権限で API を呼び出す独自のプログラムに使えます。

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