Orbital: Nền tảng mã nguồn mở giúp bạn sở hữu ngữ cảnh dự án thay vì từng phiên làm việc

Khi làm việc với các AI agent lập trình như Claude Code hay Codex, người dùng thường gặp tình trạng phiên làm việc hết hạn mức và toàn bộ ngữ cảnh bị mắc kẹt. Orbital ra đời như một giải pháp mã nguồn mở cho phép đưa ngữ cảnh dự án ra khỏi từng phiên riêng lẻ, giúp bất kỳ agent nào cũng có thể tiếp tục công việc mà không cần giải thích lại.

Vấn đề: ngữ cảnh bị khóa trong từng phiên làm việc

Những người làm việc với nhiều AI agent cùng lúc hẳn đã quen với cảnh tượng: bạn đang thảo luận thiết kế qua vòng thứ ba với Claude Code thì nó báo hết hạn mức sử dụng. Hạn mức Codex vẫn còn nguyên đó, nhưng Codex không biết gì về dự án này — mục tiêu, hai quyết định bạn vừa đưa ra, những tệp tin còn dang dở.

Mỗi agent hiện nay đều hoạt động trong phiên riêng biệt với ngữ cảnh và lịch sử riêng. Khi chuyển đổi giữa các phiên hay công cụ, chính bạn là người phải gánh trách nhiệm duy trì dự án: nhắc lại mục tiêu, giải thích các quyết định trước đó, tìm kiếm tài liệu và kiểm tra xem còn gì chưa hoàn thành.

Bạn trở thành thực tập sinh của agent: sao chép, dán, vận chuyển ngữ cảnh qua lại, ghi nhớ vị trí các tệp tin kỳ quặc — trong khi agent mới là kẻ được suy nghĩ.

Orbital giải quyết vấn đề như thế nào?

Orbital thay đổi đơn vị công việc từ phiên làm việc sang dự án. Thay vì để ngữ cảnh nằm trong session, Orbital đưa chúng trở lại thư mục cục bộ trên máy của bạn. Bất kỳ agent nào cũng có thể tiếp nhận, với toàn bộ ngữ cảnh còn nguyên vẹn.

Minh họa chuyển giao tác vụ giữa các agent

Cụ thể, Orbital duy trì năm thành phần thường bị phân mảnh hoặc biến mất giữa các phiên agent — tất cả đều là tệp tin văn bản thuần trong thư mục dự án:

• Trạng thái (State) — những gì đang đúng với dự án ở thời điểm hiện tại (PROJECT_STATE.md)
• Quyết định (Decisions) — những gì đã được quyết và lý do (DECISIONS.md)
• Bài học (Lessons) — những gì dự án đã học được (LESSONS.md)
• Công việc (Work) — những gì đang chạy, đã xong hoặc bị chặn (queue.json)
• Tài sản (Artifacts) — những gì agent nghiên cứu, viết hoặc xây dựng (chính workspace, cộng với orbital/output/)

Những tệp tin này lưu lại trong dự án cục bộ và trở thành ngữ cảnh cho công việc tương lai. Worker có thể thay đổi, nhưng dự án vẫn tiếp diễn.

Ủy quyền cho các agent chuyên biệt

Orbital không gắn chặt với một công cụ AI duy nhất. Agent dự án lập kế hoạch và ủy quyền, trong khi các worker chuyên biệt thực thi — mỗi worker đọc cùng một ngữ cảnh dự án tích lũy.

Mỗi lần điều phối, Orbital tạo một prompt kế thừa mới trỏ worker đến các tệp PROJECT_STATE.md, DECISIONS.md, LESSONS.md, INDEX.md cùng hướng dẫn và kỹ năng của dự án. Worker đọc chúng theo nhu cầu thay vì nhận bản sao dán vào, nhờ đó bản tóm tắt không bao giờ lỗi thời.

Các loại giao thức vận chuyển mà Orbital hỗ trợ:

• Codex app-server — JSON-RPC gốc của Codex qua stdio
• Pipe — tiến trình con stdin/stdout với luồng JSON
• PTY — pseudo-terminal cho các agent tương tác như Gemini CLI, Aider, Cline, Goose, Copilot CLI
• SDK — tích hợp trực tiếp Claude SDK
• ACP — Agent Communication Protocol, hỗ trợ Cursor qua máy chủ ACP chính thức

Hàng đợi tác vụ: không có tác vụ nào trôi dạt

Mỗi dự án có một hàng đợi lưu tại orbital/queue.json. Bạn thêm tác vụ — ghim những việc gấp lên đầu — và agent làm việc tuần tự mà bạn không cần ngồi nhìn.

Điểm đáng chú ý: agent phải tuyên bố kết quả cho mọi mục, nó không thể âm thầm trôi sang mục tiếp theo.

• Hoàn thành (Completed) — agent báo cáo tóm tắt ngắn, mục chuyển sang trạng thái Hoàn thành và hàng đợi tiến lên.
• Bị chặn (Blocked) — agent nêu lý do (thiếu thông tin xác thực, yêu cầu mơ hồ…), mục chuyển sang "Cần chú ý" và hàng đợi tiếp tục. Bạn gỡ chặn khi sẵn sàng.

Cơ chế kiểm soát và an toàn

Orbital cung cấp ba mức tự chủ để kiểm soát mức độ giám sát:

• Hands-off (Buông tay) — Shell, ghi tệp và trình duyệt đều tự động. Chỉ request_access cần phê duyệt.
• Check-in (Điểm danh) — Ghi tệp và trình duyệt cần phê duyệt. Mức mặc định cho agent bên ngoài.
• Supervised (Giám sát) — Mọi thao tác trừ đọc đều cần phê duyệt. Mức giám sát tối đa.

Về mặt chi phí, mỗi dự án có thể đặt hạn mức ngân sách tính bằng USD. Khi đạt ngưỡng, hệ thống có thể tạm dừng để hỏi người dùng (ask) hoặc dừng hẳn agent (stop). Vòng lặp agent theo dõi lượng token tích lũy và tính chi phí dựa trên bảng giá từng mô hình.

Ngoài ra còn có các rào chắn an toàn cho vòng lặp: ngân sách token cứng (mặc định 100 triệu token), phát hiện lặp lại, phát hiện ping-pong, cầu dao ngắt mạch sau hai lỗi liên tiếp giống nhau, và xử lý tràn ngữ cảnh.

Quản lý ngữ cảnh và nén thông tin

Đây là cách agent dự án duy trì ngữ cảnh xuyên phiên. Các tệp Layer-1 do agent tự duy trì được tiêm vào mỗi lượt (giới hạn theo từng tệp) và hợp nhất ở ranh giới phiên:

• PROJECT_STATE.md — bảng nháp trạng thái hiện tại, ghi đè chứ không phải nhật ký thay đổi
• DECISIONS.md — quyết định bền vững kèm lý do, hợp nhất và thay thế, không bao giờ mâu thuẫn
• LESSONS.md — kinh nghiệm thực tiễn bền vững, giữ nguyên vẹn, không cắt chữ
• INDEX.md — bản đồ điều hướng, chỉ gồm cây tệp và một câu mô tả mỗi tệp

Khi mức sử dụng ngữ cảnh vượt 80%, hệ thống kích hoạt nén (compaction): xả bộ nhớ, tóm tắt các tin nhắn cũ bằng LLM, giữ nguyên tin nhắn gần đây, rồi định hướng lại với mục tiêu dự án và trạng thái hiện tại. Phiên bản v0.4.2 còn tối ưu bộ đệm tiền tố (prefix cache) — tách system prompt thành các phần tĩnh, bán ổn định và động, giúp tới ~95% token đầu vào trúng bộ đệm tiền tố của nhà cung cấp.

Cài đặt và hỗ trợ nền tảng

Orbital là ứng dụng desktop đóng gói sẵn, thiết lập trong vòng chưa đầy 5 phút, không yêu cầu Python hay Node cho người dùng cuối. Bạn chỉ cần mang theo khóa API của riêng mình.

Nút tải xuống cho Windows

• Windows — tải trình cài đặt .exe từ mục Releases. Lưu ý: Orbital chưa được ký mã, nên Windows SmartScreen sẽ hiện cảnh báo; bạn cần bấm "More info" rồi "Run anyway".
• macOS — tải tệp .dmg, yêu cầu macOS 13 (Ventura) trở lên và chip Apple Silicon (M1 trở lên). Bản phát hành đã được Apple ký Developer-ID và công chứng, mở bình thường không cần vòng vo.
• Từ mã nguồn — yêu cầu Python 3.11+ và Node.js 18+. Clone kho lưu trữ, cài phụ thuộc và chạy daemon qua uvicorn.

Yêu cầu nền tảng Windows

Nhà cung cấp LLM và BYOK

Orbital hỗ trợ 14 nhà cung cấp LLM sẵn có, bao gồm Anthropic, OpenAI, DeepSeek, Moonshot (Kimi), Groq, Google Gemini, xAI, Mistral, Together, OpenRouter, Zhipu, Qwen, cùng TokenDance (词元跳动 — bộ định tuyến mô hình cho Trung Quốc đại lục) và một mục tùy chỉnh cho bất kỳ điểm cuối tương thích OpenAI nào như Ollama hay Azure OpenAI.

Hệ thống có cơ chế xoay dự phòng: khi nhà cung cấp chính gặp lỗi, vòng lặp chuyển sang các nhà cung cấp dự phòng kèm phân loại lỗi (tạm thời, giới hạn tốc độ, hủy bỏ).

Điều khiển từ xa qua điện thoại

Orbital cho phép điều khiển agent từ điện thoại qua mạng cục bộ hoặc qua relay đám mây. Với mạng LAN, bạn chỉ cần quét mã QR trong phần Cài đặt. Với relay đám mây (tùy chọn), bạn có thể truy cập ngoài mạng nhà và nhận thông báo đẩy khi có yêu cầu phê duyệt hoặc thay đổi trạng thái agent.

Kiến trúc và triết lý thiết kế

Orbital là một agent bền vững gắn với một dự án — không phải một phiên trò chuyện. Nó hoạt động như mặt phẳng điều khiển cục bộ cho workspace, hướng dẫn, trạng thái, hàng đợi, ngân sách và quy tắc phê duyệt của dự án.

Một số quyết định thiết kế then chốt:

• Agent sở hữu dự án — duy trì trạng thái có cấu trúc, quyết định, bài học và lịch sử phiên để việc lập kế hoạch và trách nhiệm nằm ở một nơi.
• Cô lập — sandbox ở cấp hệ điều hành (người dùng sandbox Windows, macOS Seatbelt, Linux bubblewrap đang trong kế hoạch).
• Bộ chặn đóng-khi-lỗi (fail-closed interceptor) — mọi lỗi trong hệ thống phê duyệt đều dẫn đến TỪ CHỐI, không bao giờ CHO PHÉP.
• Daemon đơn nhất — tệp PID ngăn chặn nhiều phiên bản chạy đồng thời.
• Ưu tiên cục bộ — tệp tin và trạng thái dự án nằm trên đĩa của bạn. Relay đám mây chỉ chuyển tiếp phê duyệt và sự kiện, không chuyển tiếp tệp tin.

Giấy phép và minh bạch

Orbital phát hành theo giấy phép GNU General Public License v3.0. Về quyền riêng tư, công cụ gửi một bản tổng hợp ẩn danh mỗi ngày — chỉ gồm bộ đếm, enum và giá trị boolean. Không bao giờ gửi prompt, tệp tin, đường dẫn, đầu ra mô hình hay bất kỳ định danh dự án/phiên nào. Bạn có thể xem chính xác JSON gửi đi trong phần Cài đặt → Dữ liệu & quyền riêng tư, nơi có một công tắc để tắt hoàn toàn.

Ý nghĩa với người dùng Việt Nam

Với cộng đồng lập trình viên Việt Nam — những người ngày càng sử dụng nhiều công cụ AI lập trình như Claude Code, Cursor hay Copilot — Orbital giải quyết một điểm đau thực tế: chi phí và hạn mức của các dịch vụ AI khá đắt đỏ, và việc mất ngữ cảnh khi chuyển đổi công cụ gây lãng phí đáng kể.

Việc Orbital là mã nguồn mở, chạy cục bộ và hỗ trợ nhiều nhà cung cấp LLM — bao gồm các lựa chọn giá rẻ hơn như DeepSeek hay các mô hình tự lưu trữ qua Ollama — mở ra khả năng tối ưu chi phí đáng kể cho các nhóm phát triển phần mềm trong nước. Bạn có thể dùng mô hình đắt tiền cho các tác vụ phức tạp và mô hình rẻ cho các việc đơn giản, mà vẫn giữ được mạch ngữ cảnh xuyên suốt dự án.

Mọi agent đều sở hữu một phiên làm việc. Orbital sở hữu dự án.