thuật ngữ
cli là gì, và vì sao agent thích cli?
CLI là viết tắt của Command Line Interface, tức giao diện dòng lệnh. Bạn điều khiển chương trình bằng cách nhập lệnh thay vì bấm nút. Có lẽ bạn đã dùng vài CLI: git, npm, docker.
gui và cli
| GUI (đồ họa) | CLI (dòng lệnh) | |
|---|---|---|
| cách sử dụng | Bấm nút, kéo thả | Nhập lệnh |
| ví dụ | GitHub Desktop | git push |
| với con người | Thường dễ bắt đầu hơn | Nhanh hơn khi đã biết lệnh |
| với agent | Khó dùng, cần ảnh chụp và thao tác bấm | Tự nhiên, vì agent vốn đã nhập lệnh |
vì sao agent thích cli
AI coding agent dành cả ngày để nhập lệnh trong terminal. Đó là cách chúng chạy code, cài package, dùng git và chạy test. CLI khớp ngay với cách làm việc này. Không cần tích hợp riêng.
Vì vậy Pane xây dựng runpane dưới dạng CLI thay vì bắt agent dùng giao thức riêng. Claude Code, Codex, Aider hay script bash đều được. Nếu có thể nhập runpane panes create, nó có thể điều khiển Pane.
điều gì giúp cli thân thiện với agent
Không phải CLI nào cũng phù hợp với agent. Đây là những điều quan trọng:
Đầu ra JSON. Agent không thể phân tích bảng dành cho người đọc một cách ổn định. Cờ --json cung cấp dữ liệu có cấu trúc để chúng xử lý.
Lệnh khám phá. Agent không nên phải đọc tài liệu mới biết có những lệnh nào. Lệnh như runpane agent-context cho chúng biết mọi thứ chỉ trong một lần gọi.
Đầu ra mặc định ngắn. Context window của agent có giới hạn. Nếu một lệnh mặc định trả 500 dòng, nó sẽ phí token. CLI tốt giữ đầu ra ngắn và cho phép lấy thêm bằng cờ như --limit 200.
Chế độ không tương tác. Agent không thể trả lời câu hỏi "Bạn có chắc không? (y/n)". Cờ --yes giúp bỏ qua bước xác nhận trong quy trình tự động.
Đọc được trước khi cài. Agent cần kiểm tra CLI làm được gì trước khi cài. Pane công khai toàn bộ danh sách lệnh tại một URL để agent xem trước.
runpane áp dụng các nguyên tắc này ra sao
# Discovery: what commands exist?
runpane agent-context --json
# Short output: just what's on screen right now
runpane panels screen --panel <id> --limit 80 --json
# Non-interactive: skip the "are you sure?" prompt
runpane panes create --repo active --name "my-task" --yes --json
# Readable before install:
curl -fsSL https://runpane.com/runpane-cli-contract.jsonliên quan
- Tài liệu CLI runpane — tài liệu tham khảo đầy đủ
- Trang giới thiệu CLI runpane — vì sao Pane xây dựng CLI
- MCP là gì? — giao thức bổ trợ cho CLI
- Agent-agnostic nghĩa là gì? — vì sao CLI giúp làm được điều đó
Cập nhật lần cuối 24 tháng 6, 2026