Show GN: Ravenclaw - AI 코딩 에이전트의 작업 컨텍스트를 관리하는 오픈소스 시스템

개요

AI 코딩 에이전트(Claude Code, Gemini CLI, Codex 등)를 여러 프로젝트에서 활용하면서 두 가지 문제를 겪었습니다.

1. 에이전트를 바꾸면 맥락이 사라진다

Claude Code로 작업하다가 Gemini CLI로 전환하면, 이전에 뭘 했는지 처음부터 다시 설명해야 합니다. 같은 에이전트라도 세션이 끝나면 마찬가지입니다. 프로젝트별로 터미널 대화 기록을 뒤져가며 "여기까지 했고, 다음은 이거야"를 반복하게 됩니다.

2. 여러 프로젝트를 병렬로 진행하면 머릿속이 터진다

3-4개 프로젝트를 동시에 진행하면, 각 프로젝트가 어디까지 진행됐는지 파악하는 것 자체가 일이 됩니다. 터미널 탭을 전환하며 대화 기록을 스크롤하는 건 한계가 있습니다.

Ravenclaw는 이 문제를 해결하기 위해 만들었습니다.

핵심 아이디어

에이전트의 작업 맥락을 중앙에서 관리합니다.

어떤 에이전트를 쓰든(Claude Code, Gemini CLI, Codex) 작업 컨텍스트는 Ravenclaw에 쌓입니다. 에이전트를 교체하거나 세션이 끊겨도, 새 세션에서 MCP 도구로 이전 상황을 그대로 로드할 수 있습니다. 특정 에이전트에 종속되지 않습니다.

웹 UI에서는 프로젝트별 에픽/이슈 구조, 그래프 뷰, 진행률을 한눈에 볼 수 있어서 "지금 이 프로젝트 어디까지 왔지?"를 터미널 기록 없이 바로 파악할 수 있습니다.

사람이 아닌 에이전트를 위한 시스템

Ravenclaw의 티켓(이슈/에픽)과 위키는 Jira나 Linear와 비슷해 보이지만, 주 사용자가 다릅니다.

• 이슈를 만들고, 상태를 바꾸고, 위키를 작성하는 건 에이전트입니다
• 사람은 웹 UI에서 전체 상황을 확인하고, 필요할 때 설명을 추가하거나 코멘트로 방향을 잡아주는 역할입니다
• 에이전트가 판단이 필요한 상황에서 Human Input Request를 보내면, 웹에서 답변합니다

에이전트가 프로그래밍적으로 접근하도록 MCP 프로토콜로 40개 이상의 도구를 제공하고, CLI와 REST API로도 모든 기능을 사용할 수 있습니다.

주요 기능

• 웹 채팅: 브라우저에서 에이전트에게 직접 지시, 실시간 스트리밍 응답
• 대화 연속성: claude --resume 활용, 대화 히스토리 DB 저장
• 프로젝트 시각화: 그래프 뷰에서 에픽/이슈 구조와 진행률 한눈에 파악
• 컨텍스트 스냅샷: 에이전트가 작업 진행 상황을 저장, 다음 세션에서 이어받기
• 권한 제어: 에이전트 실행 시 auto-approve / bypass / accept-edits 선택
• 멀티 에이전트: Claude Code, Gemini CLI, Codex 중 선택하여 동일 프로젝트에서 작업

기술 스택

TypeScript 모노레포 (pnpm workspaces)

• API: Hono + PostgreSQL (Drizzle ORM)
• Web: React + Tailwind + ReactFlow
• Agent 연동: MCP Protocol (40+ 도구)
• CLI: Commander.js
• 테스트: Playwright E2E (14개)

설치

Self-hosted, PostgreSQL만 있으면 됩니다. Apache 2.0 라이선스.

실제로 이 시스템으로 여러 사이드 프로젝트를 AI 에이전트와 함께 병렬 관리하고 있습니다. 피드백이나 질문 환영합니다.

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