| 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)
-
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.
-
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.
-
Read data deterministically