ak init Khởi tạo project AgentKit trong thư mục hiện tại
--dry-run--force--docs-dir--plans-dir--project-id--no-backup
$ ak init
Bảng điều khiển AK CLI
AgentKit CLI Quick Reference
Danh sách lệnh ak — setup , kit , account , inspect , config . Copy mẫu lệnh; xem flag chính.
Nguồn: ak --help
(AgentKit CLI). Universal flags: --json , --yes , --no-interactive , --quiet
.
49
Lệnh
5
Nhóm
ak
CLI
01
Vòng đời & cài đặt
8 lệnh
ak new Tạo project AgentKit mới
$ ak new myproj
ak setup Wizard cấu hình lần đầu
$ ak setup
ak onboard Chỉ chạy bước còn thiếu (setup, login, cài Kit). --yes không ghi đè hay takeover.
--kit--target--channel--global--project-dir--email--yes--no-interactive
$ ak onboard --kit engineer --target codex
ak self-update Kiểm tra hoặc cài bản CLI ak đã ký
--check--channel--beta--dry-run--include-desktop--changelog--enable-auto-update--disable-auto-update
Beta Trên beta, --beta / --channel chỉ áp dụng cho lần chạy này, không đổi updates.channel trong config. Muốn mặc định nhận bản CLI beta thì đặt key đó.
$ ak self-update --check
ak update Xem trước hoặc làm mới kit do AgentKit quản lý; gỡ file kit chưa sửa tay mà nguồn mới không còn phát hành
--dry-run--yes--force--global--channel--beta--kits--local--remote--target--show-diff
Beta Trên beta, --beta / --channel chỉ áp dụng cho lần chạy này. Không gắn cờ thì mỗi kit đã cài đi theo kênh lúc nó được cài.
$ ak update --dry-run
ak uninstall Gỡ project do AgentKit quản lý
$ ak uninstall
ak gui Mở AgentKit Desktop
$ ak gui
02
Kit, skill & agent
10 lệnh
ak kit Quản lý kit: liệt kê, cài, làm mới, gỡ
initinstallinstall-pathlist-kitsrefreshrepair-install-modeuninstallvalidate
Beta Trên beta, ak kit list-kits mặc định đọc danh sách kit từ remote và không còn tự lấy thư mục ./kits local. Muốn xem nguồn local thì truyền --kits-dir hoặc đặt AGENTKIT_KITS_DIR.
$ ak kit list-kits
ak kit init Cài hoặc build một kit
--yes--beta--channel
Beta Trên beta, --beta / --channel chỉ áp dụng cho lần chạy này, không đổi kênh mặc định trong config. Muốn beta là mặc định thì đặt kit.channel trong config.
$ ak kit init engineer --yes
ak kit refresh Làm mới kit đã cài và xóa file generate cũ
$ ak kit refresh engineer
ak kit uninstall Gỡ kit khỏi project hiện tại hoặc thư mục adapter. Mặc định dry-run; thêm --yes mới ghi.
$ ak kit uninstall engineer --dry-run
ak skills Xem, tìm, cài hoặc gỡ từng skill trong kit
graphinstalllistremovesearchshow
Beta Beta thêm ak skills route "<intent>" để chọn skill đã cài phù hợp với ý định, hoặc trả về NONE (chỉ đọc, chạy offline). Beta cũng thêm các lệnh cho bản phát hành skill SkillX (resolve, inspect, read, sync) và để chạy script skill đã được cấp quyền trong sandbox (exec, grants, mcp serve); nhóm này cần bật biến môi trường như AGENTKIT_SKILLX=1, nên xem ak skills --help trước. Khi bật AGENTKIT_SKILL_STORE=1, ak skills migrate đưa các skill của kit do bản cài cũ ghi ra vào skill store mà không ghi, di chuyển hay xóa file skill nào; lệnh chạy luôn không hỏi lại, nên chạy thử với --dry-run --json trước.
$ ak skills list
ak skill Quản lý môi trường runtime theo từng skill
$ ak skill
ak agents Quản lý agent đã cài
Beta Beta thêm ak agents model (list, get, explain, set, inherit, reset, adopt, apply) để xem và đổi model mà từng agent đã cài đang chạy. list, get và explain chỉ đọc; nếu bạn đã đổi model ngay trong runtime thì adopt ghi lựa chọn đó vào config, còn apply chỉ ghi đè khi có --yes.
$ ak agents
ak run Chạy một skill qua adapter đã cấu hình
$ ak run engineer/scout
ak commands Quản lý slash command
$ ak commands
ak content Xuất nội dung lên channel
$ ak content
03
Tài khoản
4 lệnh
ak login Đăng nhập AgentKit (email OTP, license key, hoặc API key)
--email--license-key--api-key--device-name
$ ak login --email you@example.com
ak logout Xóa thông tin đăng nhập local
$ ak logout
ak whoami Xem tài khoản đang đăng nhập và kit được cấp
$ ak whoami
ak licenses Liệt kê kit đã được cấp phép
$ ak licenses
04
Kiểm tra & chẩn đoán
17 lệnh
ak doctor Kiểm tra sức khỏe bản cài AgentKit
--json--adapter--check--fix--list--offline--exit-on-fail
Beta Beta thêm bước kiểm tra chỉ đọc ak doctor --check skill_roots_shared, cảnh báo khi hai runtime dùng chung một thư mục skill qua symlink hoặc junction. Cảnh báo này không đổi mã thoát; hãy cho mỗi runtime một thư mục skill riêng.
$ ak doctor --json
ak audit So kit đã cài với bản gốc, tìm chỗ bị lệch
$ ak audit
ak backups Quản lý snapshot để rollback
$ ak backups
ak recover Khôi phục một snapshot (cùng lệnh ak backups restore)
--dry-run--latest--allow-root
$ ak recover <id> --dry-run
ak journal Tạo, xem, kiểm tra nhật ký công việc trong plan storage
createlistshowvalidate
$ ak journal list
ak activity Xem activity feed local
$ ak activity
ak usage Xem token 5 giờ và tuần theo provider từ kho analytics local. Chế độ local không mở kết nối mạng.
limits --provider--window--json
$ ak usage limits --provider claude
ak insights Đo chất lượng, chi phí và thời gian của skill và agent trên máy. Thu thập và chia sẻ số liệu gộp là hai lựa chọn bật riêng.
skillsagentsconsentcollectcompare
Beta Beta thêm ak insights work (list, create, defer, dismiss, awaiting-verification, verify) để theo dõi việc cải thiện từ các gợi ý có bằng chứng. verify chỉ so sánh số liệu đã ghi, không chạy model hay sửa file.
$ ak insights skills
ak eval Chạy một suite đánh giá skill và agent ngay trên máy.
run
$ ak eval run suite.json
ak analytics Bật/tắt/làm mới chỉ mục analytics local (không gửi đi đâu)
statusenabledisablerefreshrebuilddelete
$ ak analytics status
ak content-search Tìm trong nội dung project (opt-in, lưu plaintext local)
statusenabledisablesearchrebuilddelete
$ ak content-search status --project <uuid>
ak data Xem chính sách giữ data dẫn xuất và chạy ingest có giới hạn
statusretentioningest
$ ak data status
ak sessions Xem và bảo trì session coding agent local
$ ak sessions
ak diagnostics Xuất gói chẩn đoán đã che thông tin nhạy cảm
$ ak diagnostics
ak versions Liệt kê phiên bản local của ak, kit và skill
Beta Trên beta, ak versions hiện một dòng cho mỗi nơi đã cài (runtime, scope, cách cài), và dữ liệu --json dùng schema version 2. Thêm --local-only để không tra mạng.
$ ak versions
ak changelog Xem changelog đã xác thực của CLI, app và kit
--channel--target--from--full--since-current--json
$ ak changelog --channel stable --target cli
ak feedback Gửi hoặc xuất feedback sản phẩm
$ ak feedback
05
Cấu hình & runtime
10 lệnh
ak secrets Lưu secret theo tên trong keychain của hệ điều hành. ~/.agentkit/secrets/index.json chỉ giữ metadata, không giữ giá trị.
setgetlistdeleterotateimport-env
Beta Beta thêm ak secrets annotate <ref> để mô tả một secret đã lưu (project, môi trường, provider, tài khoản, tag) mà không đổi giá trị của nó, và ak secrets search để tìm secret theo các thông tin đó, không bao giờ tìm theo giá trị. annotate chỉ chạy ở terminal; trang Secrets của app Desktop hiển thị kết quả và tìm kiếm theo cùng cách. ak secrets import-env <dir> nhập mọi file dotenv trong thư mục project thành một plan (bỏ qua file example, template và backup); thêm --dry-run để xem plan mà không lưu gì. Key xuất hiện ở nhiều file sẽ bị bỏ qua và liệt kê từng chỗ.
$ ak secrets list
ak config Mở dashboard AgentKit local
$ ak config
ak mcp Xem cấu hình MCP server local
$ ak mcp
ak migrate Chuyển bản cài ClaudeKit sang AgentKit. Mặc định chỉ xem trước; ghi thật cần --yes
prefsrollback --from--dry-run--yes--switch-to-plugin--force-unlock
$ ak migrate --from=ck
ak projects Quản lý registry project AgentKit trên máy
$ ak projects
ak plan Quản lý thư mục plan
$ ak plan
ak api Chạy API + proxy local cho AgentKit
$ ak api
ak watch Theo dõi repo GitHub và trả lời issue tự động
$ ak watch
ak orchestrate Chạy và giám sát job graph CLI (chỉ macOS)
startstatusresumestop
$ ak orchestrate status <run-id>
ak codex-agent-runtime Runtime MCP để Codex gọi agent
$ ak codex-agent-runtime
Beta
Lệnh chỉ có trên bản beta
Các lệnh này chỉ có khi bạn chạy CLI ak bản beta, chưa có trên stable. Cách chuyển sang beta
ak describeIn ra contract của bất kỳ lệnh ak nào cho agent và script: tóm tắt, ví dụ, flag, lệnh con, mã thoát đã khai báo, và lệnh đó có sửa file, cần mạng hay hỏi xác nhận không. Chỉ đọc và chạy offline; giá trị nào lệnh chưa khai báo sẽ hiện "unspecified".
--json
$ak describe kit install --json
ak licenseXem và quản lý các thiết bị đã kích hoạt bằng license key AgentKit App. Cần phiên đăng nhập từ ak login --license-key; đăng nhập bằng API key hay email không dùng được ở đây. Muốn xem bạn được cài kit nào thì dùng ak licenses.
$ak license devices