CuongMini CLIMới

AI lập trình ngay trong terminal

Gõ cuongmini trong thư mục dự án rồi giao việc bằng tiếng Việt. AI đọc code, sửa file (có diff để duyệt), chạy lệnh, lập kế hoạch — đúng bộ máy AI Code của app CuongThai, không cần mở trình soạn hay app nào.

Cài trong 1 phútHướng dẫn sử dụng
curl -fsSL https://cuongthai.com/cli/install.sh | bash

macOS · Windows · Linux. Dùng được với tài khoản Pro hoặc key terminal còn hạn.

Ai dùng được

Cài CLI miễn phí. Phần AI chạy khi tài khoản đăng nhập có một trong hai thứ dưới — hạn mức tính chung một ví với app desktop và extension.

  • Tài khoản Pro

    Đăng nhập là dùng — không cần xin gì thêm.

    Xem gói Pro

  • Key terminal đã duyệt

    Xin key, admin duyệt, còn hạn là dùng được. Không phải dán key vào đâu — chỉ cần đăng nhập đúng tài khoản đã được cấp.

    Xin key terminal

  • Mua key ở shop

    Key về tài khoản ngay sau khi thanh toán, dùng tới hết hạn gói.

    Tới shop

Cài đặt từng bước

Viết cho máy mới tinh, chưa từng mở terminal. Trang đã chọn sẵn hệ điều hành của bạn — sai thì bấm đổi.

  1. 1

    Mở Terminal

    Bấm ⌘ Cmd + Space (Spotlight), gõ Terminal rồi Enter. Đã quen iTerm2 hay Warp thì dùng luôn.

  2. 2

    Dán lệnh cài rồi Enter

    Bấm Chép, dán vào Terminal bằng ⌘ Cmd+V, rồi Enter. Không cần sudo, không hỏi mật khẩu máy.

    curl -fsSL https://cuongthai.com/cli/install.sh | bash
  3. 3

    Chờ cài xong

    Thường dưới một phút. Máy chưa có Node.js ≥ 20 thì trình cài tự tải Node 22 chính thức (kiểm SHA-256) vào ~/.cuongmini/node — không đụng Node sẵn có của bạn. Lệnh cuongmini đặt ở ~/.local/bin và tự thêm vào PATH (~/.zshrc).

  4. 4

    Mở cửa sổ terminal MỚI

    Bấm ⌘ Cmd+N (hoặc đóng rồi mở lại Terminal). PATH mới chỉ có hiệu lực ở cửa sổ mở sau khi cài.

  5. 5

    Vào thư mục dự án

    Gõ cd và một dấu cách, rồi kéo thư mục dự án từ Finder thả vào Terminal — đường dẫn tự điền — rồi Enter.

    cd ~/du-an-cua-ban
  6. 6

    Gõ cuongmini

    Lần đầu sẽ hỏi đăng nhập (xem phần Hướng dẫn sử dụng). Gõ tắt: cm nếu máy chưa có lệnh nào tên đó. Trên macOS, open là lệnh hệ thống nên lệnh chính luôn là cuongmini.

    cuongmini

Có app desktop CuongThai? Trong app có nút cài CuongMini CLI — cài và đăng nhập sẵn bằng tài khoản đang mở trong app, khỏi gõ lệnh nào. Tải app

Lỗi hay gặp & cách sửa

Windows — không chạy được? “cuongmini is not recognized” / CommandNotFoundException

Gần như luôn là cửa sổ terminal mở trước khi cài (Windows Terminal giữ PATH cũ cho cả tab mới). Thử lần lượt:

1. Đóng HẲN Windows Terminal / PowerShell / cmd — mọi cửa sổ — rồi mở lại và gõ cuongmini.

2. Hoặc nạp lại PATH ngay trong cửa sổ đang mở (chọn đúng dòng theo cửa sổ):

PowerShell

$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')

cmd

set "PATH=%PATH%;%LOCALAPPDATA%\CuongMini\bin"

Git Bash

export PATH="$PATH:$(cygpath "$LOCALAPPDATA")/CuongMini/bin"

3. Hoặc chạy bằng đường dẫn đầy đủ (không cần PATH):

PowerShell

& "$env:LOCALAPPDATA\CuongMini\bin\cuongmini.cmd"

cmd

"%LOCALAPPDATA%\CuongMini\bin\cuongmini.cmd"

Chạy được rồi thì gõ cuongmini doctor — nó báo PATH, shell, terminal đang dùng và lệnh sửa đúng cho máy bạn. Vẫn không thấy file cuongmini.cmd? Lệnh cài chưa chạy xong — chạy lại và xem dòng ✗ đỏ.

Windows: “irm is not recognized”

Bạn đang dán lệnh PowerShell vào Command Prompt (cmd). Trong cmd dùng dòng này — nó gọi PowerShell giúp bạn, không cần đổi ExecutionPolicy:

powershell -NoProfile -ExecutionPolicy Bypass -c "irm https://cuongthai.com/cli/install.ps1 | iex"
Windows: “Could not create SSL/TLS secure channel” hoặc “running scripts is disabled”

Windows cũ chưa bật TLS 1.2 cho PowerShell. Dán lệnh này trong PowerShell (bật TLS 1.2 rồi mới tải):

[Net.ServicePointManager]::SecurityProtocol = 'Tls12'; irm https://cuongthai.com/cli/install.ps1 | iex

“running scripts is disabled” là khi chạy một file .ps1 đã tải về — đừng tải file, dán đúng lệnh irm … | iex (không bị ExecutionPolicy chặn). Máy công ty khoá chặt PowerShell thì nhờ IT, hoặc cài trong WSL theo tab Linux.

Git Bash: “cuongmini: command not found” hoặc “Raw mode is not supported”
Chạy lại lệnh cài cho Git Bash (curl -fsSL https://cuongthai.com/cli/install.sh | bash) — bản cài mới tạo thêm lệnh cuongmini không đuôi cho bash (bash không gọi được .cmd bằng tên trần) và tự chạy qua winpty trong cửa sổ Git Bash (mintty), nơi Node không thấy terminal. Vẫn lỗi: mở Git Bash bên trong Windows Terminal, hoặc dùng PowerShell.
Windows: phần mềm diệt virus chặn hoặc xoá file
Một số phần mềm diệt virus chặn script tải bằng irm hoặc xoá node.exe mới tải. Cho phép thư mục %USERPROFILE%\.cuongmini và %LOCALAPPDATA%\CuongMini rồi chạy lại lệnh cài — trình cài kiểm SHA-256 mọi file nó tải.
macOS / Linux: “command not found: cuongmini”
Đang dùng cửa sổ terminal mở trước khi cài. Mở cửa sổ mới, hoặc chạy source ~/.zshrc (macOS) / source ~/.bashrc (Linux). Chạy thẳng không cần PATH: ~/.local/bin/cuongmini.
Mạng công ty / trường chặn, tải mãi không xong
Trình cài cần vào được cuongthai.com và (nếu phải tải Node) nodejs.org; lúc dùng chỉ cần cuongthai.com. Thử mạng khác (phát 4G từ điện thoại) hoặc nhờ IT mở hai tên miền đó. Đứt giữa chừng thì cứ chạy lại lệnh cài — script chỉ chạy khi đã tải đủ, không để lại bản cài dở.
Linux: “curl: command not found”
Cài curl trước: sudo apt install -y curl (Debian/Ubuntu) hoặc sudo dnf install -y curl (Fedora), rồi chạy lại lệnh cài. Có wget thì trình cài tự dùng wget để tải gói.
Bấm đăng nhập Google/GitHub/Apple mà không thấy trình duyệt mở
CLI in sẵn một đường link — chép link đó mở bằng trình duyệt trên cùng máy. Đang SSH vào máy chủ (không có trình duyệt) thì chọn Tên đăng nhập + mật khẩu.
Đăng nhập được nhưng báo cần Pro
Tài khoản đó chưa có quyền dùng AI Code trong terminal. Cần gói Pro hoặc key terminal còn hạn (xin key hay mua ở shop). Đã có rồi thì kiểm lại xem có đăng nhập đúng tài khoản không: cuongmini logout rồi chạy lại.

Hướng dẫn sử dụng

Từ lần mở đầu tiên tới những phím tắt dùng hằng ngày.

1. Đăng nhập lần đầu

Gõ cuongmini, chọn bằng phím ↑↓ (hoặc số 1–4) rồi Enter:

  • Google / GitHub / Apple — trình duyệt mở ra, đăng nhập xong tự quay về terminal.
  • Tên đăng nhập + mật khẩu — ô mật khẩu không hiện ký tự, cứ gõ rồi Enter.

Phiên lưu ở ~/.cuongmini/phien.json (chỉ bạn đọc được), tự làm mới — lần sau mở là vào thẳng. Đổi tài khoản: /login; đăng xuất: cuongmini logout.

2. Giao việc bằng tiếng Việt

Gõ như nói với một đồng nghiệp rồi Enter. Vài câu mở đầu hay:

giải thích cấu trúc dự án này
sửa lỗi build rồi chạy lại cho tới khi xanh

Việc lớn thì AI tự lập kế hoạch và tích dần từng bước. Muốn duyệt trước khi AI đụng vào file: /plan <việc>. Đang chạy mà muốn dừng: esc.

3. Nhắc file bằng @ và gửi ảnh

Gõ @ là hiện gợi ý file/thư mục trong dự án (tìm mờ, đọc theo git ls-files) —Tab để chèn @đường/dẫn. AI sẽ đọc đúng file đó.

Gửi ảnh: gõ @anh.png hoặc kéo file ảnh thả vào terminal (terminal dán đường dẫn) — ảnh HEIC của iPhone cũng được, CLI tự chuyển đổi.

4. Thẻ duyệt

Ở chế độ có hỏi, mỗi lần AI muốn sửa file hay chạy lệnh sẽ hiện một thẻ ngay trong luồng: diff tô màu, hoặc lệnh kèm lý do rủi ro.

  • 1 cho phép · 2 cho phép cả việc này · 3 từ chối
  • Hoặc ↑↓ rồi Enter; esc = từ chối.

Đã lỡ “luôn cho phép” một lệnh? /quyen để xem và thu hồi.

5. Bảng kế hoạch

Bảng 📋 Kế hoạch nằm ở cột phải khi terminal rộng từ 110 cột (hẹp hơn thì nằm trên ô nhập): việc ☐ ◐ ☑, “Đang làm” (kèm lệnh đang chạy), file đã sửa (+/−), số bước, thời gian.

ctrl+p ẩn/hiện bảng. Đầu ra lệnh dài bị thu gọn còn vài dòng — ctrl+o để xem đủ.

6. Làm tiếp việc cũ

Việc được lưu theo thư mục. cuongmini -c mở lại việc gần nhất của thư mục đang đứng; trong phiên thì /resume hiện bảng chọn việc cũ.

Lỡ tay: /undo hoàn tác mọi file AI đã sửa trong việc này, /rewind quay về một câu hỏi trước (cắt hội thoại + lùi file về mốc đó).

Phím tắt

Enter
Gửi
Alt+Enter · \ cuối dòng
Xuống dòng
↑ / ↓
Lịch sử câu đã gửi
/
Gợi ý lệnh (Tab chèn, Enter chạy)
@
Gợi ý file/thư mục dự án (tìm mờ)
shift+tab
Đổi chế độ quyền
esc
Dừng việc đang chạy · esc esc xoá ô nhập
ctrl+o
Bật/tắt xem đầy đủ đầu ra lệnh
ctrl+p
Ẩn/hiện bảng kế hoạch
ctrl+l
Xoá màn hình
ctrl+c
Dừng việc · xoá ô nhập · nhấn 2 lần để thoát

Lệnh gạch chéo

Gõ / là hiện gợi ý, gõ tiếp để lọc. Cùng bộ lệnh với app desktop và extension VS Code; lệnh tự tạo của dự án (.claude/commands/*.md) cũng hiện trong gợi ý.

Cơ bản

/help
Danh sách lệnh
/clear
Xoá hội thoại, bắt đầu việc mới
/login · /logout
Đăng nhập lại / đổi tài khoản · đăng xuất
/exit
Thoát CuongMini

Phiên & model

/model
Chọn model (menu): Cuong Sonnet 5, CuongMini Max, GPT 6 Sol
/effort
Mức nỗ lực: thấp → tối đa (số bước, agent phụ)
/compact
Tóm tắt phần cũ để nhẹ ngữ cảnh
/context
Ngữ cảnh đã dùng
/usage · /cost
Hạn mức 5 giờ, lúc hồi · tiền đã tiêu trong việc này
/status
Phiên bản, cổng đang dùng, dự án, nhánh git

Làm việc

/plan <việc>
Chỉ lập kế hoạch (không sửa, không chạy lệnh) — duyệt xong mới làm
/review
Soát diff hiện tại, liệt kê lỗi kèm file:dòng — không sửa
/diff
Xem git diff của dự án
/init
Quét dự án, tạo/cập nhật AGENTS.md mà AI tự đọc mỗi lượt
/undo
Hoàn tác mọi file AI đã sửa trong việc này
/rewind [n]
Quay về một câu hỏi trước: cắt hội thoại + lùi file
/resume
Bảng chọn việc cũ để làm tiếp
/export [tên.md]
Xuất hội thoại ra file Markdown

Công cụ

/memory
Xem/xoá bộ nhớ (bài học) của AI
/mcp
Trạng thái máy chủ MCP
/kynang
Tìm và cài skill từ kho AI Templates vào dự án
/quyen
Xem và thu hồi các lệnh đã “Luôn cho phép”
/hooks
Quản lý hook
/doctor
Chẩn đoán: mạng, máy chủ, cổng, quyền thư mục

5 chế độ quyền

shift+tab xoay vòng theo thứ tự dưới. Mở sẵn một chế độ: cuongmini --che-do tu-sua.

  • Lập kế hoạch

    Mặc định. Chỉ đọc — không sửa file, không chạy lệnh.

    --che-do ke-hoach

  • Hỏi trước mọi việc

    Mỗi lần sửa / chạy lệnh đều có thẻ duyệt.

    --che-do hoi

  • Tự sửa file

    Sửa file không hỏi, chạy lệnh vẫn hỏi.

    --che-do tu-sua

  • Tự động

    Sửa + chạy lệnh an toàn không hỏi; lệnh nguy hiểm vẫn hỏi.

    --che-do tu-dong

  • Bỏ qua hết

    Không hỏi gì. CLI hỏi xác nhận trước khi bật — chỉ dùng khi thật tin.

    --che-do bo-qua-het

Dùng trong script: -p, -c và các cờ

Ngoài phiên tương tác, CLI chạy được một lượt rồi thoát — tiện cho script và git hook. Chế độ mặc định ở -p vẫn là chỉ đọc.

cuongmini "giải thích dự án"
cuongmini -p "tóm tắt git diff" > tom-tat.md
git diff | cuongmini -p "soát diff này"
cuongmini -c
-p, --in
Chế độ in: chạy một lượt, in kết quả ra stdout rồi thoát
-c, --tiep-tuc
Mở lại việc gần nhất của thư mục này
-m, --model <tên>
Chọn model: sonnet-5 · opus-4-8 · gpt-sol
--che-do <chế độ>
ke-hoach · hoi · tu-sua · tu-dong · bo-qua-het
-C, --thu-muc <đường>
Làm việc ở thư mục khác thư mục đang đứng
-v · -h
In phiên bản · in trợ giúp

Vì sao chuyển từ OpenCode

Trước đây “CuongMini trên terminal” nghĩa là cắm key vào OpenCode. Từ nay đường chính là CuongMini CLI.

Cài đặtCũ: Tự cài Node, npm i -g, đặt biến môi trường, viết opencode.jsonMột dòng lệnh — tự lo Node, tự thêm PATH
Đăng nhậpCũ: Dán key tay, giữ key như mật khẩuTài khoản cuongthai.com (Google/GitHub/Apple/mật khẩu)
Bộ máy AICũ: Agent chung của OpenCode, gọi qua cổng keyĐúng lõi AI Code của app: skill dự án, bộ nhớ bài học, MCP, agent phụ
Khi cổng chính bảo trìCũ: DừngTự chuyển cổng như app
Hạn mứcCũ: Ví riêng của keyChung một ví với app và extension
Lệnh & quyềnCũ: Bộ lệnh của OpenCodeCùng lệnh /, @ file, 5 chế độ quyền với app — giao diện tiếng Việt

Đang dùng OpenCode? Key cũ vẫn chạy tới hết hạn — không ai bị cắt ngang. Hướng dẫn cũ vẫn còn ở /llm-key (mục “Cách cũ”). Muốn chuyển: cài CLI, đăng nhập đúng tài khoản đã được cấp key là dùng được, không cần dán key.

Cập nhật & gỡ cài

Cập nhật

Chạy lại đúng lệnh cài — nó tải bản mới nhất đè lên bản cũ, giữ nguyên đăng nhập và việc đã lưu. CLI tự kiểm bản mới (tối đa một lần mỗi ngày) và nhắc ngay trên màn mở đầu.

curl -fsSL https://cuongthai.com/cli/install.sh | bash

Gỡ cài (macOS)

Xoá dữ liệu + lệnh (bí danh cm chỉ xoá nếu nó là của CuongMini):

rm -rf ~/.cuongmini ~/.local/bin/cuongmini; [ "$(readlink ~/.local/bin/cm)" = "$HOME/.local/bin/cuongmini" ] && rm ~/.local/bin/cm

Rồi mở ~/.zshrc xoá hai dòng ngay dưới chú thích # CuongMini CLI. Dùng fish thì xoá ~/.config/fish/conf.d/cuongmini.fish.

Phiên đăng nhập, lịch sử câu đã gửi và việc đã lưu đều nằm trong thư mục .cuongmini nên đi cùng luôn.

Thích làm trong trình soạn code hơn?

Cùng bộ máy đó có sẵn dạng extension cho VS Code, Cursor, Antigravity, Windsurf, VSCodium — và trong app desktop.

Extension AI Code App desktop
Xin key terminal Kiểm tra hạn mức key Gói Pro Khoá học