@raindrop-ai/claude-code

Raindrop observability for Claude Code CLI. Automatic session, tool call, and prompt tracing via Claude Code's native hooks system.

Install

npm install -g @raindrop-ai/claude-code

Setup

raindrop-claude-code setup

This saves your write key and configures Claude Code hooks. Every session will now send telemetry to your Raindrop dashboard.

Hooks are synchronous by default for headless/one-shot compatibility (claude -p). Use --async if you prefer non-blocking hooks in interactive mode.

What gets tracked

• Every prompt turn as a separate event, grouped by session
• Tool calls with inputs, outputs, and real durations
• Token usage per turn and per session (input, output, cache read, cache creation)
• Model name, service tier, and stop reason
• CLAUDE.md and rules file contents
• --append-system-prompt / --append-system-prompt-file content (best-effort)
• Subagent spawns and completions
• Permission denials and context compaction
• Self-diagnostics — agent-reported issues via MCP tool, with customizable signal categories
• Nested trace view (tools under root, subagent tools under subagent)
• Claude's responses and errors

Custom Properties

Tag events with product names or custom metadata via .claude/settings.json:

{
  "env": {
    "RAINDROP_EVENT_NAME": "design-agent",
    "RAINDROP_PROPERTIES": "{\"product\":\"design\",\"team\":\"ai\"}"
  }
}

Custom Self-Diagnostics Signals

Replace the built-in signal categories with your own via ~/.config/raindrop/config.json:

{
  "self_diagnostics": {
    "signals": {
      "billing_complaint": { "description": "User billing issue.", "sentiment": "NEGATIVE" },
      "feature_request": { "description": "User wants a feature.", "sentiment": "POSITIVE" }
    },
    "guidance": "Only report billing if explicitly mentioned."
  }
}

Or via env var: RAINDROP_SELF_DIAGNOSTICS='{"signals":{...}}'

Debugging

raindrop-claude-code debug-on    # logs hook output to /tmp/raindrop-hooks.log
raindrop-claude-code debug-off   # disables logging

Docs

Full documentation: docs.raindrop.ai/sdk/claude-code