Dùng Codex hiệu quả hơn — OMX lo phần prompt, workflow và runtime khi dự án phức tạp dần.

Website: https://yeachan-heo.github.io/oh-my-codex-website/ Tài liệu: Bắt đầu · Agent · Skill · Tích hợp · Demo · Hướng dẫn OpenClaw

OMX là lớp workflow mở rộng cho OpenAI Codex CLI.

Codex vẫn là engine chính, OMX giúp bạn:

• cấu hình Codex tốt hơn ngay từ phiên đầu tiên
• chạy workflow nhất quán từ làm rõ yêu cầu đến hoàn thành
• gọi các skill chính bằng $deep-interview, $ralplan, $team và $ultragoal
• lưu trữ hướng dẫn dự án, kế hoạch, log và trạng thái trong .omx/

Nếu bạn muốn trải nghiệm OMX nhanh nhất, bắt đầu từ đây:

Chọn một đường cài đặt. Nếu Codex CLI đã được cài sẵn (ví dụ bằng Homebrew):

codex --version
npm install -g oh-my-codex
omx setup
omx --madmax --high

Nếu Codex CLI chưa được cài và bạn muốn để npm quản lý:

npm install -g @openai/codex
npm install -g oh-my-codex
omx setup

Sau đó làm việc bình thường trong Codex:

$deep-interview "clarify the authentication change"
$ralplan "approve the auth plan and review tradeoffs"
$ultragoal "carry the approved plan to completion"
$team 3:executor "execute the approved plan in parallel"

Đó là flow chính. Khởi động OMX, làm rõ yêu cầu khi cần, duyệt kế hoạch, rồi chọn $team để chạy song song hoặc $ultragoal để theo dõi mục tiêu bền vững đến khi hoàn thành.

Dùng OMX nếu bạn đã quen Codex và muốn trải nghiệm tốt hơn:

• workflow chuẩn xoay quanh $deep-interview, $ralplan, $team và $ultragoal
• các role chuyên biệt và skill hỗ trợ cho từng loại task
• hướng dẫn dự án qua AGENTS.md theo scope
• lưu trạng thái lâu dài trong .omx/ — kế hoạch, log, memory và theo dõi mode

Nếu bạn chỉ muốn dùng Codex thuần mà không cần thêm workflow, thì có lẽ không cần OMX.

• Node.js 20+
• Codex CLI đã cài và kiểm tra bằng codex --version (Homebrew hoặc npm)
• Codex đã xác thực (auth)
• tmux trên macOS/Linux nếu muốn dùng team runtime
• psmux trên Windows nếu muốn dùng team mode

Khởi chạy OMX:

omx --madmax --high

Rồi thử workflow chính:

$deep-interview "clarify the authentication change"
$ralplan "approve the safest implementation path"
$ultragoal "carry the approved plan to completion"
$team 3:executor "execute the approved plan in parallel"

Dùng $team khi cần nhiều worker chạy song song, hoặc $ultragoal để theo dõi mục tiêu bền vững đến khi hoàn thành.

OMX không thay thế Codex.

OMX bổ sung một lớp hỗ trợ phía trên Codex:

• Codex vẫn làm toàn bộ việc thực thi
• Role của OMX giúp gọi nhanh các vai trò chuyên biệt
• Skill của OMX đóng gói các workflow phổ biến thành lệnh
• .omx/ lưu kế hoạch, log, memory và trạng thái runtime

Nói đơn giản: OMX giúp phân task đúng chỗ + workflow rõ ràng + runtime ổn định hơn — không phải một bảng điều khiển để gõ lệnh cả ngày.

1. Chạy omx setup
2. Khởi động với omx --madmax --high
3. Dùng $deep-interview "..." khi yêu cầu còn mơ hồ
4. Dùng $ralplan "..." để duyệt kế hoạch và cân nhắc trade-off
5. Chọn $team để chạy song song hoặc $ultragoal để theo dõi mục tiêu bền vững đến khi hoàn thành

1. $deep-interview — làm rõ scope khi yêu cầu còn mơ hồ.
2. $ralplan — chuyển scope đã rõ thành kế hoạch triển khai được duyệt.
3. $team hoặc $ultragoal — dùng $team khi cần nhiều worker song song, hoặc $ultragoal khi muốn theo dõi mục tiêu liên tục đến khi xong.

Các phần dưới đây hữu ích nhưng không phải là bước bắt đầu chính.

Dùng team runtime khi cần phối hợp nhiều worker qua tmux/worktree — đây không phải bước bắt đầu mặc định.

omx team 3:executor "fix the failing tests with verification"
omx team status <team-name>
omx team resume <team-name>
omx team shutdown <team-name>

Đây là các công cụ vận hành/hỗ trợ:

• omx setup cài prompt, skill, config và scaffold AGENTS
• omx doctor kiểm tra cài đặt khi có vấn đề
• omx hud --watch theo dõi trạng thái, không phải workflow chính
• Các mục máy chủ MCP: omx_state, omx_memory, omx_code_intel, omx_trace, omx_wiki (máy chủ wiki của repository), omx_hermes (cầu nối giới hạn cho trạng thái/điều phối phiên)

• omx sparkshell <command> chạy lệnh shell có kiểm soát output
• để tìm kiếm chỉ đọc trong repository, hãy dùng các công cụ/subagent kiểm tra repository thông thường của Codex (lệnh omx explore đã lỗi thời và bị gỡ bỏ)

Ví dụ:

omx sparkshell git status
omx sparkshell --tmux-pane %12 --tail-lines 400

omx team cần backend tương thích tmux:

Trên một số máy Intel Mac, khi khởi động OMX — đặc biệt với --madmax --high — CPU có thể tăng đột biến do macOS Gatekeeper xác thực nhiều tiến trình đồng thời.

Nếu gặp tình trạng này, thử:

• xattr -dr com.apple.quarantine $(which omx)
• Thêm ứng dụng terminal vào danh sách Developer Tools trong cài đặt Security của macOS
• Dùng cấu hình nhẹ hơn (bỏ --madmax --high)

• Bắt đầu
• Hướng dẫn demo
• Danh mục agent
• Tham chiếu skill
• Tích hợp
• Hướng dẫn OpenClaw / notification gateway
• Đóng góp
• Nhật ký thay đổi

• English
• 한국어
• 日本語
• 简体中文
• 繁體中文
• Tiếng Việt
• Español
• Português
• Русский
• Türkçe
• Deutsch
• Français
• Italiano
• Ελληνικά
• Polski
• Українська
• Bahasa Indonesia

MIT