@readwise/cli 0.3.1 → 0.5.0

package/README.md

@@ -64,6 +64,8 @@ readwise reader-get-document-details --document-id <document-id>
 readwise reader-get-document-highlights --document-id <document-id>
 ```
 
+> **Tip: seen vs unseen documents.** In the response, `firstOpenedAt: null` means the document is **unseen** (never opened). A non-null `firstOpenedAt` means it has been opened/seen. Use `reader-edit-document-metadata --seen true` to mark a document as seen.
+
 ### Save a document
 
 ```bash
@@ -88,6 +90,7 @@ readwise reader-move-document --document-id <id> --location archive
 
 # Edit metadata
 readwise reader-edit-document-metadata --document-id <id> --title "Better Title"
+readwise reader-edit-document-metadata --document-id <id> --seen true  # mark as seen/opened
 readwise reader-set-document-notes --document-id <id> --notes "Updated notes"
 ```
 

package/dist/config.d.ts

@@ -15,6 +15,7 @@ export interface SchemaProperty {
     enum?: string[];
     items?: SchemaProperty;
     default?: unknown;
+    examples?: unknown[];
     anyOf?: SchemaProperty[];
     $ref?: string;
     properties?: Record<string, SchemaProperty>;

package/dist/index.js

@@ -90,8 +90,9 @@ async function main() {
     const forceRefresh = process.argv.includes("--refresh");
     const positionalArgs = process.argv.slice(2).filter((a) => !a.startsWith("--"));
     const hasSubcommand = positionalArgs.length > 0;
-    // If no subcommand, TTY, and authenticated → launch TUI
-    if (!hasSubcommand && process.stdout.isTTY && config.access_token) {
+    const wantsHelp = process.argv.includes("--help") || process.argv.includes("-h");
+    // If no subcommand, TTY, and authenticated → launch TUI (unless --help)
+    if (!hasSubcommand && !wantsHelp && process.stdout.isTTY && config.access_token) {
         try {
             const { token, authType } = await ensureValidToken();
             const tools = await getTools(token, authType, forceRefresh);
@@ -110,6 +111,12 @@ async function main() {
         console.log("\nRun `readwise login` or `readwise login-with-token` to authenticate.");
         return;
     }
+    // If not authenticated and trying a non-login command, tell user to log in
+    if (!config.access_token && hasSubcommand && positionalArgs[0] !== "login" && positionalArgs[0] !== "login-with-token") {
+        process.stderr.write("\x1b[31mNot logged in.\x1b[0m Run `readwise login` or `readwise login-with-token` to authenticate.\n");
+        process.exitCode = 1;
+        return;
+    }
     // Try to load tools if we have a token (for subcommand mode)
     if (config.access_token) {
         try {
@@ -119,7 +126,6 @@ async function main() {
         }
         catch (err) {
             // Don't fail — login command should still work
-            // Only warn if user is trying to run a non-login command
             if (hasSubcommand && positionalArgs[0] !== "login" && positionalArgs[0] !== "login-with-token") {
                 process.stderr.write(`\x1b[33mWarning: Could not fetch tools: ${err.message}\x1b[0m\n`);
             }