Bắt đầu

Quickstart

Từ lúc mở Spec ADE đến lượt chat đầu tiên với một agent — chỉ vài phút.

Cần Node.js 18+ và kết nối internet để tải CLI.

Khởi động workspace

Một lệnh duy nhất cho macOS, Linux và Windows. CLI tải binary, khởi động server trên cổng 4123 và tự mở trình duyệt.

Cài đặt trong một lệnh đã phát hành · cài đặt qua npm

npx -y @spec-ade/cli@latest

Truy cập thủ công tại http://localhost:4123 nếu trình duyệt không tự mở. Nếu cổng 4123 đã bị chiếm, CLI chọn cổng trống kế tiếp và in URL trong terminal.

Ba bước đầu tiên

Tạo một project

Project trỏ tới một thư mục trên máy bạn. Mỗi project có nhiều session và một layout pane riêng được lưu lại.

Mở một session

Chọn loại CLI cho session — Auggie (● ) hoặc Claude (◆). Session được tạo ngay với một UUID thật.

Chat với agent

Gõ yêu cầu rồi nhấn Gửi. Agent chạy trong terminal nhúng; bạn thấy output stream theo thời gian thực.

Mẹo

Muốn agent tự chạy đến khi đạt mục tiêu? Dùng nút Send with Goal bên cạnh nút Gửi — xem trang Goal.

Bố cục cửa sổ

Workspace dùng kiểu “floating card”: drawer trái chứa danh sách project/session, header nằm phía trên vùng nội dung, phần còn lại là cây pane bạn có thể split tùy ý. Mỗi pane chứa một hoặc nhiều tab.

Lưu ý

Trạng thái chia sẻ (project, session, layout) lưu ở settings.json qua backend. localStorage chỉ giữ trạng thái UI theo thiết bị như tab đang mở hay vị trí cuộn — đừng kỳ vọng nó đồng bộ giữa các máy.