> ## Documentation Index > Fetch the complete documentation index at: https://cyberskill-mintlify-f0a375f9.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Cài đặt CyberOS: npx, Claude Plugin, curl, hoặc Docker > Cài đặt CyberOS vào kho mã dự án của bạn bằng npx, Claude plugin, script khởi tạo curl, hoặc Docker. Hỗ trợ Claude, Codex, Cursor, Gemini và nhiều công cụ khác. Việc cài đặt CyberOS sẽ đưa thư mục `.cyberos/` độc lập vào kho mã của bạn. Thư mục này được gitignore — nó chứa engine quy trình, giao thức bộ nhớ, các file entry cho agent, và bộ chạy gate — nên không bao giờ làm ảnh hưởng đến mã nguồn được theo dõi của bạn. Một lệnh duy nhất xử lý mọi thứ: tự động phát hiện các lệnh build, lint và test, tạo khung `docs/tasks/BACKLOG.md`, ghi các file hướng dẫn cho từng agent, và ghi dấu file `VERSION` để bạn có thể kiểm tra sau này. Chạy lại trình cài đặt luôn an toàn: nó áp dụng các bản cập nhật và không bao giờ ghi đè lên các nhiệm vụ hiện có, `BACKLOG.md`, `AGENTS.md`, hay `gates.env` của bạn. ## Các kênh cài đặt Chọn kênh phù hợp với thiết lập của bạn. Tất cả các kênh đều tạo ra cùng một cấu trúc `.cyberos/`. | Kênh | Lệnh / điểm vào | Phù hợp nhất cho | | --------------------------- | ---------------------- | ------------------------- | | **npx CLI** | `npx cyberos install` | Hầu hết các kho mã | | **Claude plugin** | Lệnh `/install` | Người dùng Claude | | **MCP stdio** | Công cụ `task_install` | Các agent MCP | | **Docker image** | Docker image | CI / môi trường container | | **Git subtree / submodule** | `git subtree add` | Nâng cao / offline | | **Makefile target** | Target `make` | Dự án dùng Makefile | | **GitHub Action** | Bước trong workflow | Bộ chạy gate CI | | **`curl \| sh` bootstrap** | `curl \| sh` | Cài đặt từ xa một dòng | | **`create.sh` scaffolder** | `create.sh` | Thiết lập kho mẫu | *** ## Bề mặt CLI `npx cyberos` Điểm vào `npx cyberos ` cung cấp **tám** lệnh. Năm lệnh có lệnh slash Claude plugin tương ứng; ba lệnh (`create`, `gates`, `mcp`) chỉ có ở CLI. | Lệnh CLI | Lệnh slash | Chức năng | | ------------------------------ | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `npx cyberos install [repo]` | `/install` | Đưa `.cyberos/` vào repo, tự phát hiện lệnh gate, tạo khung `docs/tasks/BACKLOG.md`, ghi các file entry cho agent. Idempotent. | | `npx cyberos uninstall [repo]` | `/uninstall` | Gỡ thư mục `.cyberos/` đã cài. Không đụng đến mã nguồn hay nhiệm vụ của bạn. | | `npx cyberos version [repo]` | `/version` | Kiểm tra xem đã có phiên bản CyberOS mới hơn chưa. Nếu `.cyberos/VERSION` cũ, nó nhắc bạn chạy lại `install` để re-vendor. | | `npx cyberos status [repo]` | `/status` | Mở `docs/status/index.html` — chế độ xem board / table / releases của corpus nhiệm vụ — trong trình duyệt mặc định. | | `npx cyberos help` | `/help` | In bề mặt CLI, vòng đời nhiệm vụ, và vị trí mọi thứ trong repo đã cài. | | `npx cyberos create [dir]` | — | Tạo khung một repo **mới** đã sẵn CyberOS. Chỉ có ở CLI. | | `npx cyberos gates [repo]` | — | Chạy các gate máy (build, lint, test, coverage) cho repo đã cài. Cùng runner mà workflow dùng. Chỉ có ở CLI. | | `npx cyberos mcp` | — | Khởi chạy **MCP server** stdio để bất kỳ agent hỗ trợ MCP nào cũng có thể điều khiển workflow. Chỉ có ở CLI — xem [module MCP Gateway](/vi/modules/mcp-gateway) để biết chi tiết công cụ. | Không có lệnh `apply` hay `update`. Re-vendor luôn là `npx cyberos install` — an toàn khi chạy bất cứ lúc nào và không bao giờ ghi đè `BACKLOG.md`, nhiệm vụ, `AGENTS.md`, hay `gates.env` của bạn. Kiểm tra cập nhật mềm chạy tự động mỗi khi có bất kỳ thứ gì dưới `.cyberos/` được sử dụng. Với workflow nhiệm vụ, Claude plugin còn cung cấp thêm `/ship-tasks`, `/plan`, `/create-tasks` và `/improve`. Chúng chỉ có trong plugin — xem [Thiết lập Plugin](/vi/guides/plugin-setup). *** ## Cài đặt qua npx (khuyến nghị) Tại thư mục gốc của dự án, chạy: ```bash theme={null} npx cyberos install ``` CLI tự động phát hiện các lệnh build, lint và test, đưa `.cyberos/` vào kho mã của bạn, tạo khung `docs/tasks/BACKLOG.md`, và ghi các file entry cho agent. Xác nhận mọi thứ được kết nối đúng: ```bash theme={null} python -m cyberos doctor ``` Một cài đặt khỏe mạnh sẽ in ra `READY`. Nếu thiếu bất kỳ lệnh gate nào, đầu ra sẽ cho bạn biết chính xác dòng nào trong `gates.env` cần sửa. Xác nhận `.cyberos/` đã được tạo trong thư mục gốc kho mã: ```bash theme={null} ls -la .cyberos/ ``` Bạn sẽ thấy `cuo/`, `memory/`, `plugin/`, `AGENT-ENTRY.md`, `gates.env`, và `VERSION`. *** ## Cài đặt qua Claude plugin Trong Claude, vào **Settings → Plugins → Add** và chọn `dist/cyberos/cyberos.plugin` (file `.plugin`, không phải thư mục). Với Claude Code, chạy: ``` /plugin marketplace add /plugin install cyberos@cyberos ``` Mở một phiên trong kho mã của bạn và gõ: ``` /install ``` Plugin sẽ phát hiện thư mục gốc kho mã, chạy trình cài đặt và báo cáo những gì đã được ghi. Nếu plugin không thể tự động phát hiện một lệnh gate (build, lint, hoặc test), nó sẽ yêu cầu bạn xác nhận hoặc cung cấp lệnh đó. Xem lại kết quả và xác nhận để tiếp tục. Việc cài đặt hoàn tất trong vài giây. Cài đặt Claude plugin để mở khóa quy trình một lệnh `/ship-tasks` — cách nhanh nhất để đưa một nhiệm vụ từ `ready_to_implement` đến `done`. *** ## Những gì được cài đặt Mọi kênh đều tạo ra cùng cây thư mục `.cyberos/`: ``` .cyberos/ ├── cuo/ # Workflow engine │ ├── ship-tasks.md # Workflow doctrine │ ├── EXECUTION-DISCIPLINE.md # How agents behave │ ├── STATUS-REFERENCE.md # The 10 task states │ ├── gates/ │ │ └── run-gates.sh # Gate runner │ ├── skills/ # Bundled skills │ └── templates/ # Task scaffolding templates ├── memory/ │ ├── AGENTS.md # Layer-1 memory protocol │ └── store/ # Gitignored BRAIN store ├── plugin/ # Claude plugin commands + skills ├── AGENT-ENTRY.md # Full agent one-pager (any agent) ├── gates.env # Your repo's build/lint/test commands ├── manifest.yaml # Pack profile (reduced or full) └── VERSION # Installed CyberOS version ``` *** ## Những gì cài đặt KHÔNG đụng đến Việc cài đặt hoàn toàn mang tính bổ sung. Nó không bao giờ sửa đổi: * Mã nguồn hiện có của bạn * `BACKLOG.md` nếu đã tồn tại (nội dung được bảo toàn) * `gates.env` nếu đã được cấu hình (một bản sao lưu có dấu thời gian được tạo, sau đó nó được tạo lại) * `AGENTS.md` nếu đã tồn tại (chỉ nối thêm một lần duy nhất có đánh dấu) * Bất kỳ nhiệm vụ hiện có nào trong `docs/tasks/` Việc cài đặt là idempotent. Chạy lại `npx cyberos install` (hoặc `/install`) sẽ áp dụng các bản cập nhật CyberOS mới nhất cho `.cyberos/` nhưng không bao giờ đụng đến `BACKLOG.md`, các file nhiệm vụ, `AGENTS.md`, hay `gates.env` của bạn. Hãy sử dụng thoải mái để giữ kho mã luôn cập nhật. *** ## Cập nhật CyberOS Không có lệnh `update` hay `apply` riêng. Để nhận phiên bản CyberOS mới, chỉ cần chạy lại trình cài đặt — nó idempotent và bảo toàn nhiệm vụ, `BACKLOG.md`, `AGENTS.md` và `gates.env` của bạn. ```bash npx theme={null} # Kiểm tra xem đã có bản CyberOS mới hơn chưa npx cyberos version # Re-vendor .cyberos/ với payload mới nhất npx cyberos install ``` ```bash Claude plugin theme={null} /version /install ``` `/version` (hoặc `npx cyberos version`) in phiên bản đã cài và nhắc bạn chạy `install` nếu đã có bản mới hơn. Kiểm tra cập nhật mềm cũng chạy tự động khi có bất kỳ thứ gì dưới `.cyberos/` được sử dụng. *** ## Hỗ trợ đa agent CyberOS kết nối mọi agent chính trong một lần chạy cài đặt. Các file hướng dẫn cho từng agent và các thư mục kỹ năng gốc sẽ được tạo nếu chưa có — các file hiện có của bạn không bao giờ bị ghi đè. | Agent | File hướng dẫn | Thư mục kỹ năng gốc | | ------------ | --------------------------------- | ---------------------- | | Claude Code | `CLAUDE.md` | `.claude/skills/` | | Codex | `AGENTS.md` | `.codex/skills/` | | Cursor | `.cursorrules`, `.cursor/rules/` | — | | Gemini CLI | `GEMINI.md` | — | | Grok CLI | `.grok/GROK.md` | `.grok/skills/` | | Command Code | `AGENTS.md` | `.commandcode/skills/` | | OpenCode | `AGENTS.md` | `.opencode/skill/` | | Copilot | `.github/copilot-instructions.md` | — | | Windsurf | `.windsurfrules` | — | Bất kỳ agent nào được trỏ đến `AGENTS.md` hoặc `.cyberos/AGENT-ENTRY.md` đều thực thi cùng một quy trình, cùng các gate, và cùng các phán quyết bắt buộc của con người — không cần plugin.