Tóm tắt nhanh: Mình dùng Mise để tạo ba lệnh riêng:
pi-dev(Pi gốc với vài extension),pi-ak(Pi kèm AgentKit) vàpi-omp(Oh-my-pi kèm AgentKit). Mỗi lệnh có thư mục thiết lập, đăng nhập và phiên riêng, nên thử một runtime không làm hỏng runtime bạn dùng hằng ngày. Cách nhanh nhất là Pi Profile Manager, bài cũng có đường cài tay. Bạn không cần cài cả ba.
Mình dựng ba profile này vì muốn thử Oh-my-pi và AgentKit mà vẫn giữ nguyên bản Pi đang dùng mỗi ngày. Trước đó, mọi thứ nằm chung trong $HOME/.pi/agent, nên một lần cài gói hay đổi thiết lập là ảnh hưởng luôn môi trường làm việc chính.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%. Với Oh-my-pi, mình là người nghiên cứu độc lập, không có quan hệ thương mại. Pi Profile Manager là repo của mình.
pi-dev → Pi gốc + vài extension chọn lọc, không cần AgentKit
pi-ak → Pi gốc + AgentKit Engineer + vài extension chọn lọc
pi-omp → Oh-my-pi + AgentKit EngineerChọn pi-dev nếu bạn chỉ cần Pi và extension. Chọn pi-ak hoặc pi-omp khi bạn đã có quyền dùng AgentKit Engineer Kit. Các lệnh bọc (wrapper) gọi thẳng runtime qua Mise.
Mốc cài đặt của mình ngày 23/08/2026 trên macOS Apple Silicon: Pi
0.84.2, Oh-my-pi17.4.0, Mise2026.8.3, Node24.16.0(npm11.13.0), AgentKit CLI bản beta lúc đó, AgentKit Engineer kênhbetacho đíchpivàomp. Lúc rà soát tháng 10/2026, series Inside OMP đã chạy trên OMP 18.x. Các lệnh dưới ghi phiên bản thành biến để bạn thay bằng bản mình muốn pin.
Trước khi bắt đầu: Pi và Oh-my-pi là gì
Pi và Oh-my-pi (OMP) là hai harness agent khác nhau chạy trong terminal. Chúng không phải model AI. Harness đứng giữa bạn và model: gom ngữ cảnh, cung cấp tool, chạy các lời gọi tool và lưu phiên.
Yêu cầu → harness → model → lời gọi tool → kết quả → phiênPi gốc: lõi nhỏ, tự chọn thành phần
Pi là harness agent theo hướng tối giản và mở rộng được. Lõi cung cấp vòng lặp viết code và các tool cơ bản. Extension, skill, mẫu prompt, giao diện và gói Pi được lắp thêm theo nhu cầu.
Pi hợp với bạn nếu:
- Muốn ở gần bản gốc và tự chọn từng extension.
- Ưu tiên cài đặt gọn, dễ biết khả năng nào đến từ gói nào.
- Muốn dùng Pi độc lập (
pi-dev) hoặc kèm AgentKit (pi-ak).
Đổi lại, bạn phải tự chọn, pin phiên bản và kiểm tra độ tương thích của các extension.
Oh-my-pi: bản fork có sẵn nhiều khả năng
Oh-my-pi là một bản fork độc lập của Pi, theo hướng "có sẵn đủ thứ". OMP tích hợp sẵn nhiều khả năng phục vụ viết code như LSP (Language Server Protocol), trình gỡ lỗi, trình duyệt và subagent, thay vì để bạn tự lắp từng phần.
OMP hợp với bạn nếu:
- Muốn một harness viết code có nhiều khả năng tích hợp sẵn.
- Muốn trải nghiệm gần IDE hơn ngay trong terminal.
- Chấp nhận phạm vi lớn hơn và nhịp phát hành riêng của một bản fork.
Trong bài này, pi-omp ghép OMP với AgentKit. OMP không phải extension cài vào Pi, và omp không phải một chế độ khác của lệnh pi:
| Pi gốc | Oh-my-pi | |
|---|---|---|
| Lệnh chạy | pi | omp |
| Hướng tiếp cận | Lõi nhỏ, tự lắp extension | Bản fork có sẵn nhiều khả năng |
| Trạng thái người dùng trong bài | $HOME/.pi/profiles/... | $HOME/.omp/profiles/... |
| Profile tương ứng | pi-dev, pi-ak | pi-omp |
Hai công cụ có chung nguồn gốc và một số khái niệm, nhưng có CLI, cấu hình, bản phát hành và độ tương thích riêng. Đừng mặc định rằng một extension của Pi sẽ chạy trên OMP nếu tác giả extension không nói có hỗ trợ.
Các lớp còn lại trong cách dựng này
Extension thêm tool hoặc giao diện cho harness. AgentKit thêm bộ skill, định nghĩa agent, quy tắc và phần tích hợp với runtime theo cấu trúc sẵn. Mise đứng ở lớp ngoài cùng để chọn đúng môi trường trước khi Pi hoặc OMP khởi động:
pi-dev / pi-ak / pi-omp
↓
môi trường Mise
↓
Pi hoặc OMP
↓
thư mục profile riêngVì sao cần nhiều profile
Nếu mọi thứ nằm chung trong $HOME/.pi/agent mặc định, một lần cài gói, đổi thiết lập hay thử AgentKit có thể ảnh hưởng luôn môi trường dùng hằng ngày. Profile cho mỗi cách dựng một thư mục riêng ở cấp người dùng, nhờ đó bạn thử hoặc nâng cấp một runtime mà không ghi đè runtime còn lại.
Nên chọn profile nào
| Nhu cầu | Profile nên dùng |
|---|---|
| Muốn Pi gọn, có vài extension, không dùng AgentKit | pi-dev |
| Muốn Pi kèm Engineer Kit và các quy trình của AgentKit | pi-ak |
| Muốn dùng Oh-my-pi kèm Engineer Kit | pi-omp |
Nếu chưa dùng AgentKit, bắt đầu với pi-dev. Nếu đã dùng AgentKit, chọn pi-ak để giữ trải nghiệm Pi gốc, hoặc pi-omp để dùng OMP với nhiều khả năng có sẵn hơn. Không cần giữ cả ba profile nếu bạn không dùng tới.
Profile tách được gì
| Tách theo profile | Vẫn dùng chung |
|---|---|
| Thiết lập, gói, extension, skill | Cây mã nguồn và Git index |
| Trạng thái đăng nhập, nếu bạn đăng nhập riêng | Quyền hệ thống file và mạng của tiến trình |
| Lịch sử phiên | Cổng, Docker, cơ sở dữ liệu và bộ nhớ đệm |
| Tài nguyên agent và runtime ở cấp người dùng | .pi, .omp, .agents, AGENTS.md trong dự án |
Vì vậy, profile không phải sandbox cho tiến trình, cũng không tách không gian làm việc. Nếu chạy nhiều agent cùng sửa code, bạn vẫn cần Git worktree và đặt tên riêng cho cổng, cơ sở dữ liệu hoặc dự án Docker.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "Chạy Pi và Oh-my-pi (OMP) song song bằng ba profile tách biệt với Mise" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "pi-agent-profiles-with-mise". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 23/08/2026
- Giấy phép
- Subscriber-only; redistribution prohibited
- Slug
- pi-agent-profiles-with-mise
