CLI — làm website ngay trên máy của bạn

Kéo website về máy, sửa bằng editor và coding agent của bạn, kiểm tra theo đúng chuẩn của server rồi đẩy lên an toàn.

webmati là một chương trình dòng lệnh (CLI) chép một website về máy bạn thành một thư mục project bình thường: theme Liquid, workflow backend (kèm mã Go của từng node), trang, content type, redirect, bản dịch. Bạn sửa bằng editor quen tay (VS Code, Cursor…) hoặc nhờ coding agent (Claude Code, Cursor, Codex), rồi đẩy lên lại. CLI dùng chính bộ kiểm tra của server ngay trên máy, và không bao giờ ghi đè thay đổi của người khác mà bạn chưa thấy.

curl -fsSL https://webmati.com/cli/install.sh | sh     # cài (macOS / Linux)
webmati login --web --platform webmati                  # duyệt key trong trình duyệt
webmati clone my-shop                                   # tải website về thư mục my-shop/
cd my-shop
webmati validate                                        # kiểm tra như server
webmati push --dry-run                                  # xem sẽ gửi gì
webmati push                                            # ghi vào bản nháp (draft)
webmati preview                                         # link xem bản nháp
webmati publish theme                                   # đưa lên cho khách xem

Khi nào nên dùng CLI?

Bạn muốn…	Nên dùng
Sửa vài chữ, đổi ảnh, bấm thử giao diện	Trang admin (customizer, page builder)
Nhờ AI trong khung chat làm một việc cụ thể	MCP (xem MCP overview)
Sửa nhiều file theme, viết code node Go, dùng git, review thay đổi trước khi đẩy	CLI
Để coding agent (Claude Code, Cursor, Codex) làm trên máy bạn	CLI (agent đọc `AGENTS.md` trong project)
Chạy thử workflow mà không đụng dữ liệu thật	CLI (`webmati test`)

Ba cách dùng chung một dữ liệu: sửa ở admin rồi webmati pull là thấy, đẩy từ CLI rồi mở admin là thấy.

An toàn theo mặc định

push chỉ ghi vào bản nháp. Theme, workflow, trang đều có bản nháp; khách chỉ thấy khi bạn publish. Những thứ không có bản nháp (bảng, route, redirect, bản dịch…) phải đi qua push --live, có kế hoạch để duyệt trước — xem Thay đổi chạy ngay.
Không ghi đè mù. Mỗi mục có một dấu vân tay (etag) do server tính. Nếu ai đó sửa trên server sau lần pull cuối của bạn, push dừng lại và báo xung đột — xem Xung đột.
Key gắn với một website, có hạn. Key do bạn duyệt trong trình duyệt, chỉ dùng được cho đúng một website, hết hạn sau 30 ngày (mặc định). Project không bao giờ chứa key, giá trị secret hay media.

Tiết kiệm token cho AI

Một coding agent dùng CLI tốn ít token hơn nhiều so với gọi qua MCP đầy đủ:

CLI-first (agent gõ webmati …, đọc --json và lọc bằng --select) rẻ hơn khoảng 5–20 lần so với cùng việc đó qua MCP đầy đủ: agent chỉ đọc đúng phần nó cần.
MCP gọn webmati mcp chỉ có 8 tool thay vì cả danh mục (182 tool): danh sách tool nhỏ hơn 97,4%. Tự đo được bằng webmati mcp --measure.
Code mode webmati exec script.ts: một script gọi nhiều tool, chỉ kết quả cuối cùng quay về agent.

Xem Dùng với AI agent.

Các trang trong mục này