Trang 4.1: Lệnh khởi tạo và quản lý dự án (ag-kit init, ag-kit status).

1. Tổng quan về công cụ CLI ag-kit

Công cụ dòng lệnh ag-kit là giao diện chính để quản lý vòng đời của Antigravity Kit trong các dự án. Nó cung cấp 3 lệnh chính:

Trang này tập trung vào ag-kit init và ag-kit status.

---

2. Lệnh ag-kit init — Khởi tạo bộ kit

Mục đích

Lệnh này cài đặt toàn bộ thư mục .agent/ vào dự án của bạn, bao gồm tất cả Agents, Skills, Workflows, quy tắc và scripts.

Cú pháp

bash
ag-kit init [options]

Hành vi mặc định (không có options)

Khi chạy ag-kit init mà không có tham số bổ sung:

1. Kết nối với GitHub để tải phiên bản mới nhất từ nhánh main.
2. Tạo thư mục .agent/ trong thư mục hiện tại (nơi bạn đang đứng trong terminal).
3. Sao chép toàn bộ 20 Agents, 36 Skills, 11 Workflows cùng các file cấu hình.
4. Thông báo kết quả: thành công hay thất bại.

Ví dụ sử dụng cơ bản

bash
# Di chuyển vào thư mục dự án
cd /đường/dẫn/đến/dự-án


# Khởi tạo
ag-kit init

Điều kiện thành công

• ✅ Kết nối internet hoạt động.
• ✅ Quyền ghi vào thư mục hiện tại.
• ✅ Thư mục .agent/ chưa tồn tại (nếu đã tồn tại cần thêm --force).

---

3. Kịch bản khởi tạo phổ biến

Kịch bản 1: Dự án mới hoàn toàn

bash
# Tạo thư mục dự án
mkdir my-project
cd my-project


# Khởi tạo dự án (ví dụ Next.js)
npx create-next-app@latest .


# Cài đặt Antigravity Kit
ag-kit init

Kịch bản 2: Thêm vào dự án đang có sẵn

bash
# Di chuyển vào dự án hiện tại
cd /projects/existing-project


# Cài đặt Kit (sẽ không ảnh hưởng code hiện tại)
ag-kit init

Kịch bản 3: Cài đặt vào thư mục con cụ thể

bash
ag-kit init --path ./packages/my-app

bash
ag-kit init --path ./packages/my-app

Kịch bản 4: Khởi tạo lại sau khi thử nghiệm

bash
# Ghi đè lên .agent/ cũ
ag-kit init --force

---

4. Cấu trúc kết quả sau ag-kit init

dự-án-của-bạn/
├── src/ (code dự án của bạn - không bị ảnh hưởng)
├── package.json (không bị ảnh hưởng)
└── .agent/ ← CHỈ THÊ MỤC NÀY ĐƯỢC TẠO MỚI
├── ARCHITECTURE.md
├── AGENT_FLOW.md
├── mcp_config.json
├── agents/ (20 Agent files)
├── skills/ (36 Skill directories)
├── workflows/ (11 Workflow files)
├── rules/
│ └── GEMINI.md
└── scripts/
├── checklist.py
├── verify_all.py
├── auto_preview.py
└── session_manager.py

Đảm bảo an toàn: Lệnh init chỉ tạo thư mục .agent/. Nó không sửa đổi, không xóa, và không ảnh hưởng đến bất kỳ file code nào trong dự án của bạn.

---

5. Lệnh ag-kit status — Kiểm tra trạng thái cài đặt

Mục đích

Kiểm tra xem bộ kit đã được cài đặt đúng cách chưa và hiển thị thông tin về phiên bản đang dùng.

Cú pháp

bash
ag-kit status

Thông tin hiển thị

Lệnh này sẽ kiểm tra và báo cáo:

Ví dụ kết quả

Antigravity Kit Status
======================
✅ Installation: Found at ./.agent/
✅ Version: 2.0.2
✅ Agents: 20 found
✅ Skills: 36 found
✅ Workflows: 11 found
ℹ️ Latest version: 2.0.2 (up to date)

---

6. Quy trình xác minh sau khi cài đặt

Sau khi chạy ag-kit init, thực hiện các bước sau để xác nhận mọi thứ hoạt động:

Bước 1: Kiểm tra thư mục đã được tạo

bash
ls .agent/ # macOS / Linux
dir .agent\ # Windows

Bước 2: Kiểm tra trạng thái qua CLI

bash
ag-kit status

Bước 3: Thử mở AI Chat trong IDE và gõ thử một lệnh

/status

Nếu AI nhận ra lệnh và hiển thị thông tin dự án, cài đặt đã thành công hoàn toàn.

---

7. Sự cố thường gặp với lệnh init