@readwise/cli 0.3.1 → 0.5.0

package/dist/tui/term.js

@@ -17,11 +17,15 @@ export const style = {
 // --- Screen control ---
 export function enterFullScreen() {
     process.stdout.write(`${ESC}[?1049h`); // alternate screen buffer
+    process.stdout.write(`${ESC}[?2004h`); // enable bracketed paste mode
+    process.stdout.write(`${ESC}[>1u`); // enable kitty keyboard protocol (disambiguate mode)
     process.stdout.write(`${ESC}[?25l`); // hide cursor
     process.stdout.write(`${ESC}[H`); // cursor home
 }
 export function exitFullScreen() {
     process.stdout.write(`${ESC}[?25h`); // show cursor
+    process.stdout.write(`${ESC}[<u`); // disable kitty keyboard protocol
+    process.stdout.write(`${ESC}[?2004l`); // disable bracketed paste mode
     process.stdout.write(`${ESC}[?1049l`); // restore screen buffer
 }
 /** Paint lines to terminal without flicker: cursor home → overwrite each line → clear remainder */
@@ -30,11 +34,13 @@ export function paint(lines) {
     let out = `${ESC}[H`; // cursor home
     const count = Math.min(lines.length, rows);
     for (let i = 0; i < count; i++) {
-        out += lines[i] + `${ESC}[K\n`; // line content + clear to end of line
+        out += lines[i] + `${ESC}[K`; // line content + clear to end of line
+        if (i < count - 1)
+            out += "\n";
     }
     // Clear any remaining lines below content
     if (count < rows) {
-        out += `${ESC}[J`; // clear from cursor to end of screen
+        out += `\n${ESC}[J`; // clear from cursor to end of screen
     }
     process.stdout.write(out);
 }
@@ -43,6 +49,24 @@ export function screenSize() {
 }
 export function parseKey(data) {
     const s = data.toString("utf-8");
+    // Bracketed paste: \x1b[200~ ... \x1b[201~
+    if (s.startsWith(`${ESC}[200~`)) {
+        const content = s.replace(/\x1b\[200~/g, "").replace(/\x1b\[201~/g, "");
+        const normalized = content.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+        return { raw: normalized, name: "paste", shift: false, ctrl: false };
+    }
+    // Alt+Enter (ESC + CR/LF) — reliable newline insertion across all terminals
+    if (s === `${ESC}\r` || s === `${ESC}\n`) {
+        return { raw: s, name: "return", shift: true, ctrl: false };
+    }
+    // Alt+Arrow (word navigation)
+    if (s === `${ESC}[1;3D` || s === `${ESC}b`)
+        return { raw: s, name: "wordLeft", shift: false, ctrl: false };
+    if (s === `${ESC}[1;3C` || s === `${ESC}f`)
+        return { raw: s, name: "wordRight", shift: false, ctrl: false };
+    // Alt+Backspace (word delete)
+    if (s === `${ESC}\x7f`)
+        return { raw: s, name: "wordBackspace", shift: false, ctrl: false };
     const ctrl = s.length === 1 && s.charCodeAt(0) < 32;
     // Escape sequences
     if (s === `${ESC}[A`)
@@ -61,13 +85,23 @@ export function parseKey(data) {
         return { raw: s, name: "tab", shift: true, ctrl: false };
     if (s === ESC || s === `${ESC}${ESC}`)
         return { raw: s, name: "escape", shift: false, ctrl: false };
-    // Shift+Enter sequences
+    // Kitty keyboard protocol CSI-u encodings (when disambiguate mode is active)
     if (s === `${ESC}[13;2u`)
-        return { raw: s, name: "return", shift: true, ctrl: false }; // CSI u / kitty
+        return { raw: s, name: "return", shift: true, ctrl: false }; // Shift+Enter
     if (s === `${ESC}[27;2;13~`)
-        return { raw: s, name: "return", shift: true, ctrl: false }; // xterm
+        return { raw: s, name: "return", shift: true, ctrl: false }; // Shift+Enter (xterm)
     if (s === `${ESC}OM`)
-        return { raw: s, name: "return", shift: true, ctrl: false }; // misc terminals
+        return { raw: s, name: "return", shift: true, ctrl: false }; // Shift+Enter (misc)
+    if (s === `${ESC}[27u`)
+        return { raw: s, name: "escape", shift: false, ctrl: false };
+    if (s === `${ESC}[13u`)
+        return { raw: s, name: "return", shift: false, ctrl: false };
+    if (s === `${ESC}[9u`)
+        return { raw: s, name: "tab", shift: false, ctrl: false };
+    if (s === `${ESC}[9;2u`)
+        return { raw: s, name: "tab", shift: true, ctrl: false };
+    if (s === `${ESC}[127u`)
+        return { raw: s, name: "backspace", shift: false, ctrl: false };
     // Single characters
     if (s === "\r" || s === "\n")
         return { raw: s, name: "return", shift: false, ctrl: false };
@@ -82,6 +116,11 @@ export function parseKey(data) {
     if (ctrl) {
         return { raw: s, name: String.fromCharCode(s.charCodeAt(0) + 96), shift: false, ctrl: true };
     }
+    // Multi-character non-escape input = paste (terminal without bracketed paste support)
+    if (s.length > 1 && !s.startsWith(ESC)) {
+        const normalized = s.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+        return { raw: normalized, name: "paste", shift: false, ctrl: false };
+    }
     return { raw: s, name: s, shift: false, ctrl: false };
 }
 /** Strip ANSI escape codes to get visible character count */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@readwise/cli",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Command-line interface for Readwise and Reader",
   "type": "module",
   "bin": {
@@ -23,8 +23,8 @@
     "open": "^10"
   },
   "devDependencies": {
-    "typescript": "^5",
     "@types/node": "^22",
-    "tsx": "^4"
+    "tsx": "^4",
+    "typescript": "^5"
   }
 }

package/src/config.ts

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

package/src/index.ts

@@ -93,9 +93,10 @@ async function main() {
   const forceRefresh = process.argv.includes("--refresh");
   const positionalArgs = process.argv.slice(2).filter((a) => !a.startsWith("--"));
   const hasSubcommand = positionalArgs.length > 0;
+  const wantsHelp = process.argv.includes("--help") || process.argv.includes("-h");
 
-  // If no subcommand, TTY, and authenticated → launch TUI
-  if (!hasSubcommand && process.stdout.isTTY && config.access_token) {
+  // 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);
@@ -115,6 +116,13 @@ async function main() {
     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 {
@@ -123,7 +131,6 @@ async function main() {
       registerTools(program, tools);
     } 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 as Error).message}\x1b[0m\n`);
       }