ak versions

Dùng ak versions để kiểm tra build CLI đang chạy, mọi destination Kit đã cài và Skill được tìm thấy dưới install root của Claude plugin. Đây là lệnh inventory, không phải trình cập nhật.

Cách dùng

ak versions

Lệnh không nhận argument theo vị trí.

Tuỳ chọn

--local-only và --remote-only loại trừ nhau. Các cờ đầu ra dùng chung được mô tả trong quy ước CLI. Lệnh không bao giờ hỏi và --yes không có tác dụng.

Trước khi chạy

Quá trình liệt kê cục bộ đọc:

• binary version, commit và build date được compile vào ak;
• install receipt của mọi destination Kit trong project hiện tại và scope global, cho một bản ghi theo mỗi runtime, scope và delivery mode;
• manifest Skill dưới AGENTKIT_PLUGIN_DIR/<kit>/skills/, mặc định là ~/.claude/plugins/<kit>/skills/.

Cây cache và cây nguồn không phải Kit đã cài, nên không xuất hiện thành dòng.

Ở chế độ mặc định, lệnh kiểm tra metadata bản phát hành binary đã ký và resolve phiên bản Kit mới nhất từ manifest registry có xác thực (chỉ metadata, không tải hay cài gì). Kết quả được cache trong ~/.agentkit/cache/registry/index.json (dưới AGENTKIT_HOME khi được đặt). Mục cache fresh được dùng lại; mục stale được giữ làm fallback offline và báo check state stale. Cache thiếu, hỏng hoặc không đọc được được xem là cache miss.

--local-only không gửi request mạng nào và không ghi cache; khi đó mọi dòng báo check state not_checked. --remote-only trả binary identity cùng mảng kits và skills rỗng.

Ví dụ

ak versions
ak versions --local-only
ak versions --json
ak versions --cache-ttl 30m

Đầu ra và luồng

Stdout dành cho người dùng là bảng có một dòng cho mỗi destination. Terminal rộng hiển thị TYPE, NAME, SOURCE, INSTALLED, AVAILABLE, HEALTH và STATUS, nên phiên bản nguồn, bản phát hành registry đã ghi nhận và bản phát hành registry đang có được gắn nhãn riêng. Mỗi dòng Kit cũng liệt kê destination và, khi biết, channel cùng nguồn của channel. Giá trị tuỳ chọn bị thiếu in là unknown.

JSON thành công dùng envelope ngoài kind=versions (envelope schema_version 1). data có schema_version riêng của inventory, nay là 2:

data.schema_version: 2
data.binary: version, commit, date, latest, check_state, version_state
data.kits[]: kit, runtime, scope, delivery_mode, destination,
  source_version, registry_version, available_version, origin, channel,
  channel_source, required_cli_version, emitted_by_cli, receipt_recorded,
  health, last_emit, check_state, version_state, compatibility
data.skills[]: kit, name, version
data.registry: cached_at, stale, optional stale_age, check_state, optional reason

check_state là not_checked, checked, offline, failed hoặc stale. version_state là unknown, dev, current, update_available hoặc ahead. compatibility là satisfied, requires_upgrade hoặc unknown, còn health là ok, modified, incomplete hoặc unknown. Các mảng luôn có mặt dù rỗng, và trường Kit tuỳ chọn bị thiếu là null. Tên trường của phiên bản 1 như data.kits[].name và version không còn, nên hãy cập nhật parser đang đọc chúng. Lỗi trong chế độ JSON, kể cả lỗi phân tích cờ (mã thoát 2), kết thúc stderr bằng error envelope dùng chung.

Kết quả và mã thoát

Lệnh không apply, thay thế hay xoá gì. Chế độ mặc định có thể cập nhật registry cache; --local-only thì không. Chỉ dùng lệnh cập nhật sau khi xem lại vòng đời liên quan.

Lệnh liên quan và giới hạn

• Kiểm tra hoặc áp dụng cập nhật CLI
• Refresh một route Kit
• Thông tin đầy đủ của lệnh ak versions
• Xử lý sự cố cập nhật