- Cursor vừa ship /debug cho CLI — đưa Debug Mode từ IDE ra terminal.
- Agent tự gắn log, bạn tái hiện bug, nó trả về bản vá 2–3 dòng rồi dọn sạch instrumentation.
- Đây là cách bắt Heisenbug không cần mở editor.
TL;DR
Cursor team vừa công bố batch quality-of-life mới cho Cursor CLI, điểm nhấn là slash command /debug. Thay vì đoán mò từ code tĩnh, agent sẽ instrument code bằng log, bạn tái hiện bug, agent đọc runtime data rồi đưa ra bản vá nhỏ gọn — thường chỉ 2–3 dòng — và dọn sạch log sau khi fix xong. Debug Mode đã có trong IDE từ Cursor 2.2 (10/12/2025); đây là lần đầu nó xuất hiện trong terminal.
Có gì mới
/debug là slash command chạy bên trong session cursor agent, đứng cùng hàng với /plan, /ask, /mcp, /sandbox, /max-mode. Khi gọi, agent không lao vào sửa code — nó đi qua một vòng lặp 3 bước:
- Describe — đọc codebase, sinh nhiều giả thuyết về nguyên nhân, tự chèn log statements để test từng giả thuyết.
- Reproduce — bạn chạy kịch bản lỗi; agent thu variable state, execution path, timing info.
- Verify — agent đề xuất fix, bạn test. Pass thì agent gỡ toàn bộ instrumentation, diff cuối cùng sạch sẽ. Fail thì agent thêm log, lặp lại.
Ngoài /debug, đợt này còn tiếp nối đà QoL của CLI: navigation theo kiểu Emacs (Ctrl+N/P/G), Mermaid diagram render ASCII inline, word-level inline diffs, và plan decision menu bền (arrow keys + Enter, Shift+Enter để đẩy lên cloud).
Vì sao đáng chú ý
Hầu hết AI agent hiện tại debug bằng cách đọc code. Với bug tĩnh thì ổn. Nhưng class bug khó nhất — race condition, flaky test, prod-only bug phụ thuộc shape data thật — không đọc code ra được. Phải chạy thử và quan sát.
/debug đóng đúng khoảng trống đó: agent làm giúp bạn cái việc bạn vẫn tự làm mỗi khi gặp Heisenbug — rải console.log/print quanh nghi phạm, chạy, đọc log, tháo log ra trước khi commit. Khác biệt là agent sinh nhiều giả thuyết song song, instrument có mục đích, và luôn dọn sạch sau khi fix nên instrumentation không bao giờ leak vào diff.
Chi tiết kỹ thuật
| Thuộc tính | Giá trị |
|---|---|
| Lệnh | /debug trong session cursor agent |
| Vòng lặp | Describe → Reproduce → Verify |
| Dữ liệu runtime thu thập | variable states, execution paths, timing info |
| Fix điển hình | 2–3 dòng, minimal diff |
| Ngôn ngữ / stack | Stack-agnostic (theo Cursor) |
| Human-in-the-loop | Bắt buộc — dev reproduce & verify |
| Cài CLI | curl https://cursor.com/install -fsS | bash |
| Windows | irm 'https://cursor.com/install?win32=true' | iex |
So sánh
| Kịch bản | Agent mode mặc định | /debug |
|---|---|---|
| Nguồn dữ liệu | Static code | Runtime logs do agent tự gắn |
| Chất lượng fix | Có thể speculative, nhiều dòng | Grounded theo log thật, 2–3 dòng |
| Instrumentation leak | Không áp dụng | Agent tự dọn sau khi fix pass |
| Phù hợp với | Feature work, refactor | Heisenbug, flaky test, prod-only bug |
So với Cursor IDE Debug Mode (ra mắt 10/12/2025 trong bản 2.2), /debug CLI dùng cùng vòng lặp nhưng chạy trong terminal — không cần mở editor. Desktop 2.6 đã có parallel Debug sessions; CLI hiện bắt đầu với single-session baseline. So với Claude Code, Codex CLI, Aider: chưa có tool terminal nào expose pattern instrument → reproduce → diagnose → clean up như một slash command cấp một.
Use cases thực tế
- Heisenbug: race condition trong async IO, flaky test pass/fail ngẫu nhiên, bug timing-dependent mà đọc code không ra.
- Prod-only bug: chỉ xuất hiện với data shape thật —
/debugrải log vào đúng critical path, reproduce bằng data sample, sau khi fix xong log biến mất. - Codebase lạ: chưa biết bắt đầu đọc từ đâu thì hypothesis generation của agent là điểm khởi đầu hợp lý.
- Hand-off từ CI: dán stacktrace, mở CLI,
/debug, reproduce local, nhận patch nhỏ — cycle time ngắn hơn việc mở IDE rồi attach debugger.
Giới hạn & giá
Agent không quan sát được bug mà bạn không tái hiện được — /debug phụ thuộc vào một reproduction path có thể chạy. Không phù hợp với môi trường cấm sửa code và rerun (ví dụ pure prod observability không push code). Pricing không công bố riêng cho /debug ở CLI — vẫn theo subscription chung của Cursor; dùng /max-mode on để lên model mạnh hơn khi bug phức tạp. Lưu ý CLI release stream đầu 2026 từng có regression: subagent fail (6/2), /compress lỗi (4/2) — không liên quan /debug nhưng cho thấy bề mặt CLI đang thay đổi nhanh, nên pin version khi dùng trong workflow nghiêm túc.
Sắp tới
Hướng hợp lý tiếp theo: parallel /debug trong CLI (Desktop 2.6 đã có), tích hợp sâu với CI (nhận artifact, tự reproduce), và kết hợp /debug với cloud handoff — bắt đầu phiên debug local rồi prepend & để đẩy toàn bộ quá trình chạy log + phân tích lên Cloud Agent trong khi bạn đi làm việc khác. Nếu Cursor đi đúng đà, CLI sẽ thành bề mặt mà các class tooling khác (IDE agent, cloud runner) chỉ là skin.
Nguồn: Cursor Debug Mode blog, Cursor 2.2 changelog, CLI Jan 16 changelog, Cursor CLI docs.
