# pi-mono: Bộ Công Cụ Tối Thượng Để Build AI Agent Trong Năm 2026 🚀
Bạn đang muốn tự build một AI Agent riêng nhưng không biết bắt đầu từ đâu? Hay bạn đã chán ngấy việc phải switch giữa 10 công cụ khác nhau để làm việc với LLM?
Mình vừa phát hiện ra **pi-mono** - một bộ toolkit đang làm mưa làm gió trong cộng đồng AI developers. Với hơn **126 releases**, **95 contributors** và đang trending mạnh trên GitHub, đây chính xác là thứ mà dân dev chúng ta đang cần! 🔥

📌 pi-mono Là Gì? Tại Sao Nên Quan Tâm?
pi-mono là một monorepo chứa bộ công cụ hoàn chỉnh để build AI agents. Được phát triển bởi Mario Zechner (badlogic) và cộng đồng, nó bao gồm:
| Package | Chức năng |
|---|---|
@mariozechner/pi-ai |
Unified LLM API - một API để gọi tất cả |
@mariozechner/pi-agent-core |
Core agent framework |
@mariozechner/pi-coding-agent |
CLI coding agent chạy trên terminal |
@mariozechner/pi-tui |
Text User Interface library |
@mariozechner/pi-web-ui |
Web UI components |
@mariozechner/pi-mom |
Message broker system |
@mariozechner/pi-pods |
vLLM pods deployment |
Điều đặc biệt? Tất cả đều open-source với MIT License và được thiết kế để hoạt động cùng nhau một cách mượt mà!
🔥 15+ LLM Providers, Hàng Trăm Models - Một API Thống Nhất
Đây là tính năng khiến mình "wow" ngay từ đầu. pi-mono hỗ trợ:
- Anthropic (Claude)
- OpenAI (GPT-4, GPT-4 Turbo)
- Google (Gemini)
- Azure OpenAI
- AWS Bedrock
- Mistral AI
- Groq
- Cerebras
- xAI (Grok)
- OpenRouter
- Ollama (local models)
- Và còn nhiều hơn nữa...

Cách switch model giữa chừng session:
/model # Mở menu chọn model
Ctrl+L # Quick switch
Ctrl+P # Cycle qua danh sách favorites
Bạn cũng có thể thêm custom providers và models qua file models.json hoặc viết extensions riêng!
💡 4 Chế Độ Hoạt Động - Linh Hoạt Tối Đa
pi-mono được thiết kế theo triết lý "Primitives, not features" - tức là cung cấp các building blocks để bạn tự xây thay vì ép bạn dùng theo một flow cứng nhắc.
1. Interactive Mode 🖥️
Full TUI experience - bạn có thể chat, code, và xem kết quả trực tiếp trong terminal.
2. Print/JSON Mode 📄
Perfect cho scripts và automation:
pi -p "Fix bug in this file" # Print mode
pi --mode json "Query" # JSON event streams
3. RPC Mode 🔌
JSON protocol qua stdin/stdout - dành cho tích hợp với các ứng dụng non-Node.
4. SDK Mode 📦
Embed pi trực tiếp vào app của bạn. Check out clawdbot để xem real-world example!
🌳 Tree-Structured History - Game Changer Thực Sự
Một trong những tính năng mình thích nhất là tree-structured sessions:
- Sessions được lưu dạng cây thay vì linear
- Dùng
/treeđể navigate đến bất kỳ điểm nào trong lịch sử - Branching: Quay lại điểm cũ và thử approach khác mà không mất context
- Tất cả branches nằm trong một file duy nhất

Export & Share:
/export # Export ra HTML
/share # Upload lên GitHub gist, nhận URL shareable
🧠 Context Engineering - Kiểm Soát Hoàn Toàn
pi-mono cho phép bạn làm actual context engineering thay vì chỉ dùng những gì framework cho sẵn:
AGENTS.md
Project instructions được load từ ~/.pi/agent/, parent directories, và current directory khi startup.
SYSTEM.md
Replace hoặc append vào default system prompt cho từng project.
Auto Compaction
Tự động summarize các messages cũ khi gần hết context limit. Fully customizable:
- Topic-based compaction
- Code-aware summaries
- Dùng model khác để summarize
Skills System
Capability packages với instructions và tools, được load on-demand. Progressive disclosure mà không làm bust prompt cache!
Prompt Templates
Tạo các reusable prompts dạng Markdown, type /name để expand.
⚡ Extensions - Build Bất Cứ Thứ Gì Bạn Muốn
Đây là điểm khiến pi-mono khác biệt hoàn toàn. Extensions là TypeScript modules có access vào:
- Tools & Commands
- Keyboard shortcuts
- Events
- Full TUI
Một số extensions example đã có sẵn:
- Sub-agents
- Plan mode
- Permission gates
- SSH execution
- Sandboxing
- Custom editors, status bars, overlays
- Và vâng, Doom cũng chạy được 😂Export & Share:
/export # Export ra HTML
/share # Upload lên GitHub gist, nhận URL shareable
🧠 Context Engineering - Kiểm Soát Hoàn Toàn
pi-mono cho phép bạn làm actual context engineering thay vì chỉ dùng những gì framework cho sẵn:
AGENTS.md
Project instructions được load từ ~/.pi/agent/, parent directories, và current directory khi startup.
SYSTEM.md
Replace hoặc append vào default system prompt cho từng project.
Auto Compaction
Tự động summarize các messages cũ khi gần hết context limit. Fully customizable:
- Topic-based compaction
- Code-aware summaries
- Dùng model khác để summarize
Skills System
Capability packages với instructions và tools, được load on-demand. Progressive disclosure mà không làm bust prompt cache!
Prompt Templates
Tạo các reusable prompts dạng Markdown, type /name để expand.
⚡ Extensions - Build Bất Cứ Thứ Gì Bạn Muốn
Đây là điểm khiến pi-mono khác biệt hoàn toàn. Extensions là TypeScript modules có access vào:
- Tools & Commands
- Keyboard shortcuts
- Events
- Full TUI
Một số extensions example đã có sẵn:
- Sub-agents
- Plan mode
- Permission gates
- SSH execution
- Sandboxing
- Custom editors, status bars, overlays
- Và vâng, Doom cũng chạy được 😂

Có hơn 50 extension examples trong repo để bạn tham khảo!
📦 Package System - Install & Share Dễ Dàng
Bundle extensions, skills, prompts, và themes thành packages:
# Install từ npm
$ pi install npm:@foo/pi-tools
# Install từ git
$ pi install git:github.com/badlogic/pi-doom
# Pin version
$ pi install npm:@foo/[email protected]
# Test mà không cần install
$ pi -e git:github.com/user/repo
Quản lý packages:
pi update # Update tất cả
pi list # Liệt kê installed packages
pi config # Cấu hình
Tìm packages trên npm hoặc Discord community!
🎯 Điều pi-mono KHÔNG Build (Và Tại Sao Đó Là Điều Tốt)
Triết lý của pi-mono là aggressively extensible - không dictate workflow của bạn:
| Feature | pi-mono approach |
|---|---|
| MCP | Build CLI tools với READMEs, hoặc tự viết extension |
| Sub-agents | Spawn pi instances qua tmux, hoặc dùng extensions |
| Permission popups | Run trong container, hoặc build confirmation flow riêng |
| Plan mode | Viết plans vào files, hoặc install package |
| Built-in to-dos | Dùng TODO.md file |
| Background bash | Dùng tmux - full observability |
Điều này giữ core minimal trong khi cho phép bạn shape pi theo cách bạn làm việc!
🛠️ Cài Đặt & Quick Start
Yêu cầu
- Node.js (LTS version)
- npm
Cài đặt
# Clone repo
git clone https://github.com/badlogic/pi-mono.git
cd pi-mono
# Install dependencies
npm install
# Build all packages
npm run build
# Run coding agent
./pi-test.sh
Development
npm install # Install dependencies
npm run build # Build all packages
npm run check # Lint, format, type check
./test.sh # Run tests
🌟 Tại Sao Mình Tin pi-mono Là Tương Lai?
- Unified API - Một API cho 15+ providers, không cần học lại mỗi lần switch
- Extensibility - Build exactly what you need, không bị force vào workflow có sẵn
- Community-driven - 95 contributors, 126 releases, đang phát triển mạnh
- MIT License - Hoàn toàn miễn phí, dùng cho cả commercial projects
- Real-world tested - Được dùng trong production bởi nhiều dự án như clawdbot

✅ Kết Luận
Nếu bạn đang tìm kiếm một bộ công cụ để:
- Build coding agent cho riêng mình
- Tạo unified workflow với nhiều LLM providers
- Có full control over context và extensibility
- Muốn share và reuse components qua packages
Thì pi-mono chính xác là câu trả lời!
Đừng quên join Discord community để connect với các developers khác, share extensions, và nhận support từ core team.
Happy hacking! 🚀
Tham khảo thêm:
Discussion