saveitnow

name: saveitnow description: >- Manage SaveIt.now bookmarks via CLI - save, list, search, delete, and organize web bookmarks. Use when user mentions 'saveitnow', 'bookmark', 'save link', 'saveit.now', or wants to interact with the SaveIt.now API.

saveitnow CLI

Manage SaveIt.now bookmarks and tags from the terminal.

Setup

npm i -g saveitnow
saveitnow auth set "your-api-key"
saveitnow auth test

Get your API key from saveit.now/settings (requires Pro plan).

Resources

bookmarks

bookmarks list

saveitnow bookmarks list [options]
  --limit <n>         Max results 1-100 (default: 20)
  --cursor <id>       Pagination cursor
  --query <q>         Search query
  --tags <tags>       Filter by tags (comma-separated)
  --types <types>     Filter by type: LINK, VIDEO, PDF, NOTE
  --special <filter>  Special filter: READ, UNREAD, STAR
  --fields <cols>     Columns to display
  --json              JSON output
  --format <fmt>      text, json, csv, yaml

bookmarks create

saveitnow bookmarks create --url "https://example.com"

bookmarks delete

saveitnow bookmarks delete <bookmarkId>

bookmarks random

saveitnow bookmarks random
saveitnow bookmarks random --json

tags

tags list

saveitnow tags list [options]
  --limit <n>     Max results 1-100 (default: 20)
  --cursor <id>   Pagination cursor
  --fields <cols> Columns to display
  --json          JSON output
  --format <fmt>  text, json, csv, yaml

auth

Global Flags

All commands support: --json, --format <text|json|csv|yaml>, --verbose, --no-color, --no-header

Output Format

• text (default): Pretty tables for lists, key-value for single items
• json: { "ok": true, "data": [...], "meta": { "total": N } }
• csv: Comma-separated values
• yaml: YAML format

Exit Codes

• 0 - Success
• 1 - API error
• 2 - Usage error

Quick Reference

saveitnow bookmarks list --query "react"
saveitnow bookmarks list --special UNREAD --limit 10
saveitnow bookmarks create --url "https://docs.example.com"
saveitnow bookmarks random
saveitnow tags list --json