TOSE CLI

Cài đặt

Cần Node.js và npm. Đối chiếu phiên bản đã cài với danh sách bản phát hành trên npm.

npm install -g @tosesh/tose
tose --version

Lịch sử phát hành trên npm

Đăng nhập mà không lộ khoá

Tạo API key tại Settings → API Keys của workspace (owner và admin). CLI đọc khoá từ TOSE_API_KEY nên khoá không bao giờ phải xuất hiện trong prompt, dòng lệnh, URL, log hay commit. Mỗi khoá thuộc một workspace và bị thu hồi hoặc hết hạn theo cài đặt ở đó.

export TOSE_API_KEY=...   # set it in your shell or secret store, never in a prompt, URL or commit
tose whoami --json

Tạo API key trên dashboard

Lập kế hoạch, thực thi, kiểm tra, khắc phục

Cùng một vòng lặp cho người và cho agent. Mọi lệnh nhận --json và trả một tài liệu JSON.

tose doctor my-workspace/my-app --json
tose deploy my-workspace/my-app --dry-run --json
tose deploy my-workspace/my-app --wait --non-interactive --json
tose status my-workspace/my-app --json
tose logs my-workspace/my-app -n 100

1. Lập kế hoạch: doctor kiểm tra auth, git, server, port, quota, health và DNS/SSL; deploy --dry-run in kế hoạch và không thay đổi gì.
2. Thực thi: deploy --wait chờ đến khi deployment chạy và mọi pod sẵn sàng. --non-interactive báo lỗi thay vì hỏi.
3. Kiểm tra: status và logs cho thấy tình trạng pod và đầu ra. Đọc JSON trước khi báo thành công.
4. Khắc phục: Đọc log build và lỗi, sửa nguyên nhân rồi chạy lại. Ví hết tiền thì deploy mới bị từ chối (HTTP 402): nhờ người nạp tiền, đừng thử lại.

Dừng lại và hỏi người trước

Lệnh xoá hoặc dừng cần xác nhận, và không có terminal thì bắt buộc --yes. Agent phải hỏi trước khi chạy: tose down, tose env rm, tose domain rm, tose disk delete.

Scope

Khoá không có scope có toàn quyền trong workspace của nó. API tạo được khoá có scope (Beta); form dashboard và CLI chưa đặt được scope, và yêu cầu vượt scope trả insufficient_scope.

Skills cho agent

Từ 0.2.0 CLI liệt kê và cài skill từ catalogue công khai, kiểm tra digest sha256 của từng file trước khi cài. Catalogue là tập tài liệu, không phải MCP server.

tose skills list
tose skills install deploy-nextjs-to-tose

Skills catalogue (JSON)

Để agent tự khám phá lệnh

tose capabilities --json mô tả lệnh, cờ, mức rủi ro và phiên bản của bản đã cài, nên agent không phải đoán.

tose capabilities --json

Tiếp theo

• Kết nối agent từng bước
• MCP, OpenAPI và Skills: khác nhau thế nào
• Bảng giá và việc gì xảy ra khi ví hết tiền
• Roadmap và tình trạng phát hành
• Mọi lệnh và cờ trong tài liệu