Cài lại clean AgentKit

Binary channel và kit channel tách nhau. Ghi rõ --channel stable khi muốn chắc cài/cập nhật từ stable.

1. 1

   Dừng tiến trình đang ghi

   Đóng Codex, Claude Code và mọi lệnh lifecycle AgentKit đang chạy trước khi đụng file tạm hoặc gỡ kit.

2. 2

   Xác nhận CLI ak + kênh stable

   type -a ak, ak --version, ak self-update --check --channel stable. Nâng CLI nếu cần — nhưng chưa xóa ~/.agentkit.

3. 3

   Workaround file ..* (2.7.0)

   Nếu gặp lỗi snapshot outside scope: đóng Codex, list rồi move (không xóa) file tạm khớp pattern hẹp sang quarantine.

4. 4

   Audit + gỡ kit đã sở hữu

   Chỉ gỡ scope/mode thật sự đã cài: global native, user plugin, project native, project plugin. Preview (--dry-run) rồi --yes.

5. 5

   Xác minh bằng chứng gỡ

   ak audit --json và ak backups list --json. Snapshot recovery còn lại là bằng chứng — giữ đến khi cài lại xong.

6. 6

   Reset state AgentKit (tùy chọn)

   Chỉ sau khi gỡ kit xong: ak logout, rồi mv ~/.agentkit sang tên phục hồi — không xóa ngay.

7. 7

   Cài lại CLI stable

   Installer stable, hash -r, type -a ak, ak --version, ak doctor --json. Giải quyết trùng binary trên PATH.

8. 8

   Login + cài lại kit

   ak login, ak licenses, ak kit init … --channel stable --yes, rồi audit/doctor trước khi restart Codex.

Đóng Codex, Claude Code, và mọi lệnh lifecycle AgentKit đang chạy trước khi đụng file tạm trong ~/.codex hoặc chạy uninstall. Không chồng lifecycle, không kill giữa chừng pha mutation.

Trước hết list file khớp pattern hẹp (maxdepth 1, type file):

find "$HOME/.codex" -maxdepth 1 -type f \
  -name '..codex-global-state.json.bak.tmp-*' -print

Sau khi Codex đã đóng, move các file khớp sang quarantine có thể phục hồi ngoài cây ~/.codex (nhưng vẫn trong ~/.agentkit để dễ tìm):

quarantine="$HOME/.agentkit/manual-quarantine/codex-temp-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$quarantine"

find "$HOME/.codex" -maxdepth 1 -type f \
  -name '..codex-global-state.json.bak.tmp-*' \
  -exec mv -n {} "$quarantine"/ \;

Sau quarantine, chạy lại dry-run rồi uninstall có --yes (đúng scope bạn dùng — xem Phase 4).

ak audit --json
ak backups list --json

Recovery snapshot còn lại là bằng chứng mong đợi — không xóa cho đến khi lifecycle và cài lại đã verify. Chỉ mô tả uninstall “đã gỡ” khi lệnh confirmed (--yes) thành công.

# Chỉ sau khi ownership-aware kit uninstall đã xong
ak logout

stamp=$(date +%Y%m%d-%H%M%S)
mv "$HOME/.agentkit" "$HOME/.agentkit.pre-stable-$stamp"

# Giữ thư mục đổi tên cho đến khi cài stable + audit/doctor pass
# Không xóa ngay — trong đó có backup, quarantine, registry, auth state

• Reset state AgentKit nhưng vẫn giữ bản phục hồi (mv, không rm).
• Cũng dời backups và quarantine file tạm đã tạo ở Phase 3 (nằm trong ~/.agentkit).
• Không xóa thư mục đổi tên cho đến khi cài stable + kit audit pass.

ak login
ak licenses

# Ví dụ: Engineer Kit trên Codex global, kênh stable
ak kit init engineer \
  --target codex \
  --global \
  --channel stable \
  --yes

ak audit engineer --strict --json
ak doctor --adapter codex --json

# Chỉ restart Codex sau khi các check trên xong

Giữ quarantine và ~/.agentkit.pre-stable-* cho đến khi ak audit / ak doctor pass. Sau đó mới cân nhắc dọn bản phục hồi.

# PowerShell — đóng Codex trước. Chỉ file tạm khớp pattern hẹp.
$codex = Join-Path $env:USERPROFILE '.codex'
$stamp = Get-Date -Format 'yyyyMMdd-HHmmss'
$quarantine = Join-Path $env:USERPROFILE ".agentkit\manual-quarantine\codex-temp-$stamp"
New-Item -ItemType Directory -Force -Path $quarantine | Out-Null

Get-ChildItem -LiteralPath $codex -File -Force |
  Where-Object { $_.Name -like '..codex-global-state.json.bak.tmp-*' } |
  ForEach-Object {
    Move-Item -LiteralPath $_.FullName -Destination $quarantine -ErrorAction Stop
  }

Get-ChildItem -LiteralPath $quarantine -Force

# PowerShell — chỉ sau kit uninstall ownership-aware
ak logout
$stamp = Get-Date -Format 'yyyyMMdd-HHmmss'
$homeAk = Join-Path $env:USERPROFILE '.agentkit'
$dest = Join-Path $env:USERPROFILE ".agentkit.pre-stable-$stamp"
Move-Item -LiteralPath $homeAk -Destination $dest

# PowerShell
irm https://agentkit.best/install.ps1 | iex
# Mở terminal mới, rồi:
Get-Command ak -All
ak --version
ak doctor --json

Các lệnh ak kit uninstall / audit / kit init giống Unix (cùng flags). Thay $HOME bằng %USERPROFILE% khi nói path; dùng đường dẫn project tuyệt đối cho --project-dir.