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. Khác với các nền tảng agent SaaS yêu cầu đăng ký tài khoản, AIPass được cài đặt trực tiếp vào dự án và chạy trên terminal, cho phép bạn giữ toàn quyền kiểm soát dữ liệu.
Thank you for reading this post, don't forget to subscribe!AIPass là một framework CLI mã nguồn mở giúp gắn bộ nhớ bền vững và khả năng phối hợp cho AI agent ngay trên dự án của bạn. Thay vì bắt đầu lại từ zero mỗi phiên làm việc, agent lưu danh tính, lịch sử và tri thức vào .trinity/, tự động chuyển sang ChromaDB khi bộ nhớ đầy. Các agent dùng chung filesystem và giao tiếp qua hộp thư cục bộ, điều phối bằng một lệnh drone duy nhất. Khác với LangGraph (graph state machine) và CrewAI (role-based agent), AIPass không tạo sandbox riêng và không yêu cầu API key cho chức năng cốt lõi; nó chạy trên subscription Claude Pro/Max hoặc Codex hiện có. Bài viết so sánh ba framework, hướng dẫn cài đặt trong 5 phút và chỉ ra các giới hạn bảo mật khi chạy local-first.
AIPass thực sự ‘nhớ lâu’ nhờ cơ chế nào bên dưới?
AIPass lưu danh tính và lịch sử agent vào thư mục .trinity/ dưới dạng tệp JSON. Khi bộ nhớ này đầy, nó tự động chuyển sang ChromaDB để truy vấn ngữ nghĩa lâu dài. Mỗi agent cũng có hộp thư .ai_mail.local/ riêng, nhưng tất cả cùng nằm trên một filesystem nên không cần copy context thủ công.
Ý tưởng ‘bộ nhớ’ ở đây không phải là lưu toàn bộ chat log. Thư mục .trinity/ chứa hồ sơ danh tính, quyết định và trạng thái của agent, trong khi apps/ giữ mã nguồn và README.md đóng vai trò tri thức miền. Khi cần tìm lại một quyết định cũ, ChromaDB sẽ truy vấn theo ngữ nghĩa, không chỉ khớp từ khoá. Cách tiếp cận này gần với bộ nhớ liên tục cho Claude Code mà chúng tôi từng giới thiệu, nhưng AIPass mở rộng nó cho nhiều agent phối hợp trên cùng một project.
Nếu bạn muốn xem chi tiết cách tổ chức thư mục, repository gốc trên GitHub có đầy đủ mã nguồn và 13 agent tham chiếu. ChromaDB là vector database mã nguồn mở, được dùng để lưu trữ và tìm kiếm embedding; bạn có thể đọc tài liệu chính thức tại docs.trychroma.com nếu muốn hiểu sâu hơn về hệ thống vector hoá.
So sánh AIPass với LangGraph và CrewAI: lựa chọn nào hợp lý?
AIPass phù hợp với developer thích dùng CLI thuần, local-first và muốn agent dùng chung filesystem. LangGraph mạnh về điều khiển luồng theo graph, CrewAI mạnh về đội agent phân vai, còn AIPass tối giản mọi thứ bằng một lệnh drone. Khác biệt cốt lõi nằm ở triết lý: AIPass không tạo sandbox riêng cho từng agent.
Để dễ hình dung, bảng dưới đây so sánh nhanh ba framework phổ biến:
| Tiêu chí | AIPass | LangGraph | CrewAI |
|---|---|---|---|
| Cách phối hợp | Một cú pháp drone, agent giao tiếp qua hộp thư cục bộ | Đồ thị trạng thái, luồng điều khiển rõ ràng | Agent phân vai, task được delegate theo role |
| Bộ nhớ | .trinity + ChromaDB, tự động lưu trữ | Bộ nhớ do lập trình viên khai báo | Bộ nhớ ngắn hạn và dài hạn theo agent |
| Giao diện | Terminal / CLI | Python API | Python API |
| Chi phí | Dùng subscription Claude Pro/Max hoặc Codex hiện có | Tự quản lý model và chi phí API | Tự quản lý model và chi phí API |
| Phù hợp | Dev muốn local-first, toàn quyền kiểm soát tệp | Quy trình phức tạp, cần kiểm soát luồng | Đội agent phân vai rõ ràng |
LangGraph là thư viện của LangChain, dùng khái niệm graph state machine để định nghĩa vòng lặp agent; tài liệu chính thức tại langchain-ai.github.io/langgraph mô tả chi tiết cách xây dựng luồng. CrewAI hướng đến role-based agent, nơi mỗi agent có vai trò, mục tiêu và công cụ riêng; xem thêm tại docs.crewai.com. AIPass có thể coi là lựa chọn thay thế cho không gian làm việc chung nhưng ở phạm vi local và dành riêng cho agent.
Cài đặt AIPass cho một dự án Python cụ thể ra sao?
Chỉ cần Python 3.10+ và Claude Code là bắt đầu. Chạy pip install aipass, sau đó tạo thư mục project và gọi aipass init run. Lệnh này sẽ tạo agent đầu tiên cùng cấu trúc .trinity/, .ai_mail.local/, apps/, README.md và file registry cho toàn bộ dự án.
Các bước cụ thể:
- Cài package:
pip install aipass - Tạo dự án mới:
mkdir my-project && cd my-project - Khởi tạo agent đầu tiên:
aipass init run - Thêm agent mới:
aipass init agent my_agent - Điều phối bằng drone:
drone @flow create . 'Refactor auth module'
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.mdMY-PROJECT_REGISTRY.json
Không có daemon, không trạng thái ẩn; tất cả đều là tệp thuần. Khi xoá thư mục là sạch. Nếu bạn là developer thường xây dựng quy trình tự động hoá với AI agent, bạn sẽ thấy lối thiết kế dạng tệp này dễ dàng đưa vào CI/CD và version control.
Để điều phối nhiều agent, học một cú pháp duy nhất: drone @agent command [args]. Ví dụ: drone @seedgo audit my_project chạy kiểm tra chất lượng, 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. Toàn bộ tác vụ đều nằm trên terminal, không cần nhớ script riêng cho từng agent.
Trải nghiệm 30 ngày dùng AIPass: agent của tôi nhớ được gì?
Sau 30 ngày, agent vẫn nhớ các quyết định kiến trúc, biết task nào đang dở và có thể tiếp tục mà không cần nhắc lại toàn bộ lịch sử chat. Điều quan trọng không phải là nhớ từng câu thoại, mà là nhớ bối cảnh của dự án thông qua .trinity/ và README.md.
Trong quá trình dùng thực tế, kết quả phụ thuộc rất lớn vào cách bạn tổ chức thư mục và mức độ thường xuyên cập nhật tri thức miền. Agent không thể tự biết đâu là quyết định quan trọng nếu bạn không ghi chú. Nếu bạn đang dùng AIPass và muốn chia sẻ trải nghiệm kiểm chứng, hãy bổ sung thông tin vào bài viết này.
Quan sát từ nhóm phát triển cho thấy giá trị lớn nhất nằm ở việc giảm số lần nhắc lại context mỗi sáng. Thay vì mở lại nhiều tab và dán lại yêu cầu, agent tự đọc lịch sử từ thư mục của nó. Tuy nhiên, cơ chế này vẫn còn giới hạn: ChromaDB chỉ có giá trị khi dữ liệu đã được ghi đầy đủ, còn nếu bạn xoá .trinity/ thì agent quay về trạng thái ban đầu.
Bảo mật và giới hạn khi chạy multi-agent local-first
Chạy local-first giúp giảm rủi ro gửi dữ liệu lên cloud, nhưng không tự động an toàn. Thư mục .trinity/ và .ai_mail.local/ chứa toàn bộ lịch sử hoạt động của agent; nếu repository bị lộ, kẻ tấn công có thể đọc được ngữ cảnh nhạy cảm. Vì vậy, cần mã hoá ổ đĩa và kiểm soát quyền truy cập file cẩn thận.
AIPass không trích xuất OAuth token, không proxy lời gọi và không giả mạo client. Nó chạy CLI subscription hiện có của bạn dưới dạng subprocess, tương tự như cách Claude Code hoạt động. Bạn có thể xem tài liệu chính thức của Claude Code tại docs.anthropic.com/en/docs/claude-code để hiểu rõ quyền hạn mà CLI yêu cầu. Nếu bạn muốn chạy thử với Codex CLI, mã nguồn và hướng dẫn nằm tại openai.com/codex.
Một giới hạn rõ ràng nữa là nền tảng: Linux và WSL được hỗ trợ đầy đủ, macOS đã qua CI, còn Windows native đang thử nghiệm. Nếu bạn chạy trên môi trường chưa được kiểm thử, hãy chuẩn bị sẵn phương án dự phòng. Về bảo mật, chúng tôi khuyến nghị không dùng AIPass để xử lý dữ liệu yêu cầu tuân thủ nghiêm ngặt trước khi có bản phát hành ổn định.
Khi nào bạn không nên mang AIPass vào production?
Không nên dùng AIPass nếu bạn cần giao diện đồ họa quản lý agent, yêu cầu độ ổn định tuyệt đối, hoặc triển khai trên Windows native. Dự án còn ở giai đoạn beta và được phát triển chính bởi một cá nhân kết hợp cùng các agent, nên bạn phải sẵn sàng đọc mã nguồn và tự xử lý sự cố.
Với người chưa quen terminal, AIPass sẽ tạo cảm giác khó tiếp cận vì không có dashboard, không có nút bấm, mọi thao tác đều qua dòng lệnh. Nếu nhu cầu của bạn là phân vai agent rõ ràng, CrewAI có thể dễ dùng hơn. Nếu bạn cần kiểm soát luồng phức tạp như chuỗi điều kiện, vòng lặp, LangGraph với graph state machine sẽ phù hợp hơn.
Ngoài ra, AIPass không thay thế hoàn toàn một nền tảng multi-agent trên cloud. Nó là lớp hạ tầng bổ sung lên dự án hiện tại, giúp agent nhớ và phối hợp. Nếu bạn đã có sẵn hệ thống microservices và cần agent gọi API từ xa, bạn vẫn phải xây dựng phần transport riêng. Lúc đó, một framework như LangGraph lại có lợi thế về khả năng mở rộng.
Câu hỏi thường gặp
Những câu hỏi dưới đây xoay quanh API key, hệ điều hành, cách gỡ cài đặt và mức độ hỗ trợ Codex. Câu trả lời dựa trên trạng thái hiện tại của repository AIPass và các tài liệu liên quan.
AIPass có yêu cầu API key không?
Không, chức năng cốt lõi chạy trên subscription Claude Pro/Max hoặc Codex mà bạn đã có. API key chỉ cần khi dùng add-on tùy chọn như OpenRouter. Toàn bộ dữ liệu đề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 test suite trên CI. Windows native đang trong giai đoạn thử nghiệm, vì vậy nếu bạn đang dùng Windows, hãy cài WSL để có trải nghiệm ổn định 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 cài package qua pip. Repo gốc chứa 13 agent tham chiếu và script setup.sh, hữu ích để học cách tổ chức agent, nhưng không cần cho dự án cá nhân.
Làm sao để gỡ bỏ hoàn toàn AIPass?
Xoá các thư mục .aipass/, .claude/, .ai_mail.local/, hooks/, tệp registry và chạy pip uninstall aipass. Vì không có tài khoản cloud, bạn không cần hủy bất kỳ dịch vụ bên ngoài nào.
Tôi có thể dùng AIPass với Codex CLI không?
Hỗ trợ đang ở mức experimental: hooks và AGENTS.md đã được thiết lập, nhưng chưa có kiểm thử end-to-end đầy đủ. Hiện tại, Claude Code là lựa chọn được kiểm thử kỹ nhất cho AIPass.
AIPass không phải là nền tảng AI hoành tráng, mà là scaffold thực dụng cho developer muốn biến đám 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à cú pháp drone duy nhất, nó hạ thấp rào cản xây dựng hệ thống multi-agent 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, hãy dành 5 phút chạy aipass init run trên dự án tiếp theo. Xem thêm mã nguồn và đóng góp tại trang GitHub của AIPass.
