Cài kit cho nhiều runtime, project hay global: bảng chứng nhận thật, không tô hồng

Bài 4/20 trong bộ onboarding AgentKit v3. Đọc khoảng 9 phút.

"AgentKit chạy được trên Cursor không anh?" Câu trả lời trung thực là: cài được, nhưng chưa đạt chứng nhận. Bài này cho bạn cái bảng mà tui dùng nội bộ để quyết định runtime nào "chín" tới đâu, rồi chỉ cách cài cho từng trường hợp.

1/ Bảng chứng nhận runtime của v3.0.0

Mỗi runtime được chạy thử trên 3 môi trường: macOS arm64, Windows 11, Linux (WSL). Kết quả:

Đọc bảng này thế nào?

• Bạn xài Claude Code hay DeepSeek Harness: yên tâm, đây là đường chính.

• Codex: chạy tốt trên macOS và Linux. Trên Windows chạy được nhưng chưa phải mọi thứ đều xanh.

• Cursor, Antigravity: cài được để thử, đừng đem đi làm việc quan trọng lúc này.

Một chỗ tui phải thừa nhận: trang FAQ của agentkit.best đang liệt kê Antigravity là runtime "available", trong khi bảng chứng nhận ghi spike và ak update chưa nhận agy làm target. Tui ghi vào báo cáo gap để sửa cho khớp.

2/ Project hay global?

Lời khuyên của tui: bắt đầu bằng project. Team clone repo về là có đủ skill, không phụ thuộc máy ai cài gì.

3/ Cài cho một runtime ✅

Mặc định ak kit init cài cho Claude Code, ở project hiện tại:

cd ~/projects/du-an-cua-ban
ak kit init engineer --yes

Với Claude Code, chế độ project-native gộp nội dung vào ./.claude và lưu metadata vòng đời ở ./.agentkit.

Muốn cài global:

ak kit init engineer --global --yes

4/ Cài cho nhiều runtime cùng lúc ✅

--target nhận danh sách ID cách nhau bằng dấu phẩy:

ak kit init engineer --target claude-code,codex --yes

Thêm kit marketing cho cùng project:

ak kit init marketing --target claude-code,codex --yes

Sau đó update cũng theo runtime:

ak update --target codex --yes

Theo help của ak update bản 3.0.0, target project được hỗ trợ là: claude-code, codex, cursor, dsh, grok, omp, pi. Global thì giống vậy nhưng không có pi.

5/ Chỉ cài vài skill ✅

Kit Engineer có cả trăm skill. Không cần hết thì:

ak kit init engineer --skills ak-plan,ak-cook,ak-debug,ak-ship --yes

Hoặc cài hết trừ vài cái:

ak kit init engineer --exclude-skills ak-motion-video,ak-filmmaking --yes

Hoặc chọn bằng menu tương tác:

ak kit init engineer --select-skills

6/ Mấy tình huống hay gặp

"Tui sửa file skill rồi, update có ghi đè không?"

Không âm thầm ghi đè. ak ghi hash của từng file nó cài. File bạn sửa sẽ bị phát hiện là drift, lệnh dừng với exit 6. Muốn ghi đè thì phải --force, và trước khi ghi nó vẫn snapshot.

"Tui muốn reset sạch một runtime về đúng nội dung kit"

ak kit init engineer --fresh --target codex

--fresh cho xem trước, hỏi xác nhận, chụp snapshot có kiểm tra, rồi mới dọn. Chạy bằng script thì cần --yes, và nếu kế hoạch liệt kê rủi ro thì phải thêm đúng token --accept-risks nó in ra. --yes một mình không bao giờ chấp nhận rủi ro thay bạn.

"Có agent khác đang chạy update"

Exit 4: một thao tác AgentKit khác đang giữ khoá vòng đời kit. Đợi xíu rồi chạy lại. Không có chuyện hai lần update giẫm lên nhau.

"Codex có đọc rule project không?"

Codex project rule được ghi vào <project>/.codex/AGENTS.md. Theo bảng chứng nhận, file này được giữ lại nhưng chưa được Codex kích hoạt. Rule quan trọng thì nên để ở AGENTS.md gốc của repo. Thêm nữa, privacy guard trên Codex chưa phủ MCP và các tool đọc cục bộ (xem bài 7).

"Tui dùng Claude Code plugin thay vì copy file được không?"

ak kit init engineer --switch-to-plugin

Cờ này chọn kiểu phân phối plugin của Claude Code ở scope bạn chọn.

Bảng exit code nên nhớ

Bài tiếp: Quản lý skill và SkillX →

Nguồn

• Ma trận chứng nhận runtime v3.0.0 trong repo agentkit (tag v3.0.0)

• ak kit init --help, ak update --help (ak 3.0.0): danh sách target, cờ --target, --global, --skills, --exclude-skills, --fresh, --accept-risks, bảng exit code

• FAQ trên https://agentkit.best (kiểm tra 02/11/2026): danh sách runtime "available" và "preview"

• GitHub release v3.0.0, danh sách asset gói kit theo runtime: https://github.com/bestagentkits/agentkit/releases/tag/v3.0.0