The local debugger your agent is missing. Watch your agent think locally, the moment it happens: every token, every tool call, every decision.
Give Claude Code the power to read your traces, write evals against your codebase, and fix what's broken.
Install
curl -fsSL https://raindrop.sh/install | bashBuild from source
git clone https://github.com/raindrop-ai/workshop.git
cd workshop
bun install
bun run devbun run dev starts the local Workshop daemon and Vite UI. Open
http://localhost:5899 after it starts.
Instrument your agent
Open your coding agent of choice in your repository and run:
This will instrument your agent with Raindrop tracing and open Workshop in your browser.
That's it. Traces stream into the UI the moment your agent runs.
What it does
- Live streamed traces. Every token, tool call, and span streams into Workshop as it happens. No polling, no refreshing.
- Coding-agent integration. Claude Code reads your traces, writes evals against your codebase, and fixes what's broken.
- Self-healing eval loop. Claude writes the eval, runs your agent, sees the failure, fixes the code, and re-runs — until every assertion passes.
- Local replay.
/setup-agent-replayscaffolds an HTTP endpoint that replays a production trace against your real agent code.
Compatible with everything
- Languages: TypeScript, Python, Go, Rust
- SDKs: Vercel AI SDK, OpenAI Agents SDK, Anthropic SDK, Claude Agent SDK, LangChain, LangGraph, CrewAI, Mastra, Pydantic AI, DSPy, Google ADK, Strands, Agno, Deep Agents
- Providers: AWS Bedrock, Azure OpenAI, Vertex AI
- Coding agents: Claude Code, Codex, Devin, Cursor, OpenCode
Configuration
| Env var | Purpose | Default |
|---|---|---|
RAINDROP_WORKSHOP_PORT |
HTTP + WS port | 5899 |
RAINDROP_WORKSHOP_DB_PATH |
SQLite database file | ~/.raindrop/raindrop_workshop.db |
RAINDROP_LOCAL_DEBUGGER |
SDK-side: where to mirror traces | unset |
CLI
raindrop workshop # start and open UI raindrop workshop setup # write .env, then start and open raindrop workshop status # check health raindrop workshop reset # delete local DB after confirmation raindrop update # update the binary
License
MIT.
