readwise-docslisted
Install: claude install-skill edwinhu/workflows
# Readwise Reader Document Management
CRUD operations on the Reader document library via official CLI (`readwise`) and custom CLI (`readwise-custom`).
## Commands — Official CLI (`readwise`)
### List Documents
```bash
readwise reader-list-documents # All documents (limit 10)
readwise reader-list-documents --limit 20 # First 20
readwise reader-list-documents --tag "proxy advisors" # By tag (up to 5 for AND logic)
readwise reader-list-documents --category pdf --location archive # By category + location
readwise reader-list-documents --updated-after 2026-01-01T00:00:00Z
readwise reader-list-documents --seen false # Unseen only
readwise reader-list-documents --response-fields title,author,summary # Reduce token usage
readwise reader-list-documents --id <id> # Specific document
```
**Filter values:**
| Flag | Values |
|------|--------|
| `--location` | `new` (inbox), `later`, `shortlist`, `archive`, `feed` |
| `--category` | `article`, `email`, `rss`, `highlight`, `note`, `pdf`, `epub`, `tweet`, `video`, `podcast`, `audiobook` |
| `--tag` | Any tag name (up to 5 tags for AND logic) |
| `--seen` | `true` (opened), `false` (unopened) |
### Search Documents (Hybrid)
```bash
readwise reader-search-documents --query "proxy advisors"
readwise reader-search-documents --query "regulation" --author-search "Jackson"
readwise reader-search-documents --query "AI" --c