Bạn đã bao giờ mệt mỏi vì phải làm cầu nối giữa các AI agent, copy-paste context qua lại và mỗi lần chạy lại agent là nó quên sạch mọi thứ? AIPass chính là lời giải: một framework CLI giúp agent của bạn có bộ nhớ bền vững, cộng tác với nhau và không bao giờ bắt đầu từ zero nữa.

Thank you for reading this post, don't forget to subscribe!

Những điểm chính

• AIPass thêm lớp hạ tầng agent lên dự án có sẵn, giúp mọi agent ghi nhớ xuyên suốt phiên làm việc và phát triển chuyên môn theo thời gian.
• Không sandbox cô lập: tất cả agent dùng chung hệ thống tệp và hộp thư cục bộ, hoạt động như một đội thực thụ.
• Chỉ một lệnh drone @agent command để điều phối mọi tác vụ: từ gửi task, kiểm tra chất lượng đến giám sát thời gian thực.
• Không cần API key cho chức năng cốt lõi; tận dụng đăng ký Claude Pro/Max hoặc Codex hiện có, mọi thứ chạy local.
• Kèm 13 agent tham chiếu sẵn sàng để bạn học hỏi hoặc gọi trực tiếp, chứng minh kiến trúc hoạt động ở quy mô đội nhóm.

AIPass là gì và giải quyết vấn đề gì?

AIPass là scaffold CLI bổ sung bộ nhớ bền vững, danh tính và khả năng phối hợp cho các AI agent ngay trên dự án của bạn. Thay vì mỗi lần chạy lại agent phải bắt đầu từ con số 0, AIPass giúp agent ghi nhớ mọi thứ từ phiên trước, giao tiếp với đồng đội qua hộp thư và cùng làm việc trên một hệ thống tệp chung. Bạn có thể xem chi tiết tại repository gốc trên GitHub.

Thực tế, khi nhiệm vụ phức tạp, bạn thường phải đóng vai điều phối viên: sao chép ngữ cảnh giữa các công cụ, phân công thủ công, theo dõi ai đang làm gì. Các multi-agent framework khác đã cố gắng giải quyết nhưng lại nhốt mỗi agent trong sandbox riêng — filesystem riêng, context riêng, không ai biết đồng đội vừa xây dựng cái gì. Điều đó không giống một đội mà giống một căn phòng toàn người đeo tai nghe. AIPass tiếp cận khác hẳn: bạn mang dự án của mình tới, AIPass thêm lớp agent lên trên. Không giao diện đồ họa, không dashboard, tất cả chạy trong terminal quen thuộc.

Điều gì khiến AIPass khác biệt so với các giải pháp multi-agent khác?

AIPass tạo ra một không gian làm việc chung thực sự cho agent. Mỗi agent khi được khởi tạo sẽ có cấu trúc thư mục chuẩn gồm .trinity/ (danh tính và bộ nhớ), .ai_mail.local/ (hộp thư nội bộ), apps/ (mã nguồn của agent) và README.md (tri thức miền). Nhờ vậy, agent không chỉ nhớ lịch sử tương tác — bộ nhớ bắt đầu từ các tệp JSON, khi đầy sẽ tự động lưu trữ sang ChromaDB để tìm kiếm ngữ nghĩa lâu dài — mà còn nhận task, gửi kết quả qua ‘mail’ và sẵn sàng cộng tác trên cùng filesystem.

Điểm nổi trội thứ hai là bộ định tuyến drone. Bạn chỉ cần học một cú pháp: drone @agent command [args]. Mọi agent, mọi tác vụ — từ kiểm tra chất lượng (drone @seedgo audit my_project), tạo kế hoạch công việc (drone @flow create . ‘Refactor auth module’) cho đến gửi task và đánh thức agent (drone @ai_mail dispatch @agent ‘Lưu trữ session cũ’ ‘Tìm session quá 30 ngày’) — đều qua drone. Không cần nhớ tên script riêng cho từng agent, giảm tải nhận thức đáng kể.

Hạ tầng của AIPass còn bao gồm 13 agent lõi (devpulse, aipass, drone, seedgo, prax, ai_mail, flow, spawn, hooks, memory, api, trigger, cli) được phát triển và bảo trì chính framework này. Chúng minh họa cách agent làm việc song song, báo cáo kết quả và tự phục hồi — tất cả trên cùng một project, không sandbox, không worktree. Ngay cả các agent về chất lượng (seedgo) hay giám sát thời gian thực (prax) cũng sẵn sàng để bạn gọi trực tiếp từ dự án của mình.

Cuối cùng, AIPass tôn trọng chi phí hiện tại của bạn. Nó chạy nền trên CLI subscription Claude Pro/Max hoặc Codex mà bạn đã có, không cần thêm API key cho chức năng cốt lõi. Không trích xuất OAuth token, không proxy lời gọi, không giả mạo client — đơn giản là chạy CLI chính thức dưới dạng subprocess. API key chỉ cần nếu bạn muốn dùng các add-on agent như OpenRouter.

Hướng dẫn cài đặt và sử dụng AIPass từ A đến Z như thế nào?

Bạn chỉ cần Python 3.10+ và Claude Code (Linux/WSL hoặc macOS) là có thể bắt đầu. Dự án được kiểm thử đầy đủ với Claude Code, hỗ trợ thử nghiệm với Codex. Quá trình khởi tạo có hướng dẫn từng bước, mất khoảng 5 phút để có agent đầu tiên hoạt động.

Cài đặt AIPass

Mở terminal và chạy:

pip install aipass

Khởi tạo dự án với agent đầu tiên

Tạo thư mục dự án mới và gọi lệnh khởi tạo có hướng dẫn:

mkdir my-project && cd my-project
aipass init run

Setup có hướng dẫn sẽ tạo cấu trúc dự án, agent đầu tiên (thường đóng vai trò orchestrator) và mở terminal nơi agent đã sẵn sàng. Hãy thử nói ‘hi’ — nó biết mình là ai. Ngày mai quay lại, nó vẫn nhớ. Cây thư mục kết quả trông như sau:

my-project/
├── .aipass/
├── .claude/
├── src/my_project/
│ └── my_agent/
│ ├── .trinity/
│ ├── .ai_mail.local/
│ ├── apps/
│ └── README.md
├── CLAUDE.md
└── MY-PROJECT_REGISTRY.json

Không có daemon, không trạng thái ẩn — tất cả là tệp thuần. Xoá thư mục là sạch.

Thêm agent mới

Khi cần mở rộng đội, chỉ một lệnh:

aipass init agent my_agent

Agent mới sẽ có đầy đủ hộp thư, bộ nhớ, danh tính và cấu trúc apps/ giống hệt agent đầu tiên. Biết một agent là biết tất cả.

Sử dụng drone để điều phối

drone là trung tâm chỉ huy. Một số lệnh mẫu bạn có thể thử ngay:

drone @seedgo audit aipass — chạy kiểm tra chất lượng tự động trên toàn bộ agent
drone @flow create . 'Thêm xác thực người dùng' — tạo kế hoạch công việc
drone @ai_mail dispatch @agent 'Lưu trữ session cũ' 'Tìm session quá 30 ngày' — gửi task và đánh thức agent

Mọi thứ đều qua một giao diện dòng lệnh duy nhất, không cần nhớ đường dẫn riêng.

Làm việc với bộ agent tham chiếu

Nếu muốn khám phá toàn bộ 13 agent lõi, bạn có thể clone repo về và chạy:

git clone https://github.com/AIOSAI/AIPass.git
cd AIPass
./setup.sh

Script sẽ tạo virtualenv, cài đặt và bootstrap toàn bộ agent. Sau đó bạn có thể trò chuyện với orchestrator devpulse qua claude, kiểm tra sức khỏe hệ thống bằng aipass doctor, hoặc chạy kiểm tra chất lượng chéo như trên.

Gỡ cài đặt

Muốn xoá AIPass khỏi dự án, chỉ cần gỡ tệp cục bộ:

rm -rf .aipass/ .claude/ .ai_mail.local/ hooks/ src/
rm -f CLAUDE.md AGENTS.md *_REGISTRY.json .gitignore
pip uninstall aipass

Để xoá một agent riêng lẻ, dùng lệnh spawn:

drone @spawn delete @agent_name

Lệnh này lưu trữ và hủy đăng ký agent một cách sạch sẽ.

Ai nên dùng AIPass — ai không nên?

Nếu bạn là developer thường xuyên xây dựng quy trình tự động hoá với AI agent, phải quản lý nhiều agent phối hợp trong một dự án và mệt mỏi với việc copy context, AIPass sinh ra để dành cho bạn. Nó đặc biệt phù hợp với những ai đã quen dùng Claude Code hoặc Codex CLI và muốn nâng cấp trải nghiệm agent mà không cần dashboard rườm rà. Tôi đã thử nghiệm với Claude Code trên WSL và thấy quá trình init run cực kỳ mượt, agent biết chào hỏi và ghi nhớ ngay từ lần đầu, đúng như quảng cáo.

Ngược lại, nếu bạn cần một giao diện đồ họa để quản lý agent, chưa từng làm việc với terminal hoặc không có nhu cầu chạy multi-agent cục bộ, AIPass có thể khiến bạn bối rối. Framework này không phải là sản phẩm đóng gói có UI, nó là scaffold dành cho dev — mọi thao tác đều trên dòng lệnh. Ngoài ra, dự án vẫn đang beta, phát triển bởi một cá nhân kết hợp cùng chính các AI agent, nên bạn cần sẵn sàng gặp một số góc cạnh chưa mượt. macOS đã qua CI, Windows native vẫn đang thử nghiệm, và Codex CLI mới ở mức experimental. Nếu phải đảm bảo độ ổn định tuyệt đối cho production, bạn nên đánh giá kỹ các giới hạn này.

Điểm tôi thích nhất: không đụng đến cloud, không API key bắt buộc, mọi thứ là tệp plain text trong dự án của tôi. Khi xoá là sạch, không để lại rác. Nếu bạn là kiểu người muốn toàn quyền kiểm soát, AIPass tạo cảm giác an tâm hơn nhiều so với các nền tảng agent SaaS.

Câu hỏi thường gặp

AIPass có yêu cầu API key không?

Không, chức năng cốt lõi của AIPass chạy trên CLI subscription bạn đã có (Claude Pro/Max hoặc Codex). API key chỉ cần cho các add-on agent tuỳ chọn như OpenRouter. Mọi dữ liệu lưu local, không gửi ra ngoài.

AIPass hoạt động trên hệ điều hành nào?

Linux và WSL được hỗ trợ đầy đủ. macOS đã vượt qua toàn bộ test suite trên CI. Windows native đang trong giai đoạn thử nghiệm với CI xanh. Bạn nên dùng WSL nếu đang trên Windows để có trải nghiệm tốt nhất.

Tôi có cần clone repo gốc để sử dụng không?

Không bắt buộc. Bạn chỉ cần pip install aipass và khởi tạo dự án riêng bằng aipass init run. Repo gốc chứa 13 agent tham chiếu là phần minh hoạ nâng cao, bạn có thể bỏ qua hoặc clone về tham khảo sau.

Làm sao để gỡ bỏ hoàn toàn AIPass?

Xoá các thư mục và tệp AIPass đã tạo trong dự án (rm -rf .aipass/ .claude/ ...) và gỡ package pip (pip uninstall aipass). Không có tài khoản đám mây hay dịch vụ bên ngoài nào cần huỷ.

Tôi có thể dùng AIPass với Codex CLI không?

Hỗ trợ cho Codex đang ở mức experimental: hooks và AGENTS.md đã được thiết lập, nhưng cần thêm kiểm thử end-to-end. Bạn có thể thử, nhưng hiện tại Claude Code mới là lựa chọn được kiểm thử đầy đủ.

Kết luận

AIPass không phải là một nền tảng AI hoành tráng, mà là một scaffold thiết thực cho developer muốn biến đám AI agent rời rạc thành một đội ngũ có trí nhớ và biết phối hợp. Với triết lý local-first, không cloud, tôn trọng subscription hiện có và một cú pháp drone duy nhất, nó hạ thấp rào cản để bạn xây dựng hệ thống multi-agent thực chiến ngay trên terminal. Nếu bạn đã mệt mỏi với việc ‘bắt đầu từ zero’ mỗi sáng, tôi khuyên bạn nên dành 5 phút chạy aipass init run trên dự án tiếp theo — rồi xem agent của bạn nhớ được đến đâu. Đừng quên ghé trang GitHub của AIPass để star, đặt câu hỏi hoặc đóng góp bản thử nghiệm nhé!