An infinite canvas for learning — select text, ask, and answers branch out as documents. MCP server for Claude Code, Codex, and any agent.

Rabbithole – 학습을 위한 무한하고 AI 기반의 캔버스

무엇인가요 – Rabbithole은 선택한 LLM(예: Claude Code, Codex, OpenAI 호환 엔드포인트)이 답변하는 문서의 분기형 "캔버스"를 생성할 수 있는 가벼운 웹 앱입니다. 문서를 시작으로 하여 어느 지점에서든 질문을 던지면, 답변이 새로운 연결된 문서로 생성되어, 각각이 자가 포함된 HTML 페이지로 구성된 트리 구조로 아이디어를 탐색할 수 있습니다.

왜 중요한가요 – 설정이 필요 없는 프론트엔드와 유연한 백엔드(MCP 서버)를 결합하여 Claude Code, Codex, OpenAI 호환 엔드포인트 또는 로컬에서 실행하는 사용자 정의 모델과 통신할 수 있습니다. 모든 데이터는 귀하의 기계에만 저장되며, 계정, 텔레메트리, 클라우드 스토리지 없이 사용 가능합니다.

핵심 개념

구성 요소	역할
웹 앱	순수 클라이언트 사이드 UI로 캔버스를 렌더링하고, 사용자가 설정한 모델 엔드포인트(OpenRouter, 로컬 OpenAI 호환 서버 등)로 프롬프트를 전달합니다.
MCP 서버	작은 Node.js 프로세스로 웹 UI와 "MCP 클라이언트"(예: Claude Code, Codex) 간을 매개합니다. 로컬에서 실행되며, `~/.rabbithole/`(또는 `RABBITHOLE_DIR`)에 문서를 저장하고, 도구 호출 라우팅을 처리합니다.
캔버스	HTML 스냅샷의 시리즈입니다. 각 스냅샷은 원본 콘텐츠에 추가 질문과 모델의 답변을 포함하며, 앞으로/뒤로 탐색할 수 있도록 연결되어 있습니다.

시작하기 (빠른 시작)

웹 버전 – https://rabbithole.ing 를 열고 질문, URL, Markdown 파일, 또는 PDF를 붙여넣습니다. UI는 설정한 모델에 프롬프트를 전송합니다.
Claude Code / Codex로 브리지 연결 – Claude Code 또는 Codex CLI가 설치되어 있고 로그인되어 있다면 다음을 실행하세요:
```
npx @shlokkhemani/rabbithole bridge
```
이 명령은 개인용 페어링 링크를 출력하고, 루프백 인터페이스를 통해 브라우저 페이지와 로컬 CLI를 연결합니다.
MCP 모드 – MCP 클라이언트(노드 18 이상 필요)를 설치하고 Rabbithole을 도구로 추가하세요:
```
# Claude Code
claude mcp add rabbithole -- npx -y github:shlokkhemani/rabbithole
# Codex
codex mcp add rabbithole -- npx -y github:shlokkhemani/rabbithole
```
이후 에이전트 세션을 시작하고 "이 문서를 Rabbithole에서 열어줘"라고 말하세요. 에이전트는 도구 호출을 보류한 채로 캔버스와 상호작용을 계속하며, MCP 서버가 요청을 지속적으로 유지하므로 연결을 끊고 나중에 다시 시작할 수 있습니다.

개발 및 기여

git clone https://github.com/shlokkhemani/rabbithole.git
cd rabbithole
npm install
npm run build   # 브라우저 번들 빌드
npm test        # 테스트 스위트 실행

리포지토리는 미리 빌드된 브라우저 번들을 포함하고 있으므로, npm에서 패키지를 설치하는 사용자는 컴파일 없이 바로 실행 가능한 웹 앱을 사용할 수 있습니다.

문서 요약

제품 및 아키텍처 투어 – docs/01-tour.md
생성된 모듈 및 명령 맵 – 도구 확장에 유용한 개발자용 (docs/generated/*).
호환성 계약 – 웹 앱이 모델 엔드포인트 및 MCP 클라이언트와 통신하는 방식을 정의 (docs/compatibility.md).
디자인 시스템 – 시각적 및 상호작용 가이드라인 (docs/design-system.md).

라이선스

MIT – LICENSE 파일을 참조하세요.

결론 – Rabbithole은 자체 호스팅형, 모델에 종속되지 않는 분기형 문서 UI로, 어떤 LLM 상호작용도 네비게이터 가능한 지식 맵으로 전환할 수 있으며, 모든 데이터는 로컬에 보관되어 귀하의 완전한 제어 하에 있습니다.

shlokkhemani/rabbithole