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.nextx.vn/docs/cli.
📌 Vị trí: Terminal → nextx help → đúng nhóm lệnh.
1. Hội thoại và bộ nhớ
| Lệnh | Việc nó làm | Lưu ý |
|---|
nextx ai ask | Hỏi một câu, giống -p. | Thêm --conversation <id> để hỏi tiếp. |
nextx ai history | Danh sách hội thoại. | --search và --limit. Mặc định 30 dòng. |
nextx ai pending | Bản nháp ghi và câu hỏi đang chờ. | Xem từng dòng bằng show-changeset. |
nextx ai apply / reject | Ghi thật một bản nháp, hoặc huỷ. | Chỉ áp dụng đề xuất còn hạn. |
nextx ai undo | Hoàn tác một lần AI đã ghi. | Quá hạn thì không hoàn tác được. |
nextx ai memory | Điều AI nhớ về công ty. | edit, lock, forget. Khoá để AI không tự sửa. |
nextx ai schedule add | Chạy một câu hỏi theo kỳ. | --daily 08:00, --weekly 1@08:00 (1 là thứ Hai), --monthly 1@08:00. |
nextx ai agents / usage | Agent được dùng, và lượt AI tháng này. | Hết lượt thì lệnh trả mã thoát 5. |
2. Model, công cụ AI và API
| Lệnh | Việc nó làm | Lưu ý |
|---|
nextx model add | Thêm claude, gemini, gpt, grok hoặc ollama. | Đưa API key qua --key-from-stdin. Khoá không gửi về NextX. |
nextx model default | Model khi mở chat. nextx là NextX AI. | model remove xoá cả khoá trong keychain. |
nextx tools login | Cấp quyền công cụ AI cho CLI trên máy này, làm một lần. | doctor báo “chưa cấp” khi bước này chưa chạy. |
nextx tools list | Công cụ theo quyền thật. | Lọc --module crm và --kind read. read, proposal, export. |
nextx tools call | Gọi một công cụ. | Công cụ ghi chỉ tạo đề xuất. Tham số bằng --args, --args-file hoặc -a khoá=giá trị. |
nextx api | Gọi thẳng API. Ví dụ nextx api GET /crm/contacts -f q=Minh. | --paginate đi hết trang. --select .items[0].name chỉ in một phần. |
nextx openapi pull | Tải đặc tả OpenAPI. | Mặc định ghi openapi.json. Thêm --module để lấy một phân hệ. |
3. MCP và CI
| Lệnh | Việc nó làm | Lưu ý |
|---|
nextx mcp install | Cài máy chủ MCP vào chatgpt, claude, claude-desktop, codex, copilot, cursor, gemini, grok, vscode hoặc windsurf. | nextx mcp url in địa chỉ. mcp uninstall gỡ một client. |
nextx mcp serve | Chạy MCP qua stdin/stdout bằng quyền của CLI. | Dùng cho client không hỗ trợ OAuth. |
nextx ci trust add | Cho một kho GitHub hoặc GitLab đăng nhập workspace. Token đứng tên bạn, sống 15 phút. | Nên buộc --environment với nhánh chính. |
nextx ci policy request | Xin cho CI được ghi, trong một trần số bản ghi. | Người quản lý API key duyệt. Trần mặc định 50, tối đa 1000. Hạn mặc định 14 ngày, tối đa 30 ngày. |
nextx ci example | In mẫu workflow GitHub Actions. | Thêm --write chỉ khi đã có chính sách ghi. |
⚠️ Chưa có chính sách CI thì lệnh ghi trong pipeline không tự chạy. CLI chỉ in liên kết để người có quyền xác nhận. nextx ci policy revoke có hiệu lực từ lượt ghi kế tiếp.
4. JSON cho script
nextx -p "doanh thu hôm qua theo chi nhánh" --json > report.json
nextx -p "..." --output-format stream-json
API key chỉ đọc:
NEXTX_API_KEY=... nextx tools call <tool> -a q=... --json