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

> Clean Markdown view of GeekNews topic #28225. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=28225](https://news.hada.io/topic?id=28225)
- GeekNews Markdown: [https://news.hada.io/topic/28225.md](https://news.hada.io/topic/28225.md)
- Type: show
- Author: [aeolian21](https://news.hada.io/@aeolian21)
- Published: 2026-04-05T21:54:01+09:00
- Updated: 2026-04-05T21:54:01+09:00
- Original source: [github.com/chainofdive](https://github.com/chainofdive/ravenclaw)
- Points: 3
- Comments: 0

## Topic Body

#### 개요  
  
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개)  
  
#### 설치  
  
```  
git clone https://github.com/chainofdive/ravenclaw.git  
cd ravenclaw && pnpm install && pnpm build  
docker-compose up -d && pnpm db:push  
```  
  
Self-hosted, PostgreSQL만 있으면 됩니다. Apache 2.0 라이선스.  
  
실제로 이 시스템으로 여러 사이드 프로젝트를 AI 에이전트와 함께 병렬 관리하고 있습니다. 피드백이나 질문 환영합니다.  
  
GitHub: https://github.com/chainofdive/ravenclaw

## Comments



_No public comments on this page._