Phần 10 của 5200% hoàn thành

Cursor CLI — agent từ terminal

English title: Cursor CLI — Agent from the Terminal

Bài 10 trong chuỗi 15 bài hướng dẫn Cursor. Code từ terminal — script, CI, hoặc khi bạn làm việc qua SSH không có giao diện Cursor. Cursor CLI cho phép gọi Cursor AI từ dòng lệnh: các mode Agent, Plan, Ask; session resumption (tiếp tục session cũ); sandbox (giới hạn quyền chạy lệnh). Bài này giới thiệu khi nào dùng CLI và các mode cơ bản.

Mở đầu: Code từ terminal

Bạn muốn tự động hóa: "mỗi lần push lên branch X, chạy script gọi AI review code và comment lên PR." Hoặc bạn đang SSH vào server, không có Cursor IDE — nhưng vẫn muốn chạy một task đơn giản qua AI. Cursor CLI cho phép gọi Agent (hoặc Plan, Ask) từ terminal: interactive (chat với AI) hoặc non-interactive (in ra kết quả cho script). Tài liệu chính: cursor.com/docs/cli/overview.

1. Đi sâu: Cursor CLI là gì

Tại sao chủ đề này quan trọng: IDE phù hợp làm việc tương tác; CLI phù hợp automation, CI, hoặc môi trường không GUI. Biết CLI giúp bạn mở rộng cách dùng Cursor.

Hiểu sai thường gặp: Nhiều người nghĩ "CLI = chỉ chat text". Thực tế CLI có thể chạy Agent (sửa file, chạy lệnh) và Plan (tạo kế hoạch), tùy mode.

Bản chất đúng: Cursor CLI = chương trình dòng lệnh (vd. cursor hoặc cursor agent). Chạy với tham số hoặc prompt; có thể interactive (bạn gõ, AI trả lời) hoặc non-interactive (script gọi một lần, nhận output). Các mode: Agent (thực hiện task), Plan (tạo plan), Ask (chỉ hỏi đáp, không thay đổi file). Session resumption = tiếp tục session trước đó. Sandbox = giới hạn quyền (vd. không cho chạy lệnh tùy ý) để an toàn.

2. Khái niệm

Agent mode (CLI): Tương tự Agent trong IDE — AI có thể đọc/sửa file, chạy lệnh. Dùng khi task cần thay đổi code từ terminal.
Plan mode (CLI): AI tạo kế hoạch (research codebase, outline bước); không (hoặc chưa) thực thi. Output có thể in ra hoặc lưu file.
Ask mode (CLI): Chỉ Q&A; AI không gọi tool sửa file hay chạy lệnh. Phù hợp câu hỏi nhanh trong script.
Session resumption: CLI lưu state session; lần chạy sau có thể "resume" để tiếp tục ngữ cảnh trước đó.
Sandbox: Chế độ giới hạn quyền khi AI chạy lệnh (vd. không cho ghi ra ngoài thư mục project) — giảm rủi ro khi chạy script không tin tưởng hoàn toàn.

3. Workflow: Khi nào dùng CLI

Cần automation / CI — Script gọi cursor agent "review and suggest fixes for changed files" với output dùng cho bước tiếp (vd. comment PR).
Làm việc qua SSH / không có GUI — Chạy cursor hoặc cursor ask "..." để hỏi đáp hoặc task đơn giản.
Interactive từ terminal — Mở terminal, chạy cursor agent (hoặc tương đương) để chat với AI ngay trong terminal; session resumption nếu cần tiếp tục sau.
Sandbox — Khi chạy trong môi trường không tin tưởng đầy đủ, bật sandbox để giới hạn quyền AI.

4. Ví dụ ngắn (mô tả)

Ask: cursor ask "What does function parseConfig in src/config.ts do?" — Chỉ cần câu trả lời text; không sửa file.
Agent: cursor agent "Add a unit test for parseConfig" — AI có thể đọc file, tạo file test, chạy test. (Cú pháp thực tế xem Docs.)
Plan: cursor plan "Add export CSV feature to report module" — AI research và in ra plan; bạn có thể dùng output đó rồi chạy Agent từng bước.

5. Ứng dụng

Part 2 (bài 6–10) kết thúc với CLI. Part 3 (bài 11–15): Hooks, TDD, review diff, Cloud Agents, tổng kết. Bài tiếp: Hooks — tự động hóa theo sự kiện (trước/sau khi Agent chạy tool).

Bài tiếp: Hooks — tự động hóa theo sự kiện (bài 11).