Viết theo CLI bản 0.3.7, ảnh chụp trên Windows PowerShell bản 0.3.5, dữ liệu thật đã được che. Xem đủ cờ lệnh tại developers.gymmaster.vn/docs/cli.
📌 Vị trí: Windows PowerShell → gymmaster config. File ~/.config/gymmaster/config.toml.
1. Đặt cấu hình
gymmaster config list
gymmaster config set lang vi
gymmaster config set mode propose| Khoá | Giá trị trang CLI ghi | Tác dụng |
|---|---|---|
lang | vi hoặc en | Ngôn ngữ của CLI. |
mode | read, propose, auto | Chế độ quyền khi mở chat. |
updateChannel | latest hoặc next | Kênh của gymmaster update. |
updateCheck | Bật hoặc tắt | Nhắc bản mới. |
telemetry | Bật hoặc tắt | Gửi số liệu sử dụng. |
color | Bật hoặc tắt | Màu trong PowerShell. |
defaultProfile | Tên hồ sơ | Hồ sơ đăng nhập mở sẵn. |
gymmaster init tạo file GYMMASTER.md trong thư mục hiện tại. Mỗi câu hỏi gửi kèm file này. Trong chat, lệnh tương ứng là /init. Viết quy ước riêng của thư mục vào đó. Không viết token vào file này.
2. Biến môi trường trên PowerShell
Đặt cho cửa sổ hiện tại bằng $env:TÊN = "giá trị". Trang CLI dùng tiền tố GYMMASTER_.
| Biến | Tác dụng | Dùng khi |
|---|---|---|
GYMMASTER_API_KEY | API key, chỉ đọc với script. | CI không chat AI. |
GYMMASTER_TOKEN | Access token có sẵn. | Máy đã có token hợp lệ. |
GYMMASTER_PROFILE | Chọn hồ sơ đăng nhập. | Một máy, nhiều tài khoản. |
GYMMASTER_WORKSPACE | Workspace của lệnh này. | Không muốn đổi hồ sơ vĩnh viễn. |
GYMMASTER_LANG | vi hoặc en. | Một lần chạy. |
GYMMASTER_DEBUG | In request-id và thời gian. | Báo lỗi cho hỗ trợ. Không in token. |
GYMMASTER_NO_UPDATE_CHECK | Tắt nhắc bản mới. | Máy chủ không cần nhắc. |
GYMMASTER_NO_KEYCHAIN | Lưu token bằng tệp quyền 0600. | Máy không dùng Keychain. |
GYMMASTER_ID_TOKEN | Token OIDC của GitLab CI. | Đi cùng gymmaster login --ci. |
GYMMASTER_VERSION | Ghim bản khi chạy script cài. | Đặt trước irm hoặc curl. |
GYMMASTER_INSTALL_DIR | Thư mục cài. | Mặc định Windows là %LOCALAPPDATA%\gymmaster\bin. |
3. Mã thoát
| Mã | Ý nghĩa | Việc nên làm |
|---|---|---|
| 0 | Thành công. | |
| 1 | Lỗi chung hoặc máy chủ lỗi. | Chạy gymmaster doctor. |
| 2 | Sai cú pháp lệnh. | gymmaster <lệnh> --help. |
| 3 | Chưa đăng nhập hoặc session hết hạn. | gymmaster login. |
| 4 | Không đủ quyền hoặc gói. | Xem gymmaster status và quyền trên workspace. |
| 5 | Hết lượt AI hoặc gọi quá nhanh. | gymmaster ai usage. |
| 6 | Lỗi mạng. | Kiểm mạng, chạy lại. |
| 7 | Write proposal chưa được xác nhận. | Xác nhận trong app, hoặc gymmaster ai pending. |
| 8 | Không tìm thấy. | Kiểm id vừa truyền. |
| 130 | Bị huỷ bằng Ctrl+C. |
Trong PowerShell, đọc mã vừa xong bằng $LASTEXITCODE.
4. Đổi ngôn ngữ
📌 Vị trí: Windows PowerShell → gymmaster config set lang.
gymmaster config set lang en
gymmaster config get lang💡 Một lần chạy, không ghi vào cấu hình: đặt$env:GYMMASTER_LANG="vi"hoặc thêm--lang vi. Trang đăng nhập web có nút VI / EN riêng, chỉ đổi ngôn ngữ trang đó.