omp AI Coding Agent: CLI coding trong terminal
omp AI Coding Agent là agent coding chạy trong terminal, được fork từ Pi, bổ sung chỉnh sửa theo hash, refactor nối với LSP và một trình gỡ lỗi thực sự vào bộ công cụ. Nên dùng nếu bạn làm việc chủ yếu trong terminal và muốn một CLI duy nhất định tuyến qua hơn 60 nhà cung cấp LLM; bỏ qua nếu bạn cần một công cụ thiên về giao diện đồ họa hoặc không muốn tự quản lý thông tin xác thực nhà cung cấp.
Giới thiệu omp AI Coding Agent
omp AI Coding Agent là agent coding chạy dòng lệnh, phân phối dưới dạng binary `omp`, được fork từ dự án Pi của Mario Zechner và xây lại bộ công cụ xoay quanh việc chỉnh sửa file theo hash, một client LSP chạy trong tiến trình, và một trình gỡ lỗi DAP gốc. Theo README, nó đi kèm 31 công cụ dựng sẵn và định tuyến yêu cầu qua hơn 60 nhà cung cấp LLM chỉ trong một phiên terminal.
Năng lực và tích hợp cốt lõi
- ✓Chỉnh sửa hashline: công cụ `edit` trỏ vào các neo theo hash nội dung thay vì gõ lại toàn bộ dòng, và một neo lỗi thời sẽ bị từ chối trước khi làm hỏng file — README ghi nhận cách này giúp giảm 61% token đầu ra trên Grok 4 Fast.
- ✓LSP được nối vào mọi lần ghi: đổi tên đi qua `workspace/willRenameFiles`, nên các re-export và import bí danh được cập nhật trước khi file di chuyển, trong số 14 lsp ops mà README liệt kê.
- ✓Điều khiển trình gỡ lỗi thực sự: công cụ `debug` chạy trực tiếp phiên DAP — gắn lldb vào một binary C bị segfault hay dlv vào một dịch vụ Go bị treo — trong số 28 dap ops mà README liệt kê.
- ✓Kernel Python và Bun thường trực: công cụ `eval` giữ một worker Python và một worker JS sống trong cùng phiên, cả hai đều gọi ngược được vào `read`, `grep`, hay `task`.
- ✓Subagent hạng nhất: `task` phân việc ra các worktree cách ly và trả về một object đã xác thực theo schema thay vì văn xuôi mà agent cha phải tự phân tích.
- ✓Các lược đồ URL nội bộ: README liệt kê 16 lược đồ — `pr://`, `issue://`, `agent://`, `skill://`, `ssh://` và nhiều hơn — nên `read pr://1428` trả về cùng cấu trúc như đọc một file cục bộ.
- ✓Coreutils chạy trong tiến trình: ripgrep, glob và find được liên kết thẳng vào binary, còn `bash` đi kèm 46 coreutils dựng sẵn chạy trong tiến trình, nên không tốn vòng fork-exec và không thiếu binary trên Windows.
- ✓Chế độ editor qua ACP: chạy bên trong Zed cho bạn cùng một agent, đọc đúng buffer bạn đang xem và ghi thay đổi qua đường lưu file của editor.
Cài đặt và thiết lập
Việc cài đặt được ghi rõ cho bốn nền tảng. Trên macOS và Linux, `curl -fsSL https://omp.sh/install | sh` tải về binary; người dùng Alpine/musl cần chạy `apk add libstdc++ libgcc` trước, vì binary musl dựng sẵn liên kết động tới hai thư viện này. Người dùng Homebrew chạy `brew install can1357/tap/omp`. README gọi đường cài qua Bun là lựa chọn khuyến nghị: `bun install -g @oh-my-pi/pi-coding-agent`, cần bun >= 1.3.14. Windows cài qua PowerShell với `irm https://omp.sh/install.ps1 | iex`. Muốn ghim phiên bản thì dùng mise: `mise use -g github:can1357/oh-my-pi`. Các completion cho bash, zsh và fish được sinh trực tiếp từ metadata CLI đang chạy, nên `eval "$(omp completions zsh)"` không bao giờ lệch khỏi các lệnh thật.
Điều khiển Agent: lệnh và tùy chỉnh
Việc định tuyến model đi qua mười vai trò — default, smol, slow, plan, commit, vision, designer, task, advisor và tiny — nên một model rẻ có thể xử lý việc phân tán subagent trong khi một model mạnh hơn nhận lượt chính. `--smol`, `--slow` và `--plan` ghi đè vai trò khi khởi chạy; `Ctrl+P` xoay vòng các model đã cấu hình cho vai trò đang dùng, còn `/model` đổi model ngay giữa phiên. Các lệnh slash thay đổi cách cả phiên vận hành: `/vibe` biến agent thành một đạo diễn điều khiển các phiên worker fast/good thường trực với bộ công cụ chỉ đọc, còn `/fresh` reset luồng nhà cung cấp bị kẹt mà không đụng đến transcript. Ba từ khóa kích hoạt viết thường — `ultrathink`, `orchestrate`, `workflowz` — đưa một lượt vào chế độ suy luận sâu hơn hoặc chạy đa subagent khi được gõ trong văn xuôi.
Ưu điểm trong cách tiếp cận của omp
- ✓Neo hashline cùng bộ công cụ được tinh chỉnh mang lại kết quả cụ thể mà README ghi bằng số liệu — Grok Code Fast 1 tăng từ 6,7% lên 68,3% trên một benchmark, còn Grok 4 Fast dùng ít hơn 61% token đầu ra.
- ✓Tích hợp LSP và DAP thực sự nghĩa là đổi tên và gỡ lỗi đi qua đúng giao thức mà editor của bạn dùng, chứ không phải một phép đoán bằng regex.
- ✓Hơn 60 nhà cung cấp và mười vai trò định tuyến cho phép ghim một model rẻ vào việc phân tán subagent và một model mạnh vào lượt chính mà không phải đổi cách làm việc.
- ✓Nó đọc trực tiếp tám định dạng cấu hình có sẵn — Cursor MDC, Cline .clinerules, Codex AGENTS.md, Copilot applyTo, và một số định dạng khác — nên các quy tắc agent mà team đã viết vẫn chạy được mà không cần script chuyển đổi.
- ✓PR hiện đang mở cho tất cả mọi người theo ghi chú trong README, nên rào cản để đóng góp lúc này thấp hơn.
Những điều cần cân nhắc
- △Đây là bản fork được duy trì dưới namespace của một contributor (can1357), không phải dự án Pi gốc — điều đáng biết trước khi bạn gắn cấu hình hay quy trình làm việc lâu dài vào nó.
- △Các con số benchmark trong README là so sánh nội bộ của chính dự án, chưa phải kết quả được bên thứ ba tái lập độc lập.
- △Một phần đáng kể bề mặt công cụ — github, security_scan, generate_image, tts, checkpoint, rewind và các công cụ memory — mặc định tắt và cần bật cấu hình rõ ràng trước khi dùng được.
- △Chính sách PR được README nói rõ là tạm thời: yêu cầu vouch trước đây 'có thể quay lại' tùy vào kết quả đóng góp mở, nên rào cản đóng góp có thể siết lại.
So sánh với các AI agent khác
Câu hỏi thường gặp
omp AI Coding Agent được phát hành theo giấy phép MIT, theo metadata kho GitHub của dự án.
omp AI Coding Agent định tuyến qua hơn 60 nhà cung cấp theo README, gồm Anthropic, OpenAI, OpenAI Codex, Google Gemini, Google Vertex, xAI, DeepSeek, Mistral và Groq, cùng các gói coding-plan như Cursor và GitHub Copilot, và runtime cục bộ như Ollama và vLLM.
omp AI Coding Agent tích hợp với Zed qua ACP (Agent Client Protocol), chạy cùng một agent bên trong editor — đọc đúng buffer bạn đang xem và ghi qua đường lưu file của editor thay vì một plugin riêng.
omp AI Coding Agent hỗ trợ các runtime model cục bộ gồm Ollama, LM Studio, llama.cpp và vLLM, cùng các endpoint tương thích OpenAI tự khai báo trong `~/.omp/agent/models.yml`.
omp AI Coding Agent chạy các kernel Python và Bun thường trực qua công cụ `eval` để thực thi code, còn công cụ `debug` chạy phiên DAP thật — gắn các trình gỡ lỗi như lldb, dlv, hay debugpy — trong số 28 dap ops mà README liệt kê.
omp AI Coding Agent cài được trên macOS, Linux và Windows theo hướng dẫn cài đặt trong README, với coreutils chạy trong tiến trình nên không cần cầu nối WSL trên Windows.
Vấn đề mà nó giải quyết
Phần lớn agent coding chạy trong terminal khóa bạn vào một nhà cung cấp model duy nhất, hoặc gắn thêm công cụ gọi ra binary hệ thống — ripgrep, grep, find — vốn có thể không tồn tại trên máy, và mỗi lần gọi tốn một vòng fork-exec. Đổi tên thường chỉ là thay chuỗi mù quáng thay vì đi qua giao thức mà editor của bạn đã biết, còn gỡ lỗi vẫn phải nhờ model chèn print vì không có trình gỡ lỗi thật trong vòng lặp. omp giải quyết cả ba điểm nghẽn này. Cách của omp AI Coding Agent là liên kết ripgrep, glob và find ngay trong tiến trình, nối đổi tên qua `workspace/willRenameFiles`, và trao cho agent một trình gỡ lỗi DAP mà nó thực sự điều khiển được.
Trường hợp sử dụng tốt nhất
- •Refactor xuyên codebase khi việc đổi tên cần cập nhật cả re-export và import bí danh, chứ không chỉ ký hiệu literal.
- •Gỡ lỗi một crash hay treo trong ngôn ngữ biên dịch hoặc thông dịch bằng cách gắn trình gỡ lỗi thực sự thay vì chèn thêm print.
- •Chạy một phiên coding với model tự host hoặc cục bộ — Ollama, LM Studio, llama.cpp, hoặc vLLM — thay vì gọi API được lưu trữ.
- •Review một branch hoặc các thay đổi chưa commit bằng `/review` để nhận verdict xếp hạng P0–P3 trước khi merge.
- •Tách một working tree lộn xộn thành các commit atomic, theo đúng thứ tự phụ thuộc, bằng `omp commit`.
Nên dùng — và nên bỏ qua
Chọn omp AI Coding Agent nếu bạn đã quen làm việc trong terminal, muốn định tuyến các nhà cung cấp LLM khác nhau cho từng vai trò (một model rẻ cho việc phân tán subagent, một model mạnh cho lượt chính), và cần đổi tên qua LSP thật hay gỡ lỗi qua DAP thật thay vì một cửa sổ chat gắn thêm vào shell. Bỏ qua nếu bạn muốn một công cụ thiên về giao diện đồ họa, một nhà cung cấp cố định không cần cấu hình gì, hoặc bạn không muốn tự quản lý `~/.omp/agent/models.yml` và thông tin xác thực nhà cung cấp.