AI-native CLI for Raindrop.io.

Designed for AI agents and automation scripts. TOON for maximum token efficiency, with optional JSON output for standard integrations.

• 🤖 AI-Native: Outputs TOON format by default to save on context tokens.
• 📊 Situation Reports: High-level context command for a quick "state of the world" overview.
• 📂 Hierarchy Support: Create, move, and manage nested collections.
• 📦 Batch Operations: Bulk update or delete bookmarks efficiently.

Traditional CLIs are built for humans to read. raindrip is built for agents and automation scripts to consume.

1. Tabular Efficiency: TOON's structure handles large bookmark lists without the repetitive key-value overhead of JSON.
2. Context-First: Commands like context and structure are designed to give an LLM exactly what it needs to understand your library in one shot.
3. Smart Hints: Error messages include "hint" fields that tell agents exactly how to fix the issue.
4. Dry Run: Safe account management with a global --dry-run flag.

uv tool install .

1. Login (Verifies token before saving)

Get a test token from https://app.raindrop.io/settings/integrations

```bash
raindrip login
```

2. Account Overview (The agent "situation report")

   raindrip context

• List Collections & Tags

  raindrip structure

• Search Bookmarks

  # TOON (Default)
  raindrip search "python"
  # Beautiful table for humans
  raindrip search "python" --pretty
  # Standard JSON
  raindrip search "python" --format json

• Collection Management

  raindrip collection create "Research"
  # Set icon from Raindrop's library
  raindrip collection set-icon <id> "robot"

• Batch Operations

  # Move bookmarks in bulk
  raindrip batch update --ids 1,2,3 '{"collection": {"$id": <target_id>}}'

• Get Schema (For AI system prompts)

  raindrip schema

# Run tests
uv run pytest tests/