Instapaper

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/j

Popular

Join 2,123+ developers using this skill

skill

Productivity & Organization

beginner

2,123 installs

View Source

Last updated: April 29, 2026

AI Skill Market Insights

Real data. Real impact.

Popularity

Top 50%

Growing

Active Users

2,123+

Developers

Quick Start

Manual Installation

No automatic installation available. Please visit the source repository for installation instructions.

View Installation Instructions

TEAR & SHARE

3-5hrs/WK

RISING

2.1K+ USING

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
- Use
```
list
```
  or
```
export
```
  with
```
--cursor
```
  /
```
--cursor-dir
```
  or
```
--since/--until
```
  bounds.
- Use
```
--updated-since
```
  for incremental sync.
- Use
```
--select
```
  for client-side filtering when the API does not support it.
Mutate safely
- Use
```
--dry-run
```
  or
```
--idempotent
```
  when possible.
- For bulk actions, use
```
--ids
```
  or
```
--stdin
```
  and consider
```
--batch
```
  .
- Deletions require explicit confirmation flags.

Handle extras

Text view:
```
ip text
```
for article HTML.
Highlights:
```
ip highlights list/add/delete
```
.
Folders:
```
ip folders list/add/delete/order
```
.

Troubleshoot
- Use
```
--debug
```
  for request timing and status.
- Use
```
--stderr-json
```
  and map
```
exit_code
```
  to action.

Command reference

Read these when you need exact flags, formats, or examples:

```
references/commands.md
```
: command-by-command examples for auth, list/export/import, mutations, folders, highlights, and text.
```
references/output-and-sync.md
```
: output formats, progress streams, cursor/bounds syntax, and filtering.
```
references/errors.md
```
: exit codes and structured stderr error codes.

Guardrails

Avoid
```
--format table
```
for parsing; it is for humans only.
Use
```
--output
```
or
```
--output-dir
```
for large exports to avoid stdout pressure.
Prefer
```
--password-stdin
```
on Windows to avoid echoing passwords.

Instapaper

AI Skill Market Insights

Quick Start

Manual Installation

TEAR & SHARE

Tags

writing-plans

Be Part of the 2,123+ Developer Community

Instapaper CLI

Overview

Install the CLI

Workflow (fast path)

Command reference

Guardrails

executing-plans

Orca CLI (worktrees & contexts)

find-skills (Vercel)

i-have-adhd (ADHD-friendly output)

Channels

Learn

Compare

Company

Agents