From 066986e5a93729ad57a192e73799c5922fa51032 Mon Sep 17 00:00:00 2001
From: Rasul Kireev <me@rasulkireev.com>
Date: Wed, 1 Jul 2026 14:25:50 +0000
Subject: [PATCH] docs: add upgrade instructions

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index 258cc13..f20c49e 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,28 @@ Anything you can do in Readwise/Reader, your agent can now do for you.
 npm install -g @readwise/cli
 ```
 
+## Upgrade
+
+If you installed the CLI globally with npm, upgrade to the latest published version with:
+
+```bash
+npm install -g @readwise/cli@latest
+readwise --version
+```
+
+If the version did not change, confirm which binary your shell is using:
+
+```bash
+which readwise
+npm list -g @readwise/cli --depth=0
+```
+
+If you run the CLI with `npx`, request the latest package explicitly:
+
+```bash
+npx @readwise/cli@latest --version
+```
+
 ## Setup
 
 ### Interactive login (opens browser)