Cài đặt và tự cập nhật
Cài CLI trên macOS, Linux hoặc Windows bằng một dòng lệnh; CLI tự cập nhật mỗi ngày.
macOS và Linux
Mở Terminal và dán:
curl -fsSL https://webmati.com/cli/install.sh | sh
Script tự nhận hệ điều hành và loại chip (Intel hay Apple Silicon, x86-64 hay
ARM64), tải đúng bản, kiểm tra SHA-256 với danh sách SHA256SUMS của bản
phát hành rồi mới cài vào ~/.local/bin/webmati. Không cần quyền root; nếu
checksum không khớp, không có gì được cài.
Tuỳ chọn (đặt trước lệnh):
# cài một phiên bản cụ thể
curl -fsSL https://webmati.com/cli/install.sh | WEBMATI_VERSION=0.1.2 sh
# cài vào thư mục khác
curl -fsSL https://webmati.com/cli/install.sh | WEBMATI_INSTALL_DIR="$HOME/bin" sh
Windows
Mở PowerShell (không cần quyền Administrator) và dán:
irm https://webmati.com/cli/install.ps1 | iex
CLI được cài vào %LOCALAPPDATA%\Programs\webmati\webmati.exe, và thư mục đó
được thêm vào PATH của tài khoản bạn. Máy Windows ARM chạy bản x86-64 qua giả
lập.
PATH — "command not found"
Sau khi cài, mở một cửa sổ terminal mới rồi chạy:
webmati version
Nếu báo command not found (macOS/Linux), thư mục cài chưa có trong PATH.
Script cài đã in sẵn dòng cần thêm; với zsh (mặc định trên macOS):
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
Với bash trên Linux thì dùng ~/.bashrc, trên macOS là ~/.bash_profile. Đóng
terminal, mở lại là xong. Trên Windows, mở lại PowerShell.
Tự cập nhật
CLI tự giữ mình mới:
- Mỗi ngày một lần, khi bạn chạy một lệnh, nó xem có bản mới không (chạy nền, tối đa 2 giây, không bao giờ làm lệnh của bạn chậm đi).
- Có bản mới thì nó tải về sau khi lệnh của bạn xong, kiểm tra checksum, chạy thử, rồi mới thay bản đang dùng.
- Nó không tự thay khi đang chạy trong CI, khi output là
--jsonhay đi qua pipe, hoặc trong các chế độ chạy lâu (mcp,exec,dev). Khi đó nó chỉ báo có bản mới.
Điều khiển bằng tay:
webmati update # cập nhật ngay
webmati update --check # chỉ xem có bản mới không
webmati update --version 0.1.1 # cài đúng một bản (kể cả bản cũ hơn để quay lại)
webmati update --off # không tự cập nhật nữa (vẫn báo khi có bản mới)
webmati update --on # bật lại tự cập nhật
Đặt biến môi trường WEBMATI_NO_AUTO_UPDATE=1 cũng tắt được việc tự thay.
Mã thoát 4: CLI quá cũ
Nếu platform không còn hỗ trợ bản CLI của bạn, mọi lệnh (trừ
update,version,help,logout) dừng với mã thoát 4 và thông báo "too old". Chạywebmati updatelà xong.
Gỡ cài đặt
Xoá file webmati (macOS/Linux: ~/.local/bin/webmati; Windows:
%LOCALAPPDATA%\Programs\webmati). Key và cài đặt nằm ở ~/.config/webmati/
(Windows: %USERPROFILE%\.config\webmati); xoá thư mục đó nếu muốn quên hết.

