---
title: "Sota CLI"
description: "Sota CLI は正式な developer interface です。Project scaffold、manifest 検証、UI contract build、Development session、Staging artifact、Production promote を扱います。"
url: "https://sotaagents.ai/ja/manual/developer-guide/sota-cli"
generated_by: "sotaagents-ldp"
docs_index: "https://sotaagents.ai/manual/llms.txt"
locale: "ja"
---

# Sota CLI

**Sota CLI** は正式な developer interface です。Project scaffold、manifest 検証、UI contract build、Development session、Staging artifact、Production promote を扱います。

ターミナル

```
curl -fsSL https://app.sotaagents.ai/cli/install.sh | sh
sota --version
sota login
sota whoami
sota update
```

Windows PowerShell:

PowerShell

```
irm https://app.sotaagents.ai/cli/install.ps1 | iex
```

### Command 一覧

インストール済み version の正確な一覧は `sota --help` で確認できます。すべての command が global option `--cwd <dir>`、`--origin <url>`、`--manifest <path>`、`--json`、`--verbose` を受け付けます。

| 分類 | Command | 内容 |
| --- | --- | --- |
| Session | `login`、`logout`、`whoami` | このマシンに、一つの origin に紐づく scope 付き app-developer session を許可します。`login --manual` は headless／リモート環境向けの copy/paste 認可です。 |
| Scaffold | `init [dir]`、`add [features…]` | Project を作成、または既存 project に capability を追加します。どちらも additive で、既存ファイルを保持し衝突を報告します。 |
| Config | `config set-origin <url>`、`config show`、`config set <key> <value>` | `.sota/config.json` を管理します。`set-origin --env <name>` は environment ごとの origin を保存し、`deploy -e`／`validate -e` がそれを選択します。 |
| Manifest | `manifest schema`、`manifest examples`、`manifest explain <topic>`、`manifest diff <left> <right>` | Server が検証に使う JSON Schema の出力、実例の表示、単一 field の解説、二つの manifest の差分。 |
| 検査 | `validate`、`build`、`contracts ensure`、`env template`、`env check` | Server 側 manifest preflight（offline 時は local lint）、build 済み output の packaging、App UI type contract の materialize、manifest の `env` 宣言からの `.env.example` 生成・確認。 |
| 開発 | `dev`、`dev status`、`dev stop` | Local backend とローカル build 済み asset に紐づく個人 Development session の公開・確認・停止。 |
| 出荷 | `deploy`、`release` | Immutable artifact を一つ build して Staging で動かし、Staging が動かしているその artifact をそのまま Production へ promote します。 |
| 参照 | `status`、`logs`、`workspaces`、`catalog`、`installed --org <id>`、`app info <slug>`、`app config` | Platform が保持する現状の読み取り：現在の environment、backend log、開発可能な workspace、app catalog、project 単位の app config。 |
| 保守 | `update`、`update skills`、`docs [topic]` | Binary の更新、app project の bundled development skill 更新、version 対応 documentation の表示。 |

現在の option には、exact schema major を取得する `manifest schema --version <major>`、Staging artifact を同じ command で Production に promote する `deploy --release`、log を exact app environment に絞る `logs --environment`／`--environment-id` も含まれます。

> [!NOTE]
> 別 deployment を対象にする
>
> Global `--origin` を使用します。例：`sota --origin https://v4.stg.sotaagents.ai login`。以後の lifecycle command でも同じ origin を使うか、`sota config set-origin` で一度保存してください。

> [!WARNING]
> CLI がアプリを build することはありません。
>
> `sota build` は既存の output を packaging するだけで、frontend／backend の build を置き換えません。`sota dev` も process の起動・停止を行いません。まず source を build し、その後 CLI に packaging・publish・tunnel を任せてください。