OpenChamber - Giao diện quản lý cho OpenCode AI agent trên Desktop và Web

Tóm tắt:

OpenChamber là giao diện đồ họa mã nguồn mở (GUI) đa nền tảng, hỗ trợ Desktop (macOS), Web, PWA, và VS Code Extension.

Kết nối trực tiếp với OpenCode AI agent thông qua API cục bộ, không phụ thuộc vào bất kỳ dịch vụ đám mây bên thứ ba nào.

Hỗ trợ tự lưu trữ (self-hosted) hoàn toàn, toàn quyền kiểm soát dữ liệu và phiên làm việc.

Tích hợp sâu với Git, GitHub, terminal tích hợp, trình xem diff và chế độ đa agent song song.

Triển khai linh hoạt qua npm/bun, Docker hoặc script cài đặt tự động, yêu cầu Node.js 20+.

Tại sao giao diện đồ họa lại quan trọng với AI agent mã nguồn mở

Trong vài năm gần đây, các AI coding agent như OpenCode đã chứng minh năng lực vượt trội trong việc tự động hóa các tác vụ lập trình phức tạp – từ viết code, review diff, đến quản lý pull request trên GitHub. Tuy nhiên, hầu hết các agent này đều giao tiếp chủ yếu qua TUI (Terminal User Interface) hoặc dòng lệnh, tạo ra rào cản đáng kể với những nhà phát triển muốn quan sát toàn bộ luồng hoạt động của agent trong thời gian thực.

Một giao diện đồ họa không chỉ đơn giản là “bọc” giao diện terminal bằng cửa sổ trực quan. Đối với AI agent orchestration, GUI giải quyết ba vấn đề cốt lõi:

Quan sát trạng thái: Theo dõi song song nhiều agent, xem lịch sử hội thoại có thể phân nhánh.
Kiểm soát tương tác: Phê duyệt, hủy, hoặc chỉnh sửa hành động của agent ngay trong luồng làm việc.
Tính liên tục đa thiết bị: Bắt đầu phiên làm việc trên máy tính, tiếp tục trên điện thoại hoặc tablet mà không mất ngữ cảnh.

OpenChamber xuất hiện như một câu trả lời trực tiếp cho những nhu cầu đó – một “buồng điều khiển” (chamber) thực sự cho OpenCode AI agent.

Kiến trúc và tính năng của OpenChamber

OpenChamber được xây dựng theo kiến trúc client-server phân tách rõ ràng: phần server (Node.js) khởi động và kết nối với tiến trình OpenCode CLI chạy nền, trong khi phần client hiển thị giao diện người dùng trên nhiều nền tảng khác nhau.

Hai chế độ giao diện chính

Nền tảng	Công nghệ	Ưu điểm nổi bật
Desktop (macOS)	Tauri	Tích hợp menu macOS native, multi-window, kết nối SSH tới instance từ xa
Web / PWA	Node.js + browser	Truy cập từ bất kỳ thiết bị nào, hỗ trợ mobile-first, cài đặt như ứng dụng nội địa
VS Code Extension	Webview + API	Mở file trực tiếp từ kết quả tool, chạy multi-agent trong editor

Phiên bản Desktop (hiện hỗ trợ macOS, với Windows và Linux đang trong lộ trình phát triển) cung cấp tính năng kết nối tới các instance OpenChamber từ xa qua SSH, cùng với luồng khởi động theo workspace và khả năng mở nhanh trong Finder, Terminal hoặc editor ưa thích. Phiên bản Web/PWA ưu tiên tính di động, với bố cục tối ưu cho bàn phím ảo và khả năng nhận thông báo nền, rất phù hợp để giám sát agent đang chạy dài hơi từ xa.

Hệ thống quản lý phiên và luồng AI

Một trong những tính năng kỹ thuật đáng chú ý nhất của OpenChamber là branchable chat timeline – lịch sử hội thoại có thể phân nhánh. Thay vì hội thoại tuyến tính thông thường, người dùng có thể:

Sử dụng /undo và /redo để điều hướng lịch sử.
Fork từ bất kỳ điểm nào trong lịch sử để khám phá hướng tiếp cận khác mà không mất ngữ cảnh hiện tại.
Chạy multi-agent từ một prompt duy nhất với isolated worktrees để so sánh kết quả song song một cách an toàn.

Tính năng Plan/Build mode cho phép soạn thảo và lặp qua các bước triển khai trước khi giao cho agent thực thi, hỗ trợ thêm inline comment trực tiếp trên diff, file, và kế hoạch để gửi phản hồi ngược lại agent.

Tích hợp Git và GitHub native

OpenChamber tích hợp sâu vào quy trình Git với sidebar đầy đủ chức năng: staging, commit, push/pull, quản lý nhánh, rebase và merge. Đặc biệt hơn, người dùng có thể:

Khởi động phiên làm việc trực tiếp từ GitHub Issues hoặc Pull Request với ngữ cảnh đã được nạp sẵn.
Tạo PR với mô tả do AI sinh ra, theo dõi status checks và thực hiện merge ngay trong ứng dụng.
Quản lý nhiều remote, fork-aware PR creation và tích hợp worktree cho phiên làm việc cô lập theo nhánh.

Cài đặt OpenChamber trên môi trường cục bộ

Điều kiện tiên quyết: Cài đặt OpenCode CLI trước khi tiến hành bất kỳ phương thức nào dưới đây.

Cài đặt qua script tự động (Web + PWA)

Đây là phương thức nhanh nhất cho môi trường Linux/macOS, yêu cầu Node.js 20+:

curl -fsSL https://raw.githubusercontent.com/btriapitsyn/openchamber/main/scripts/install.sh | bash
openchamber --ui-password your-secure-password --daemon

Sau khi chạy lệnh trên, OpenChamber sẽ khởi động server ở chế độ nền và giao diện web có thể truy cập tại http://localhost:3000.

Cài đặt qua npm hoặc bun (phiên bản mới nhất)

# Dùng npm
npm i -g @openchamber/[email protected]

# Hoặc dùng bun
bun add -g @openchamber/[email protected]

# Khởi động với port tùy chỉnh
openchamber --port 8080 --ui-password your-secure-password

Cài đặt bằng Docker Compose (khuyến nghị cho môi trường server)

Tạo thư mục dữ liệu và phân quyền trước khi chạy container:

mkdir -p data/openchamber data/opencode/share data/opencode/config data/ssh
chown -R 1000:1000 data/

Sau đó khởi động bằng Docker Compose:

docker compose up -d

Cấu hình biến môi trường trong docker-compose.yml để bảo vệ giao diện và tùy chọn bật Cloudflare Tunnel:

environment:
  UI_PASSWORD: your_secure_password
  CF_TUNNEL: "qr"   # Giá trị: true | qr | password

Giá trị `CF_TUNNEL`	Hành vi
`true`	Bật tunnel, không hiển thị thêm thông tin
`qr`	Bật tunnel và hiển thị mã QR để kết nối nhanh
`password`	Bật tunnel và nhúng mật khẩu vào URL kết nối

Cài đặt phiên bản Desktop (macOS)

Tải bản phân phối mới nhất từ GitHub Releases. Lưu ý: người dùng đang chạy phiên bản cũ cần tải lại và cài đặt lại v1.8.6 trở lên do khóa ký auto-update đã được xoay vòng sau khi repository chuyển sang tổ chức.

Hướng dẫn sử dụng và cấu hình OpenChamber

Kết nối với OpenCode agent

OpenChamber mặc định tự khởi động tiến trình OpenCode CLI khi server chạy. Để kết nối với một instance OpenCode đang chạy riêng biệt, sử dụng biến môi trường:

# Kết nối qua port tùy chỉnh
OPENCODE_PORT=4096 OPENCODE_SKIP_START=true openchamber

# Kết nối qua host và HTTPS tùy chỉnh
OPENCODE_HOST=https://myhost:4096 OPENCODE_SKIP_START=true openchamber

Cấu hình API key và model

Sau khi truy cập giao diện web tại http://localhost:3000, điều hướng tới Settings để:

Nhập API key cho các nhà cung cấp model (Anthropic, OpenAI, Google, v.v.) – các key này được lưu trữ cục bộ, không truyền ra ngoài.
Chọn model mặc định và cấu hình favorite model cycling qua phím tắt.
Thiết lập tunnel Cloudflare tại Settings > OpenChamber > Tunnel nếu cần truy cập từ xa.

Giao diện theo dõi token usage và cost breakdown theo thời gian thực, hỗ trợ theo dõi hạn mức sử dụng trên nhiều nhà cung cấp với chỉ số dự báo tốc độ tiêu thụ.

Thực thi lệnh lập trình đầu tiên qua giao diện

Quy trình làm việc cơ bản:

Tại màn hình chính, chọn hoặc tạo Project mới bằng cách chỉ định thư mục làm việc.
Nhập prompt mô tả tác vụ vào ô chat – ví dụ: "Viết unit test cho file utils.ts và tạo PR mô tả tự động".
OpenChamber hiển thị Tool Output trực quan: các thay đổi file xuất hiện ngay trong diff viewer với chế độ xem stacked hoặc inline.
Xem xét diff, thêm inline comment nếu cần điều chỉnh, sau đó gửi phản hồi ngược lại agent.
Khi hài lòng, thực hiện commit và tạo PR trực tiếp từ Git sidebar mà không cần rời khỏi giao diện.

Để chạy lệnh shell nhanh trong phiên làm việc, bắt đầu tin nhắn bằng ký tự !:

! npm run build

Kết quả hiển thị inline trong luồng hội thoại, cho phép agent đọc output và điều chỉnh ngay lập tức.

Tổng quan kiến trúc triển khai

[Người dùng]
     |
     | (Browser / Desktop App / VS Code)
     v
[OpenChamber Server] <---> [OpenCode CLI Process]
     |                           |
     | REST/WS API               | LLM API Calls
     v                           v
[Giao diện Web/PWA]    [Anthropic / OpenAI / Google...]
     |
     | (Tùy chọn)
     v
[Cloudflare Tunnel] --> [Truy cập từ xa / Mobile]

Luồng dữ liệu này hoàn toàn nằm trong tầm kiểm soát của người vận hành: API key, lịch sử phiên, cấu hình workspace đều được lưu trong thư mục ~/.config/openchamber/ trên máy cục bộ hoặc volume Docker tương ứng.

Lộ trình phát triển và hệ sinh thái

OpenChamber hiện được phát triển tích cực với các tính năng đang trong lộ trình bao gồm: ứng dụng Desktop cho Windows và Linux, ứng dụng mobile với khả năng kết nối instance từ xa, Kanban board để quản lý đa agent, tích hợp Linear và catalog plugin/tool tùy chỉnh cho OpenCode.

Dự án được niêm yết chính thức trong hệ sinh thái OpenCode, phát hành dưới giấy phép MIT, và chấp nhận đóng góp từ cộng đồng thông qua CONTRIBUTING.md.

Đối với các nhà phát triển và kỹ sư AI đang vận hành OpenCode trong môi trường tự lưu trữ, OpenChamber cung cấp lớp giao diện còn thiếu để biến agent dòng lệnh thành một hệ thống lập trình AI có thể quan sát và điều khiển toàn diện – từ terminal đến trình duyệt, từ máy tính bàn đến thiết bị di động.

Duy Nghiện

Hãy làm khán giả, đừng làm nhân vật chính :)