Download · CLI v1.0.2

Cài com trên máy của bạn

Một bộ cài có sẵn Bun, engine Rust và PostgreSQL nhúng. Không cần Node, npm hay Bun. Cài xong là tạo dự án, chạy dev server và đưa lên cloud bằng một lệnh.

Chọn hệ điều hành

macOS

macOS 13 trở lên, chip Apple Silicon hoặc Intel (một bộ cài cho cả hai).

Tải dmg.dmg · 79MB

Windows

Windows 10 (1809) trở lên, 64-bit, CPU hỗ trợ AVX2 (hầu hết máy từ 2013).

Tải exe.exe · 40MB

Linux

glibc 2.28 trở lên (Ubuntu 20.04, Debian 10, RHEL 8 trở lên), x64 có AVX2 hoặc arm64.

Xem lệnh càix64 & arm64 · 54MB

Hướng dẫn cài đặt

  1. 1
    Tải com-macos.dmg, mở file rồi chạy Install com.pkg bên trong.
  2. 2
    Nếu macOS báo không xác minh được nhà phát triển: vào System Settings › Privacy & Security, kéo xuống và bấm Open Anyway, rồi mở lại bộ cài.
  3. 3
    Làm theo các bước và nhập mật khẩu máy. CLI được cài vào /usr/local/com, các lệnh com, cai, aivn nằm trong /usr/local/bin.
  4. 4
    Mở một cửa sổ Terminal mới và kiểm tra:
    com --version

Bắt đầu sử dụng

  1. 1. Tạo dự án

    Next.js App Router, Tailwind và PostgreSQL nhúng (PGlite), không cần cài database.

    com create my-app
cd my-app

  2. 2. Chạy dev server

    Mở http://localhost:3000. Sửa file là thấy ngay, gói npm thiếu được tự cài.

    com dev

  3. 3. Viết và chạy test

    Bun Test với database thật trong RAM, không cần mock.

    com test

  4. 4. Build và chạy production

    Build tối ưu vào .nata/build rồi phục vụ bằng engine Rust.

    com build
com start

Dự án mới có sẵn AGENTS.md mô tả cấu trúc thư mục, cách truy vấn database và viết test, để các trợ lý AI code đúng kiến trúc.

Các lệnh thường dùng

com create [tên]Tạo dự án mới
com devDev server (hot reload). --port, --tunnel để có link public và QR
com build · com startBuild và chạy bản production
com testChạy test (--watch, --coverage, --filter)
com lint · com typecheckKiểm tra code (oxlint) và kiểu (tsc)
com db pullĐọc schema database, sinh types/db.d.ts
com migrate <sql|file>Chạy migration SQL rồi đồng bộ schema
com login · com whoamiĐăng nhập Google để dùng các lệnh cloud
com clone <viewId>Tải mã nguồn một dự án đã tạo trên web
com push · com publishLưu thay đổi lên cloud, xuất bản bản production
com doctor · com infoKiểm tra môi trường, in thông tin để báo lỗi
com --helpToàn bộ lệnh và tuỳ chọn
Clone dự án từ web và làm template: xem Docs

Cập nhật và gỡ cài đặt

Cập nhật: tải bộ cài mới nhất và cài đè lên bản cũ (Linux: chạy lại lệnh cài). Dự án và dữ liệu của bạn không bị ảnh hưởng.

Gỡ cài đặt:

  • macOS:
    sudo rm -rf /usr/local/com /usr/local/bin/com /usr/local/bin/cai /usr/local/bin/aivn
  • Windows: Settings › Apps › Installed apps › Com.AI.VN CLI › Uninstall.
  • Linux: xoá thư mục cài và dòng # com CLI trong ~/.bashrc / ~/.zshrc:
    rm -rf ~/.com/cli

Gặp sự cố

  • “command not found: com”: mở cửa sổ terminal mới để nhận PATH mới. Trên macOS, kiểm tra /usr/local/bin có trong echo $PATH.
  • Dev server không chạy hoặc trang lỗi: chạy com doctor để kiểm tra cổng, engine và file .env; gửi kết quả com info khi báo lỗi.
  • Kiểm tra file tải về: so mã SHA256 với SHA256SUMS. Bản cũ nằm ở …/com-cli/v<phiên bản>/.