instapaper

name	instapaper
description	Use when operating the instapaper-cli (ip) tool or troubleshooting it: authenticating, listing/exporting/importing bookmarks, bulk mutations, folders/highlights/text, choosing output formats (ndjson/json/plain), cursor-based sync, and interpreting stderr-json/exit codes for automation.

Instapaper CLI

Overview

Use this skill to handle Instapaper operations via the ip CLI (which must be installed and available in PATH), especially when you need reliable automation, structured output, or troubleshooting guidance.

Install the CLI

• Go install: go install github.com/vburojevic/instapaper-cli/cmd/ip@latest
• Homebrew: brew tap vburojevic/tap && brew install instapaper-cli
• From source: go build ./cmd/ip (run as ./ip)

Workflow (fast path)

1. Verify setup

   • Ensure INSTAPAPER_CONSUMER_KEY and INSTAPAPER_CONSUMER_SECRET are set or passed during login.
   • Prefer --password-stdin for auth; never store the password.
   • Run ip doctor --json (or ip auth status) before long jobs.

2. Pick output format for automation

   • Default is --ndjson (streaming, one object per line).
   • Use --json for single objects or compact arrays.
   • Use --plain for stable, line-oriented text.
   • Add --stderr-json for structured errors and --progress-json for long runs.

3. Read data deterministically