⚠️ Experimental: This wizard is still in an experimental phase. The wizard only works with TypeScript and Python integrations and only works reliably for integrating the tracing feature to see your AI interactions on raindrop.

ℹ️ Acknowledgement: This project is a fork of PostHog's wizard.

raindrop.ai wizard ✨

The raindrop.ai wizard helps you quickly add raindrop.ai to your project using AI.

Demo flow

1. Demonstrate 3 OpenAI Agents (Typescript, Python, unknown) without raindrop.ai integration
2. Run wizard command for those Agents
3. Consent to AI use
4. Typescript and Python will be automatically detected. For unknown, user will be prompted.
5. After integration is complete, show that chat interactions now show up on raindrop.ai

Usage

To use the wizard, you can run it directly using:

npx @raindrop/wizard

Currently the wizard can be used for Python and TypeScript projects. If you have other integrations you would like the wizard to support, please open a GitHub issue!

Options

The following CLI arguments are available:

Option	Description	Type	Default	Choices	Environment Variable
--help	Show help	boolean
--version	Show version number	boolean
--debug	Enable verbose logging	boolean	false		RAINDROP_DEBUG
--default	Use default options for all prompts	boolean	false		RAINDROP_DEFAULT
--integration	Integration to set up	string		"python", "typescript"
--force-install	Force install packages even if peer dependency checks fail	boolean	false		RAINDROP_FORCE_INSTALL
--install-dir	Directory to install raindrop.ai in	string			RAINDROP_INSTALL_DIR
--api-key	Raindrop write key (phx_xxx) for authentication	string			RAINDROP_WRITE_KEY

Note: A large amount of the scaffolding for this came from the amazing Sentry wizard, which you can find here 💖

Requirements

The wizard requires the ANTHROPIC_API_KEY environment variable to be set. This is used to authenticate with the Claude API for the AI agent that performs the integration.

export ANTHROPIC_API_KEY=your_api_key_here
npx @raindrop/wizard

Agent Integration

The wizard uses the Claude Agent SDK to intelligently modify your project. The agent prompt is built in src/lib/agent-runner.ts and includes framework-specific documentation to guide the integration process.

The agent uses the ANTHROPIC_API_KEY environment variable to authenticate with Claude's API.

Running locally

Quick test without linking

pnpm try --install-dir=[a path]

Development with auto-rebuild

pnpm run dev

This builds, links globally, and watches for changes. Leave it running - any .ts file changes will auto-rebuild. Then from any project:

wizard --integration=typescript