pi (earendil-works/pi): Phân Tích Bộ Công Cụ AI Agent Tối Giản

Mở đầu: pi là một monorepo TypeScript chứa bộ công cụ AI agent: coding agent CLI, API LLM thống nhất, thư viện TUI, và hệ sinh thái extension/skill. Với 60.9K sao, 212 người đóng góp, 227 bản release, đây là một trong những dự án terminal-first AI agent sôi động nhất trên GitHub. Điểm khác biệt cốt lõi: triết lý "lõi tối giản, mọi thứ khác là extension".

Gói	Công dụng
pi-ai	API LLM thống nhất đa nhà cung cấp (OpenAI, Anthropic, Google, xAI…)
pi-agent-core	Runtime agent: gọi công cụ, quản lý trạng thái, kiểm soát quyền
pi-coding-agent	CLI coding agent tương tác — đọc/ghi file, chạy shell, sửa mã nguồn của chính nó
pi-tui	Thư viện Terminal UI với differential rendering

pi cố ý không tích hợp sẵn MCP, sub-agent, plan mode, permission popup, hay to-do. Tất cả đều được triển khai qua extension. Extension là các module TypeScript chạy với toàn quyền hệ thống — có thể đăng ký công cụ tùy chỉnh, lệnh, phím tắt, thành phần UI, thậm chí thay thế công cụ tích hợp sẵn, triển khai logic nén tùy chỉnh, tích hợp SSH/Git checkpoint. Đây là hướng đi ngược lại với Claude Code (tích hợp sẵn mọi thứ).

pi triển khai chuẩn Agent Skills (/skill:name), cho phép định nghĩa prompt template, gói kỹ năng, theme. Extension, skill, prompt template, theme có thể được đóng gói thành Pi Package và chia sẻ qua npm hoặc git. Điều này tạo ra một hệ sinh thái do cộng đồng thúc đẩy — không phải nhà cung cấp quyết định tính năng, mà cộng đồng đóng góp extension.

pi lưu lịch sử phiên dưới dạng JSONL, hỗ trợ /tree (duyệt cây hội thoại) và /fork (tạo nhánh). Nhà phát triển có thể phân nhánh từ một điểm trong quá khứ để khám phá hướng mới mà không phá hủy phiên gốc.

Coding agent của pi có thể sửa trực tiếp mã nguồn của chính pi — người phát triển pi dùng pi để phát triển pi. Đây là dogfooding ở mức cực đoan nhất.

Ngoài CLI, pi cung cấp SDK để nhúng vào ứng dụng khác và chế độ RPC để tích hợp với môi trường không phải Node.js. pi không chỉ là công cụ terminal — nó có thể làm backend agent cho các hệ thống khác.

pi có chính sách quản lý phụ thuộc nghiêm ngặt bậc nhất ngành:

• Tất cả phụ thuộc ngoài khóa phiên bản chính xác; chỉ dùng phiên bản phạm vi cho gói nội bộ workspace
• .npmrc bắt buộc save-exact=true, min-release-age=2 (không chấp nhận gói phát hành cùng ngày)
• package-lock.json là nguồn sự thật duy nhất; pre-commit chặn thay đổi lockfile không được phép
• npm run check xác minh pinned deps, tương thích import, shrinkwrap
• Tất cả lệnh cài đặt và self-update đều kèm --ignore-scripts
• CI dùng npm ci --ignore-scripts + lập lịch npm audit

Khía cạnh	Đánh giá	Giải thích
Thay thế Claude Code / Codex CLI	Không khuyến nghị	TypeScript, chi phí di chuyển cao
Làm coding agent bổ sung	Giá trị thấp	Thêm chi phí vận hành, không lợi thế rõ ràng
pi-ai làm lớp trừu tượng LLM	Không cần	Hermes + LiteLLM đã bao phủ
Tham khảo kiến trúc extension	Có giá trị	Triết lý lõi tối giản + extension
Thực hành bảo mật chuỗi cung ứng	Giá trị cao	Áp dụng trực tiếp vào CI/CD
Chuẩn AGENTS.md	Có giá trị	Tạo file hướng dẫn agent cho repo

pi được thiết kế tốt, triết lý rõ ràng (Unix-style tối giản + có thể mở rộng), cộng đồng sôi động. Nhưng vấn đề nó giải quyết đã được chúng tôi bao phủ bằng Hermes + Claude Code/Codex CLI. Giá trị lớn nhất không nằm ở việc áp dụng, mà ở việc tham khảo: thực hành bảo mật chuỗi cung ứng, chuẩn AGENTS.md, và các quyết định thiết kế lõi tối giản. Nếu tương lai có dự án TypeScript quy mô lớn cần coding agent, hoặc chuẩn Agent Skills trở thành định dạng chung giữa các công cụ, pi sẽ là lựa chọn hàng đầu.