Raindrop Workshop GitHub 저장소

Raindrop Workshop은 에이전트가 생성하는 모든 토큰, tool call, span을 로컬에서 실시간으로 보여주는 디버거다. Claude Code 같은 coding agent가 trace를 읽고, 코드베이스를 대상으로 eval을 작성해 문제를 찾고 고치도록 연결한다.

설치는 curl -fsSL https://raindrop.sh/install | bash 한 줄로 가능하고, 소스에서 직접 돌릴 때는 git clone 뒤 bun install, bun run dev를 실행한다. 그러면 로컬 Workshop daemon과 Vite UI가 함께 뜨며, http://localhost:5899에서 확인할 수 있다.

에이전트 쪽에서는 /instrument-agent를 실행해 Raindrop tracing을 붙이고 브라우저로 Workshop을 연다. 이후 trace는 UI로 즉시 스트리밍되며, 수동 새로고침이나 폴링이 필요 없다.

핵심 기능은 다음과 같다.

• Live streamed traces: 토큰, tool call, span을 발생 즉시 UI에 반영한다.
• Coding-agent integration: Claude Code가 trace를 읽고 eval을 작성한 뒤 실패를 수정한다.
• Self-healing eval loop: eval 작성, 에이전트 실행, 실패 확인, 코드 수정, 재실행을 반복해 assertion이 모두 통과할 때까지 돌린다.
• Local replay: /setup-agent-replay로 production trace를 실제 agent 코드에 재생하는 HTTP endpoint를 만든다.

지원 범위도 넓다. TypeScript, Python, Go, Rust를 지원하고, Vercel AI SDK, OpenAI Agents SDK, Anthropic SDK, Claude Agent SDK, LangChain, LangGraph, CrewAI, Mastra, Pydantic AI, DSPy, Google ADK, Strands, Agno, Deep Agents와 호환된다. 실행 환경은 AWS Bedrock, Azure OpenAI, Vertex AI까지 포함하며, coding agent로는 Claude Code, Codex, Devin, Cursor, OpenCode를 지원한다.

설정은 RAINDROP_WORKSHOP_PORT(기본 5899), RAINDROP_WORKSHOP_DB_PATH(기본 ~/.raindrop/raindrop_workshop.db), RAINDROP_LOCAL_DEBUGGER로 제어한다. CLI에는 raindrop workshop, raindrop workshop setup, raindrop workshop status, raindrop workshop reset, raindrop update가 있다.