raindrip is an AI-native command-line interface (CLI) designed specifically for seamless interaction with Raindrop.io, enhancing automation and agent-based operations.

Key Features

• AI-Native Design: By default, raindrip outputs in the TOON format, optimizing token usage and ensuring efficient data processing for AI agents.
• Situation Reports: Offers high-level command overviews through the context command, providing quick insights into the current state of your bookmarks.
• Hierarchy Support: Easily create, manage, and organize nested collections for better bookmark organization.
• Batch Operations: Perform bulk updates or deletions of bookmarks, streamlining your management tasks.

Advantages of raindrip

raindrip is built specifically for agents and automation scripts rather than traditional human-friendly interfaces:

1. Tabular Efficiency: The TOON structure minimizes redundant overhead, making it ideal for handling extensive bookmark lists.
2. Context-First: Commands like context and structure are tailored to provide AI models with all necessary information in a single response.
3. Smart Hints: Error messages are enhanced with hints, guiding agents on how to resolve issues effectively.
4. Dry Run Capability: The global --dry-run flag enables safe account management without making unintended changes.

Quick Start

• Login: Verify and store your token with:

  raindrip login
  

• Get Account Overview: Obtain a situational report of your agent's bookmarks using:

  raindrip context
  

Usage Examples

• List Collections & Tags: Retrieve the structure of collections and tags with:

  raindrip structure
  

• Search Bookmarks: Execute searches using multiple formats:

  raindrip search "python"             # TOON (Default)
  raindrip search "python" --pretty    # Pretty table for human readability
  raindrip search "python" --format json  # Standard JSON output
  

• Manage Collections: Create a new collection and set icons with:

  raindrip collection create "Research"
  raindrip collection set-icon <id> "robot"
  

• Perform Batch Operations: Move multiple bookmarks efficiently:

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

• Get Schema: Retrieve the schema for AI system prompts with:

  raindrip schema
  

Designed to cater to the needs of modern automation tasks, raindrip stands out as a powerful tool for managing bookmarks and simplifying interactions with Raindrop.io.