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 も含まれます。

別 deployment を対象にする

Global --origin を使用します。例：sota --origin https://v4.stg.sotaagents.ai login。以後の lifecycle command でも同じ origin を使うか、sota config set-origin で一度保存してください。

CLI がアプリを build することはありません。

sota build は既存の output を packaging するだけで、frontend／backend の build を置き換えません。sota dev も process の起動・停止を行いません。まず source を build し、その後 CLI に packaging・publish・tunnel を任せてください。