Cài đặt

Yêu cầu trước

IDE hoặc CLI hỗ trợ AI — ít nhất một trong: Claude Code, Gemini CLI, Codex CLI, Qwen CLI, Antigravity IDE, Cursor, hoặc OpenCode
bun — Runtime JavaScript và trình quản lý gói (tự động cài đặt bởi script cài đặt nếu thiếu)
uv — Trình quản lý gói Python cho Serena MCP (tự động cài đặt nếu thiếu)

Phương pháp 1: Cài đặt một dòng lệnh (Khuyến nghị)

curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash

Script này:

Phát hiện nền tảng của bạn (macOS, Linux)
Kiểm tra bun và uv, cài đặt nếu thiếu
Chạy trình cài đặt tương tác với lựa chọn preset
Tạo .agents/ với các skill bạn đã chọn
Thiết lập tầng tích hợp .claude/ (hook, symlink, setting)
Cấu hình Serena MCP nếu được phát hiện

Thời gian cài đặt thông thường: dưới 60 giây.

Phương pháp 2: Cài đặt thủ công qua bunx

bunx oh-my-agent@latest

Lệnh này khởi chạy trình cài đặt tương tác mà không cần bootstrap phụ thuộc. Bạn cần đã cài bun sẵn.

Trình cài đặt yêu cầu bạn chọn preset, quyết định skill nào được cài:

Preset

Preset	Skill bao gồm
all	oma-brainstorm, oma-pm, oma-frontend, oma-backend, oma-db, oma-mobile, oma-design, oma-qa, oma-debug, oma-tf-infra, oma-dev-workflow, oma-translator, oma-orchestrator, oma-scm, oma-coordination
fullstack	oma-frontend, oma-backend, oma-db, oma-pm, oma-qa, oma-debug, oma-brainstorm, oma-scm
frontend	oma-frontend, oma-pm, oma-qa, oma-debug, oma-brainstorm, oma-scm
backend	oma-backend, oma-db, oma-pm, oma-qa, oma-debug, oma-brainstorm, oma-scm
mobile	oma-mobile, oma-pm, oma-qa, oma-debug, oma-brainstorm, oma-scm
devops	oma-tf-infra, oma-dev-workflow, oma-pm, oma-qa, oma-debug, oma-brainstorm, oma-scm

Mọi preset đều bao gồm oma-pm (lập kế hoạch), oma-qa (đánh giá), oma-debug (sửa lỗi), oma-brainstorm (khám phá ý tưởng) và oma-scm (git) làm agent cơ bản. Preset theo lĩnh vực bổ sung thêm các agent triển khai liên quan.

Tài nguyên dùng chung (_shared/) luôn được cài đặt bất kể preset. Bao gồm định tuyến cốt lõi, tải ngữ cảnh, cấu trúc prompt, phát hiện vendor, quy trình thực thi và giao thức bộ nhớ.

Những gì được tạo

Sau khi cài đặt, dự án của bạn sẽ chứa:

.agents/
├── config/
│   └── oma-config.yaml      # Tùy chọn của bạn
├── skills/
│   ├── _shared/                    # Tài nguyên dùng chung (luôn được cài)
│   │   ├── core/                   # skill-routing, context-loading, v.v.
│   │   ├── runtime/                # memory-protocol, execution-protocols/
│   │   └── conditional/            # quality-score, experiment-ledger, v.v.
│   ├── oma-frontend/               # Theo preset
│   │   ├── SKILL.md
│   │   └── resources/
│   └── ...                         # Các skill đã chọn khác
├── workflows/                      # Tất cả 16 định nghĩa workflow
├── agents/                         # Định nghĩa subagent
├── mcp.json                        # Cấu hình MCP server
├── results/plan-{sessionId}.json                       # Trống (được điền bởi /plan)
├── state/                          # Trống (dùng bởi workflow liên tục)
└── results/                        # Trống (được điền bởi các lần chạy agent)

.claude/
├── settings.json                   # Hook và quyền
├── hooks/
│   ├── triggers.json               # Ánh xạ từ khóa sang workflow (11 ngôn ngữ)
│   ├── keyword-detector.ts         # Logic phát hiện tự động
│   ├── persistent-mode.ts          # Áp dụng workflow liên tục
│   └── hud.ts                      # Chỉ báo thanh trạng thái [OMA]
├── skills/                         # Symlink → .agents/skills/
└── agents/                         # Định nghĩa subagent cho IDE

.serena/
└── memories/                       # Trạng thái runtime (được điền trong phiên làm việc)

Phương pháp 3: Cài đặt toàn cục

Để sử dụng ở mức CLI (dashboard, spawn agent, chẩn đoán), cài đặt oh-my-agent toàn cục:

Homebrew (macOS/Linux)

brew install oh-my-agent

npm / bun toàn cục

bun install --global oh-my-agent
# hoặc
npm install --global oh-my-agent

Lệnh này cài đặt lệnh oma toàn cục, cho bạn truy cập tất cả lệnh CLI từ bất kỳ thư mục nào:

oma doctor              # Kiểm tra sức khỏe
oma dashboard           # Giám sát terminal
oma dashboard:web       # Dashboard web tại http://localhost:9847
oma agent:spawn         # Spawn agent từ terminal
oma agent:parallel      # Thực thi agent song song
oma agent:status        # Kiểm tra trạng thái agent
oma stats               # Thống kê phiên làm việc
oma retro               # Phân tích hồi cứu
oma cleanup             # Dọn dẹp artifact phiên
oma update              # Cập nhật oh-my-agent
oma verify              # Xác minh đầu ra agent
oma visualize           # Trực quan hóa phụ thuộc
oma describe            # Mô tả cấu trúc dự án
oma bridge              # Bridge SSE-to-stdio cho Antigravity
oma memory:init         # Khởi tạo nhà cung cấp bộ nhớ
oma auth:status         # Kiểm tra trạng thái xác thực CLI
oma star                # Star repository

oma là viết tắt của oh-my-agent. Cả hai đều hoạt động như lệnh CLI.

Cài đặt công cụ AI CLI

Bạn cần ít nhất một công cụ AI CLI được cài đặt. oh-my-agent hỗ trợ bốn vendor, và bạn có thể kết hợp — sử dụng CLI khác nhau cho các agent khác nhau thông qua ánh xạ agent-CLI.

Gemini CLI

bun install --global @google/gemini-cli
# hoặc
npm install --global @google/gemini-cli

Xác thực tự động khi chạy lần đầu. Gemini CLI đọc skill từ .agents/skills/ theo mặc định.

Claude Code

curl -fsSL https://claude.ai/install.sh | bash
# hoặc
npm install --global @anthropic-ai/claude-code

Xác thực tự động khi chạy lần đầu. Claude Code sử dụng .claude/ cho hook và setting, với skill được symlink từ .agents/skills/.

Codex CLI

bun install --global @openai/codex
# hoặc
npm install --global @openai/codex

Sau khi cài, chạy codex login để xác thực.

Qwen CLI

bun install --global @qwen-code/qwen-code

Sau khi cài, chạy /auth trong CLI để xác thực.

oma-config.yaml

Lệnh oma install tạo .agents/oma-config.yaml. Đây là file cấu hình trung tâm cho toàn bộ hành vi oh-my-agent:

# Ngôn ngữ phản hồi cho tất cả agent và workflow
language: en

# Định dạng ngày dùng trong báo cáo và file bộ nhớ
date_format: "YYYY-MM-DD"

# Múi giờ cho timestamp
timezone: "UTC"

# Công cụ CLI mặc định cho spawn agent
# Tùy chọn: gemini, claude, codex, qwen
default_cli: gemini

# Ánh xạ CLI theo từng agent (ghi đè default_cli)
model_preset (per-agent overrides via `agents:`):
  frontend: claude       # Suy luận UI phức tạp
  backend: gemini        # Tạo API nhanh
  mobile: gemini
  db: gemini
  pm: gemini             # Phân tách nhanh
  qa: claude             # Đánh giá bảo mật kỹ lưỡng
  debug: claude          # Phân tích nguyên nhân gốc sâu
  design: claude
  tf-infra: gemini
  dev-workflow: gemini
  translator: claude
  orchestrator: gemini
  commit: gemini

Tham chiếu trường

Trường	Kiểu	Mặc định	Mô tả
`language`	string	`en`	Mã ngôn ngữ phản hồi. Tất cả đầu ra agent, thông báo workflow và báo cáo sử dụng ngôn ngữ này. Hỗ trợ 11 ngôn ngữ (en, ko, ja, zh, es, fr, de, pt, ru, nl, pl).
`date_format`	string	`YYYY-MM-DD`	Chuỗi định dạng ngày cho timestamp trong kế hoạch, file bộ nhớ và báo cáo.
`timezone`	string	`UTC`	Múi giờ cho tất cả timestamp. Sử dụng định danh múi giờ chuẩn (ví dụ: `Asia/Seoul`, `America/New_York`).
`default_cli`	string	`gemini`	CLI dự phòng khi không có ánh xạ agent cụ thể. Được dùng làm cấp 3 trong ưu tiên phân giải vendor.
`model_preset (per-agent overrides via` agents:`)`	map	(trống)	Ánh xạ ID agent đến vendor CLI cụ thể. Ưu tiên hơn `default_cli`.

Ưu tiên phân giải vendor

Khi spawn agent, vendor CLI được xác định theo thứ tự ưu tiên (cao nhất trước):

Flag --model truyền vào oma agent:spawn
Mục model_preset (per-agent overrides via agents:) cho agent cụ thể đó trong oma-config.yaml
Cài đặt default_cli trong oma-config.yaml
active_vendor trong cli-config.yaml (dự phòng cũ)
gemini (dự phòng cứng)

Xác minh: `oma doctor`

Sau khi cài đặt và thiết lập, xác minh mọi thứ hoạt động:

oma doctor

Lệnh này kiểm tra:

Tất cả công cụ CLI bắt buộc đã được cài đặt và có thể truy cập
Cấu hình MCP server hợp lệ
File skill tồn tại với frontmatter SKILL.md hợp lệ
Symlink trong .claude/skills/ trỏ đến đích hợp lệ
Hook được cấu hình đúng trong .claude/settings.json
Nhà cung cấp bộ nhớ có thể kết nối (Serena MCP)
oma-config.yaml là YAML hợp lệ với các trường bắt buộc

Nếu có vấn đề, oma doctor cho bạn biết chính xác cần sửa gì, kèm lệnh sao chép-dán.

Cập nhật

Cập nhật CLI

oma update

Lệnh này cập nhật CLI oh-my-agent toàn cục lên phiên bản mới nhất.

Cập nhật skill dự án

Skill và workflow trong dự án có thể được cập nhật qua GitHub Action (action/) cho cập nhật tự động, hoặc thủ công bằng cách chạy lại trình cài đặt:

bunx oh-my-agent@latest

Trình cài đặt phát hiện cài đặt hiện có và đề xuất cập nhật trong khi bảo toàn oma-config.yaml và mọi cấu hình tùy chỉnh.

Mở dự án trong AI IDE và bắt đầu sử dụng oh-my-agent. Skill được tự động phát hiện. Thử:

"Build a login form with email validation using Tailwind CSS"

Hoặc sử dụng lệnh workflow:

/plan authentication feature with JWT and refresh tokens

Xem Hướng dẫn sử dụng để biết ví dụ chi tiết, hoặc tìm hiểu về Agent để hiểu mỗi chuyên gia làm gì.

Yêu cầu trước​

Phương pháp 1: Cài đặt một dòng lệnh (Khuyến nghị)​

Phương pháp 2: Cài đặt thủ công qua bunx​

Preset​

Những gì được tạo​

Phương pháp 3: Cài đặt toàn cục​

Homebrew (macOS/Linux)​

npm / bun toàn cục​

Cài đặt công cụ AI CLI​

Gemini CLI​

Claude Code​

Codex CLI​

Qwen CLI​

oma-config.yaml​

Tham chiếu trường​

Ưu tiên phân giải vendor​

Xác minh: oma doctor​

Cập nhật​

Cập nhật CLI​

Cập nhật skill dự án​

Tiếp theo​