Ravenclaw - Hệ thống mã nguồn mở quản lý ngữ cảnh công việc của các AI coding agent

Tổng quan

Trong quá trình sử dụng các AI coding agent (Claude Code, Gemini CLI, Codex, v.v.) cho nhiều dự án, tôi đã gặp hai vấn đề.

1. Đổi agent là mất ngữ cảnh

Khi đang làm việc với Claude Code rồi chuyển sang Gemini CLI, tôi phải giải thích lại từ đầu những gì đã làm trước đó. Ngay cả với cùng một agent, khi phiên làm việc kết thúc thì tình trạng cũng tương tự. Tôi liên tục phải lục lại lịch sử hội thoại trong terminal theo từng dự án và lặp đi lặp lại kiểu “đã làm tới đây rồi, tiếp theo là cái này”.

2. Chạy song song nhiều dự án khiến đầu óc quá tải

Khi làm đồng thời 3-4 dự án, chỉ riêng việc nắm được mỗi dự án đang tiến tới đâu cũng đã trở thành một công việc. Việc chuyển qua lại giữa các tab terminal và cuộn lịch sử hội thoại có giới hạn rất rõ ràng.

Ravenclaw được tạo ra để giải quyết vấn đề này.

Ý tưởng cốt lõi

Quản lý tập trung ngữ cảnh công việc của agent.

Dù dùng agent nào (Claude Code, Gemini CLI, Codex), ngữ cảnh công việc đều được tích lũy trong Ravenclaw. Ngay cả khi đổi agent hoặc phiên làm việc bị ngắt, bạn vẫn có thể dùng công cụ MCP trong phiên mới để tải lại nguyên trạng tình hình trước đó. Hệ thống không phụ thuộc vào một agent cụ thể.

Trong web UI, bạn có thể nhìn toàn cảnh cấu trúc epic/issue theo từng dự án, graph view và tiến độ, nên có thể ngay lập tức nắm được “dự án này hiện đang đến đâu rồi?” mà không cần xem lại lịch sử terminal.

Hệ thống dành cho agent, không phải cho con người

Ticket (issue/epic) và wiki của Ravenclaw trông có vẻ giống Jira hay Linear, nhưng đối tượng sử dụng chính lại khác.

• Agent là bên tạo issue, thay đổi trạng thái và viết wiki
• Con người có vai trò kiểm tra bức tranh tổng thể trên web UI, bổ sung giải thích khi cần hoặc định hướng bằng comment
• Khi agent gặp tình huống cần phán đoán, nó sẽ gửi Human Input Request và người dùng trả lời trên web

Để agent có thể truy cập theo cách lập trình, hệ thống cung cấp hơn 40 công cụ qua giao thức MCP, và mọi chức năng cũng đều có thể dùng qua CLI và REST API.

Tính năng chính

• Web chat: chỉ thị trực tiếp cho agent trong trình duyệt, phản hồi streaming theo thời gian thực
• Tính liên tục của hội thoại: tận dụng claude --resume, lưu lịch sử hội thoại vào DB
• Trực quan hóa dự án: nắm cấu trúc epic/issue và tiến độ trong graph view chỉ trong nháy mắt
• Context snapshot: agent lưu tiến độ công việc để tiếp tục ở phiên sau
• Kiểm soát quyền hạn: khi chạy agent có thể chọn auto-approve / bypass / accept-edits
• Multi-agent: chọn Claude Code, Gemini CLI hoặc Codex để làm việc trên cùng một dự án

Tech stack

Monorepo TypeScript (pnpm workspaces)

• API: Hono + PostgreSQL (Drizzle ORM)
• Web: React + Tailwind + ReactFlow
• Tích hợp agent: MCP Protocol (40+ công cụ)
• CLI: Commander.js
• Kiểm thử: Playwright E2E (14 mục)

Cài đặt

git clone https://github.com/chainofdive/ravenclaw.git  
cd ravenclaw && pnpm install && pnpm build  
docker-compose up -d && pnpm db:push  

Self-hosted, chỉ cần PostgreSQL là đủ. Giấy phép Apache 2.0.

Trên thực tế, tôi đang dùng chính hệ thống này để quản lý song song nhiều side project cùng với AI agent. Rất hoan nghênh mọi phản hồi hay câu hỏi.

GitHub: https://github.com/chainofdive/ravenclaw