Skip to main content
Run in your AI project directory: 
npx @raindrop-ai/wizard@latest
The Raindrop Installation Wizard will automatically setup Raindrop by instrumenting your agent’s AI calls.
Run on a new branch. We recommend creating a new git branch before starting the Wizard so you can review the changes it makes before merging.

​
Walkthrough

​
Create a Raindrop account

When you sign up for Raindrop, you’ll see the default onboarding flow. You can skip this and go directly to your Raindrop dashboard since the Wizard will do this step automatically.
Skip onboarding to access the Raindrop dashboard

​
Installation Steps

1

Authorize Raindrop Wizard

Start the Wizard in your AI project directory using npx @raindrop-ai/wizard@latest and authenticate with your Raindrop account. The Wizard will retrieve your RAINDROP_WRITE_KEY.
Authenticate with Raindrop and set up the SDK
2

Agent Run

The Wizard scans your codebase for AI features and instruments your main AI features by using the best Raindrop SDK.
Wizard runs an agent
3

Send Events

To validate that your integration works, send a message to your AI agent. Within a couple seconds, confirm that the event appears in the Wizard, and click the link to the Raindrop dashboard.
Send events and validate them directly in the Wizard or on Raindrop
4

Provide feedback (optional)

If something doesn’t look right, you can provide feedback and the Wizard will review your event data. For example: “Nothing is showing up”, “Tool calls aren’t being traced”, “Use username instead for userid”, or “Can you also add email to properties?”

​
How it works

The Wizard runs a Claude Agent SDK agent on your machine. We provide the agent with our documentation as well as instructions for it’s execution flow. It uses Anthropic’s preToolUse hook to block access to sensitive files (.env, .pem, .key, credentials, etc.).
If the Wizard didn’t integrate successfully, contact us and we’ll pick up where it left off.