Cài đặt

Direct binary là channel mặc định. Máy người dùng không cần Node, Bun, npm hay Git; installer tải archive đúng OS/CPU, kiểm checksum và manifest trước khi đổi version hiện hành.

Cài direct binary

macOS hoặc Linux:

curl -fsSL https://raw.githubusercontent.com/phucanh08/alp-code/main/install.sh | bash

Windows PowerShell:

irm https://raw.githubusercontent.com/phucanh08/alp-code/main/install.ps1 | iex

Ví dụ pin version đang được bộ docs này mô tả (v0.15.0):

curl -fsSL https://raw.githubusercontent.com/phucanh08/alp-code/main/install.sh | bash -s -- --version v0.15.0

$env:ALP_VERSION = "v0.15.0"
irm https://raw.githubusercontent.com/phucanh08/alp-code/main/install.ps1 | iex

Binary channel hiện phát hành cho macOS arm64/x64, Linux glibc x64/arm64 và Windows x64. Linux musl, Windows arm64 và notarization chưa thuộc phạm vi v0.13.x.

Cài qua npm

Nếu máy đã có Node.js 18 trở lên:

npm install --global alp-code

Package npm là wrapper nhỏ; nó tải payload trùng version của package vào cache của người dùng. --ignore-scripts vẫn dùng được vì launcher tự bảo đảm payload ở lần chạy đầu.

Kiểm tra cài đặt

alp --version
alp doctor

Kỳ vọng alp --version in version hiện hành. alp doctor trả exit code 0 khi healthy, 1 khi có finding cần xử lý và 2 nếu chính doctor gặp lỗi.

ALP chỉ là launcher; mode bạn chọn có thể cần Claude Code, Codex CLI hoặc cả hai. alp doctor cho biết runtime nào còn thiếu.

Cập nhật

alp update

ALP cập nhật theo channel đã cài. User state nằm trong ~/.alp, tách khỏi versioned installation dưới ~/.alp-code, nên update không thay thế memory hay project registry.

Gỡ cài đặt

alp uninstall

Mặc định ALP chuyển memory sang một thư mục backup cạnh ~/.alp, rồi gỡ phần state và installation do ALP sở hữu.

Tiếp theo: khởi tạo project và mở phiên đầu tiên.