Tùy chọn CLI

Tùy chọn toàn cục

Các tùy chọn này có sẵn trên lệnh gốc oma / oh-my-agent:

Flag	Mô tả
`-V, --version`	Xuất số phiên bản và thoát
`-h, --help`	Hiển thị trợ giúp cho lệnh

Tất cả lệnh con cũng hỗ trợ -h, --help để hiển thị text trợ giúp riêng.

Tùy chọn đầu ra

Nhiều lệnh hỗ trợ đầu ra machine-readable cho pipeline CI/CD và tự động hóa. Có ba cách để yêu cầu đầu ra JSON, theo thứ tự ưu tiên:

1. Flag --json

oma stats --json
oma doctor --json
oma cleanup --json

Flag --json là cách đơn giản nhất để lấy đầu ra JSON. Có sẵn trên: doctor, stats, retro, cleanup, auth:status, memory:init, verify, visualize.

2. Flag --output

oma stats --output json
oma doctor --output text

Flag --output chấp nhận text hoặc json. Cung cấp cùng chức năng như --json nhưng cũng cho phép bạn yêu cầu tường minh đầu ra text (hữu ích khi biến môi trường đặt thành json nhưng bạn muốn text cho lệnh cụ thể).

Xác thực: Nếu cung cấp định dạng không hợp lệ, CLI báo lỗi: Invalid output format: {value}. Expected one of text, json.

3. Biến môi trường OH_MY_AG_OUTPUT_FORMAT

export OH_MY_AG_OUTPUT_FORMAT=json
oma stats    # xuất JSON
oma doctor   # xuất JSON
oma retro    # xuất JSON

Đặt biến môi trường này thành json để buộc đầu ra JSON trên tất cả lệnh hỗ trợ. Chỉ json được nhận dạng; giá trị khác bị bỏ qua và mặc định là text.

Thứ tự phân giải: Flag --json > flag --output > biến môi trường OH_MY_AG_OUTPUT_FORMAT > text (mặc định).

Lệnh hỗ trợ đầu ra JSON

Lệnh	`--json`	`--output`	Ghi chú
`doctor`	Có	Có	Bao gồm kiểm tra CLI, trạng thái MCP, trạng thái skill
`stats`	Có	Có	Đối tượng số liệu đầy đủ
`retro`	Có	Có	Snapshot với số liệu, tác giả, loại commit
`cleanup`	Có	Có	Danh sách item đã dọn
`auth:status`	Có	Có	Trạng thái xác thực theo CLI
`memory:init`	Có	Có	Kết quả khởi tạo
`verify`	Có	Có	Kết quả xác minh theo từng kiểm tra
`visualize`	Có	Có	Đồ thị phụ thuộc dạng JSON
`describe`	Luôn JSON	N/A	Luôn xuất JSON (lệnh introspection)

Tùy chọn theo lệnh

update

oma update [-f | --force] [--ci]

Flag	Viết tắt	Mô tả	Mặc định
`--force`	`-f`	Ghi đè file config tùy chỉnh khi cập nhật. Ảnh hưởng: `oma-config.yaml`, `mcp.json`, thư mục `stack/`. Không có flag này, các file được sao lưu trước khi cập nhật và khôi phục sau.	`false`
`--ci`		Chạy ở chế độ CI không tương tác. Bỏ qua tất cả prompt xác nhận, dùng đầu ra console thuần thay vì spinner và animation. Cần thiết cho pipeline CI/CD khi stdin không có sẵn.	`false`

Hành vi với --force:

oma-config.yaml được thay thế bằng mặc định registry.
mcp.json được thay thế bằng mặc định registry.
Thư mục stack/ backend (tài nguyên theo ngôn ngữ) được thay thế.
Tất cả file khác luôn được cập nhật bất kể flag này.

Hành vi với --ci:

Không console.clear() khi bắt đầu.
@clack/prompts được thay bằng console.log thuần.
Prompt phát hiện đối thủ bị bỏ qua.
Lỗi throw thay vì gọi process.exit(1).

stats

oma stats [--json] [--output <format>] [--reset]

Flag	Mô tả	Mặc định
`--reset`	Đặt lại tất cả dữ liệu số liệu. Xóa `.serena/metrics.json` và tạo lại với giá trị trống.	`false`

retro

oma retro [window] [--json] [--output <format>] [--interactive] [--compare]

Flag	Mô tả	Mặc định
`--interactive`	Chế độ tương tác với nhập liệu thủ công. Yêu cầu ngữ cảnh bổ sung không thể thu thập từ git (ví dụ: tâm trạng, sự kiện đáng chú ý).	`false`
`--compare`	So sánh khoảng thời gian hiện tại với khoảng trước đó cùng độ dài. Hiển thị số liệu delta (ví dụ: commit +12, dòng thêm -340).	`false`

Định dạng đối số window:

7d — 7 ngày
2w — 2 tuần
1m — 1 tháng
Bỏ qua cho mặc định (7 ngày)

cleanup

oma cleanup [--dry-run] [-y | --yes] [--json] [--output <format>]

Flag	Viết tắt	Mô tả	Mặc định
`--dry-run`		Chế độ xem trước. Liệt kê tất cả item sẽ được dọn nhưng không thay đổi. Exit code 0 bất kể kết quả.	`false`
`--yes`	`-y`	Bỏ qua tất cả prompt xác nhận. Dọn mọi thứ không hỏi. Hữu ích trong script và CI.	`false`

Dọn dẹp:

File PID mồ côi: /tmp/subagent-*.pid khi tiến trình tham chiếu không còn chạy.
File log mồ côi: /tmp/subagent-*.log khớp PID chết.
Thư mục Gemini Antigravity: .gemini/antigravity/brain/, .gemini/antigravity/implicit/, .gemini/antigravity/knowledge/ — tích lũy trạng thái theo thời gian và có thể phình to.

agent:spawn

oma agent:spawn <agent-id> <prompt> <session-id> [-m <vendor>] [-w <workspace>]

Flag	Viết tắt	Mô tả	Mặc định
`--model`	`-m`	Ghi đè vendor CLI. Phải là một trong: `gemini`, `claude`, `codex`, `qwen`. Ghi đè tất cả phân giải vendor từ config.	Phân giải từ config
`--workspace`	`-w`	Thư mục làm việc cho agent. Nếu bỏ qua hoặc đặt thành `.`, CLI tự phát hiện workspace từ file cấu hình monorepo (pnpm-workspace.yaml, package.json, lerna.json, nx.json, turbo.json, mise.toml).	Tự phát hiện hoặc `.`

Xác thực:

agent-id phải là một trong: backend, frontend, mobile, qa, debug, pm.
session-id không được chứa .., ?, #, % hoặc ký tự điều khiển.
vendor phải là một trong: gemini, claude, codex, qwen.

Hành vi đặc thù vendor:

Vendor	Lệnh	Flag tự động duyệt	Flag prompt
gemini	`gemini`	`--approval-mode=yolo`	`-p`
claude	`claude`	(không)	`-p`
codex	`codex`	`--full-auto`	(không — prompt là positional)
qwen	`qwen`	`--yolo`	`-p`

Các mặc định này có thể ghi đè trong .agents/skills/oma-orchestrator/config/cli-config.yaml.

agent:status

oma agent:status <session-id> [agent-ids...] [-r <root>]

Flag	Viết tắt	Mô tả	Mặc định
`--root`	`-r`	Đường dẫn gốc để tìm file bộ nhớ (`.serena/memories/result-{agent}.md`) và file PID.	Thư mục làm việc hiện tại

Logic xác định trạng thái:

Nếu .serena/memories/result-{agent}.md tồn tại: đọc header ## Status:. Nếu không có header, báo completed.
Nếu file PID tồn tại tại /tmp/subagent-{session-id}-{agent}.pid: kiểm tra PID còn sống. Báo running nếu sống, crashed nếu chết.
Nếu không tìm thấy file nào: báo crashed.

agent:parallel

oma agent:parallel [tasks...] [-m <vendor>] [-i | --inline] [--no-wait]

Flag	Viết tắt	Mô tả	Mặc định
`--model`	`-m`	Ghi đè vendor CLI áp dụng cho tất cả agent được spawn.	Phân giải theo agent từ config
`--inline`	`-i`	Diễn giải đối số task dạng chuỗi `agent:task[:workspace]` thay vì đường dẫn file.	`false`
`--no-wait`		Chế độ nền. Khởi động tất cả agent và trả về ngay không đợi hoàn thành. Danh sách PID và log được lưu vào `.agents/results/parallel-{timestamp}/`.	`false` (đợi hoàn thành)

Định dạng task inline: agent:task hoặc agent:task:workspace

Workspace được phát hiện bằng cách kiểm tra phần tách bởi dấu hai chấm cuối cùng bắt đầu bằng ./, / hoặc bằng ..
Ví dụ: backend:Implement auth API:./api -- agent=backend, task="Implement auth API", workspace=./api.
Ví dụ: frontend:Build login page -- agent=frontend, task="Build login page", workspace=tự phát hiện.

Định dạng file YAML task:

tasks:
  - agent: backend
    task: "Implement user API"
    workspace: ./api           # tùy chọn
  - agent: frontend
    task: "Build user dashboard"

memory:init

oma memory:init [--json] [--output <format>] [--force]

Flag	Mô tả	Mặc định
`--force`	Ghi đè file schema trống hoặc hiện có trong `.serena/memories/`. Không có flag này, file hiện có không bị thay đổi.	`false`

verify

oma verify <agent-type> [-w <workspace>] [--json] [--output <format>]

Flag	Viết tắt	Mô tả	Mặc định
`--workspace`	`-w`	Đường dẫn thư mục workspace cần xác minh.	Thư mục làm việc hiện tại

Loại agent: backend, frontend, mobile, qa, debug, pm.

Ví dụ thực tế

Pipeline CI: Cập nhật và xác minh

# Cập nhật ở chế độ CI, sau đó chạy doctor để xác minh cài đặt
oma update --ci
oma doctor --json | jq '.healthy'

Thu thập số liệu tự động

# Thu thập số liệu dạng JSON và pipe đến hệ thống giám sát
export OH_MY_AG_OUTPUT_FORMAT=json
oma stats | curl -X POST -H "Content-Type: application/json" -d @- https://metrics.example.com/api/v1/push

Thực thi agent hàng loạt với giám sát trạng thái

# Khởi động agent ở nền
oma agent:parallel tasks.yaml --no-wait

# Kiểm tra trạng thái định kỳ
SESSION_ID="session-$(date +%Y%m%d-%H%M%S)"
watch -n 5 "oma agent:status $SESSION_ID backend frontend mobile"

Dọn dẹp trong CI sau test

# Dọn tất cả tiến trình mồ côi không hỏi
oma cleanup --yes --json

Xác minh nhận biết workspace

# Xác minh mỗi domain trong workspace của nó
oma verify backend -w ./apps/api
oma verify frontend -w ./apps/web
oma verify mobile -w ./apps/mobile

Retro so sánh cho đánh giá sprint

# Retro sprint 2 tuần với so sánh sprint trước
oma retro 2w --compare

# Lưu dạng JSON cho báo cáo sprint
oma retro 2w --json > sprint-retro-$(date +%Y%m%d).json

Script kiểm tra sức khỏe đầy đủ

#!/bin/bash
set -e

echo "=== Kiểm tra sức khỏe oh-my-agent ==="

# Kiểm tra cài đặt CLI
oma doctor --json | jq -r '.clis[] | "\(.name): \(if .installed then "OK (\(.version))" else "MISSING" end)"'

# Kiểm tra trạng thái xác thực
oma auth:status --json | jq -r '.[] | "\(.name): \(.status)"'

# Kiểm tra số liệu
oma stats --json | jq -r '"Sessions: \(.sessions), Tasks: \(.tasksCompleted)"'

echo "=== Hoàn tất ==="

Describe cho introspection agent

# AI agent có thể khám phá lệnh có sẵn
oma describe | jq '.command.subcommands[] | {name, description}'

# Lấy chi tiết về lệnh cụ thể
oma describe agent:spawn | jq '.command.options[] | {flags, description}'

Tùy chọn toàn cục​

Tùy chọn đầu ra​

1. Flag --json​

2. Flag --output​

3. Biến môi trường OH_MY_AG_OUTPUT_FORMAT​

Lệnh hỗ trợ đầu ra JSON​

Tùy chọn theo lệnh​

update​

stats​

retro​

cleanup​

agent:spawn​

agent:status​

agent:parallel​

memory:init​

verify​

Ví dụ thực tế​

Pipeline CI: Cập nhật và xác minh​

Thu thập số liệu tự động​

Thực thi agent hàng loạt với giám sát trạng thái​

Dọn dẹp trong CI sau test​

Xác minh nhận biết workspace​

Retro so sánh cho đánh giá sprint​

Script kiểm tra sức khỏe đầy đủ​

Describe cho introspection agent​