Oracle AI CLI: Gửi Context Code Cho AI Đánh Giá

Oracle Là Gì?

Oracle là một CLI và MCP server dùng để đóng gói context code và gửi nó tới một large language model để review. Oracle gói một prompt cùng các file, thư mục, hoặc glob bạn chọn, gửi gói đó qua API của nhà cung cấp hoặc qua trình duyệt đã đăng nhập, và lưu kết quả tại ~/.oracle/sessions để xem lại sau. Oracle được xây cho các nhà phát triển và cả coding agent muốn có ý kiến thứ hai bám sát dự án thật, thay vì một đoạn mô tả dán vào chat.

Hướng Dẫn Cài Đặt

Trên macOS hoặc Linux, Homebrew cài Oracle bằng brew install steipete/tap/oracle. Ở bất kỳ đâu có Node.js, npm install -g @steipete/oracle cài CLI toàn cục — nhưng Oracle cần Node 24 trở lên mới chạy được. Để thử mà không cần cài gì, npx -y @steipete/oracle --help tải về một lần và in ra phần trợ giúp. Một hướng dẫn cài đặt riêng trong repo (docs/install.md) nói kỹ hơn về đường pnpm, cập nhật, thiết lập API key, và nơi lưu file so với README ở cấp cao nhất.

Bắt Đầu Và Kiểm Soát Context

Lần chạy đầu thường bắt đầu với --render, ví dụ oracle --render -p "Review the package metadata for release risks" --file package.json, lệnh này in ra đúng prompt và nội dung file đã đánh số dòng mà không đụng tới credential hay gọi tới mô hình nào. Bỏ --render khi đã cấu hình một provider, và cùng dạng lệnh đó sẽ gửi gói đi và trả về câu trả lời — --file nhận từng file riêng lẻ, cả thư mục, glob pattern như src/oracle/**/*.ts, hoặc một exclusion bắt đầu bằng ! như !**/*.test.ts, và bạn có thể lặp lại flag này để ghép đúng context muốn review. Nếu không chỉ định, Oracle tự chọn chế độ API khi tìm thấy OpenAI key và chuyển sang chế độ trình duyệt nếu không có; --engine api hoặc --engine browser ghi đè lựa chọn đó. Trước khi tốn một request, --dry-run summary --files-report liệt kê những file thực sự được resolve và ước tính số token. Mỗi bundle được tạo ra đều đánh số dòng, đó là lý do câu trả lời có thể trích dẫn đúng path:line thay vì một tham chiếu mơ hồ.

Tính Năng Cốt Lõi

• ✓Ba engine để chọn: chế độ API cho các lần chạy có thể lập script khi đã có provider key, chế độ trình duyệt để tận dụng phiên ChatGPT hoặc Gemini đã đăng nhập sẵn sau một lần đăng nhập Chrome, và chế độ render, không cần tài khoản hay key nào vì không có gì rời khỏi máy bạn.
• ✓Chế độ API tiếp cận OpenAI, Azure OpenAI, Anthropic, Gemini, xAI, OpenRouter, và các endpoint tương thích OpenAI khác.
• ✓--file ghép context từ từng file riêng lẻ, cả thư mục, glob pattern, và các exclusion bắt đầu bằng !, có thể lặp lại trong cùng một lệnh.
• ✓Các bundle văn bản được tạo ra mang số dòng cố định, nhờ đó câu trả lời của mô hình có thể trỏ đúng về một path:line cụ thể.
• ✓Các lần chạy được lưu tại ~/.oracle/sessions; một câu trả lời chậm vẫn tiếp tục chạy nền thay vì chặn terminal của bạn, và oracle status --hours 72 liệt kê những gì đã chạy gần đây.
• ✓--followup tiếp tục một cuộc hội thoại API hoặc ChatGPT đang có với thêm context, thay vì bắt đầu lại từ đầu.
• ✓--models gửi cùng một prompt tới nhiều mô hình trong một lần chạy và ghi lại usage, chi phí, output, và bất kỳ lỗi cục bộ nào của từng mô hình.
• ✓Một server oracle-mcp dạng stdio, cùng một Oracle skill có thể cài đặt, cho phép các MCP client như Claude Code, Codex, và Cursor gọi Oracle trực tiếp như một tool.

Ứng Dụng Thực Tế Cho Nhà Phát Triển

• •Giới hạn một review AI vào đúng phần code cần xem, ví dụ --file "src/oracle/**/*.ts" --file "!**/*.test.ts", và nhận câu trả lời trích dẫn đúng file và dòng.
• •Kiểm tra trước những gì thực sự sẽ được gửi đi trước khi tốn request hoặc lộ file, bằng --render hoặc --dry-run summary --files-report để xem trước bundle và ước tính token.
• •Chạy cùng một câu hỏi trên nhiều provider cùng lúc bằng --models để so sánh chi phí, output, và lỗi cạnh nhau — hữu ích khi bạn không tin hoàn toàn vào một mô hình duy nhất.
• •Gắn Oracle vào bộ công cụ của chính một agent qua server oracle-mcp dạng stdio, để một coding agent, chứ không chỉ con người, có thể xin ý kiến thứ hai bám sát dữ liệu thật ngay giữa tác vụ.
• •Quay lại hoặc lặp lại một review chạy lâu sau đó bằng oracle session, oracle restart, hoặc --followup, thay vì gửi lại toàn bộ context từ đầu.

Oracle Dành Cho Ai?

Oracle phù hợp với các nhà phát triển đang dùng cùng lúc nhiều provider mô hình và muốn một CLI duy nhất có thể gửi cùng một context bám sát file thật tới bất kỳ provider nào trong số đó, cùng các coding agent cần xin ý kiến thứ hai giữa tác vụ qua MCP. Nó cũng hợp với ai muốn xem trước chính xác những gì sẽ được gửi đi, vì chế độ render không cần key hay tài khoản nào cả. Bỏ qua nếu bạn chỉ thỉnh thoảng hỏi một mô hình một câu trong tab trình duyệt — phần lưu session, bảng so sánh nhiều mô hình, và kết nối MCP sẽ là thứ bạn không dùng tới.

Các Dự Án Thay Thế Và Liên Quan

Câu Hỏi Thường Gặp

Vấn Đề Oracle Giải Quyết

Xin ý kiến thứ hai từ một mô hình AI về code thường có nghĩa là dán từng file vào cửa sổ chat bằng tay, mất số dòng, và phải làm lại từ đầu mỗi khi muốn xem lại câu trả lời. Chính tagline trên GitHub của Oracle nói thẳng về khoảng trống đó: gọi một mô hình như GPT-5 Pro với context và tập file được chọn sẵn. README xây dựng thêm từ đó bằng cách lưu cuộc trao đổi thành một session gắn với các file thật, gửi qua API hoặc trình duyệt thật, thay vì một lần copy-paste rời rạc.

Repo liên quan