Sota CLI

Sota CLI là developer interface chính thức: tạo project, validate manifest, build UI contracts, mở Development session, tạo immutable Staging artifact và promote lên Production.

Terminal

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

Bộ command#

Chạy sota --help để có danh sách chuẩn theo đúng version bạn đang cài. Mọi command đều nhận các global option --cwd <dir>, --origin <url>, --manifest <path>, --json và --verbose.

Nhóm	Command	Tác dụng
Session	`login`, `logout`, `whoami`	Cấp cho máy này một app-developer session có scope, gắn với một origin. `login --manual` dùng cách copy/paste cho máy headless hoặc máy từ xa.
Scaffold	`init [dir]`, `add [features…]`	Tạo project, hoặc thêm capability vào project sẵn có. Cả hai đều additive: giữ nguyên file của bạn và báo collision thay vì ghi đè.
Config	`config set-origin <url>`, `config show`, `config set <key> <value>`	Quản lý `.sota/config.json`. `set-origin --env <name>` lưu origin cho một environment để `deploy -e` và `validate -e` chọn lại.
Manifest	`manifest schema [--version <major>]`, `manifest examples`, `manifest explain <topic>`, `manifest diff <left> <right>`	In đúng schema major được hỗ trợ mà server dùng để validate, xem ví dụ thực tế, giải thích một field và so sánh hai manifest.
Kiểm tra	`validate`, `build`, `contracts ensure`, `env template`, `env check`	Preflight manifest phía server (lint local khi offline), đóng gói output đã build sẵn, materialize App UI type contract, và render hoặc kiểm tra `.env.example` từ khai báo `env` trong manifest.
Develop	`dev`, `dev status`, `dev stop`	Publish một Development session cá nhân gắn với backend local và assets build tại máy, xem trạng thái và dừng nó.
Ship	`deploy` (có thể kèm `--release`), `release`	Build một immutable artifact và chạy nó ở Staging; có thể promote đúng artifact đó trong cùng command, hoặc promote artifact Staging đang chạy.
Tra cứu	`status`, `logs`, `workspaces`, `catalog`, `installed --org <id>`, `app info <slug>`, `app config`	Đọc trạng thái nền tảng đang giữ: các environment hiện tại, log backend (gồm filter exact `--environment`/`--environment-id`), workspace bạn được develop, catalog app và app config theo project.
Bảo trì	`update`, `update skills`, `docs [topic]`	Thay binary, cập nhật development skill đi kèm trong project app và mở tài liệu developer đúng version.

Develop trên một deployment khác

Dùng global option --origin, ví dụ sota --origin https://v4.stg.sotaagents.ai login, và giữ cùng origin cho các lifecycle command sau đó, hoặc lưu một lần bằng sota config set-origin.

CLI không bao giờ build app thay bạn.

sota build chỉ đóng gói output đã có sẵn; nó không thay thế build frontend/backend của bạn, và sota dev không start hay stop process nào của bạn. Hãy build source trước, rồi để CLI đóng gói, publish hoặc tunnel.