---
title: "Sota CLI"
description: "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."
url: "https://sotaagents.ai/vi/manual/developer-guide/sota-cli"
generated_by: "sotaagents-ldp"
docs_index: "https://sotaagents.ai/manual/llms.txt"
locale: "vi"
---

# 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. |

> [!NOTE]
> 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`.

> [!WARNING]
> 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.