raindrop-cli

🔖 raindrop-cli - Raindrop in your terminal

A command-line interface for Raindrop.io bookmark management.

Installation

Homebrew

brew install dedene/tap/raindrop

From source

go install github.com/dedene/raindrop-cli/cmd/raindrop@latest

From releases

Download the latest binary from releases.

Authentication

Test token (personal use)

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

raindrop auth token <your-token>
raindrop auth status

Or use environment variable:

export RAINDROP_TOKEN=<your-token>

OAuth2 (apps/shared use)

1. Create an app at raindrop.io/app.
2. Set the redirect URI to http://localhost:8484/callback (or update oauth_port in config).
3. Save credentials:

raindrop auth setup <client_id>

1. Authenticate:

raindrop auth login

Quick Start

# Add a bookmark
raindrop add https://example.com
raindrop add https://example.com --collection Work --tags "reference,docs"

# List bookmarks
raindrop list
raindrop list --favorites
raindrop list Work --all

# Search
raindrop search "golang"
raindrop search --tag programming --type article

# Get details
raindrop get 12345

# Update
raindrop update 12345 --title "New Title" --tags "updated"

# Delete
raindrop delete 12345

Commands

Core

Collections

Tags

Highlights

Utility

Flags

Shell Completions

# Bash
eval "$(raindrop completion bash)"

# Zsh
eval "$(raindrop completion zsh)"

# Fish
raindrop completion fish > ~/.config/fish/completions/raindrop.fish

Configuration

Config file: ~/.config/raindrop-cli/config.yaml

raindrop config path
raindrop config get <key>
raindrop config set <key> <value>

System Collections

Collection names are case-insensitive: raindrop list Work or raindrop list work.

Bulk Operations

Add multiple URLs from stdin:

echo -e "https://a.com\nhttps://b.com" | raindrop add -

License

MIT