@shiori-sh/cli 0.1.0 → 0.3.0

package/README.md

@@ -29,9 +29,16 @@ You can also set `SHIORI_API_KEY` as an environment variable.
 ```bash
 shiori list                        # List recent links
 shiori list --read unread          # List unread links
-shiori list --limit 5 --sort oldest # Paginate and sort
+shiori list --since 7d             # Links saved in the last 7 days
+shiori list --content --json       # Include full markdown content
+
+shiori search "react hooks"        # Full-text search
+shiori search "AI" --since 30d     # Search within a time window
+shiori search "go" --content --json # Search with full content
 
 shiori get <id>                    # Get a link with full content
+shiori content <id>                # Print raw markdown (for piping)
+
 shiori save <url>                  # Save a new link
 shiori save <url> --title "..."    # Save with custom title
 
@@ -44,6 +51,13 @@ shiori delete <id>                 # Move to trash
 shiori trash                       # List trashed links
 shiori trash --empty               # Permanently delete all trash
 
+shiori subscriptions list           # List RSS subscriptions
+shiori subscriptions add <url>     # Subscribe to an RSS feed
+shiori subscriptions add <url> --sync  # Subscribe and sync recent items
+shiori subscriptions remove <id>   # Remove a subscription
+shiori subscriptions sync <id>     # Sync a subscription now
+shiori subscriptions sync <id> --limit 5  # Sync with item limit
+
 shiori me                          # Show account info
 shiori auth --status               # Check auth status
 shiori auth --logout               # Remove stored credentials
@@ -51,6 +65,24 @@ shiori auth --logout               # Remove stored credentials
 
 Add `--json` to any command for machine-readable output.
 
+## AI and Scripting
+
+The CLI is designed to make your links accessible to AI tools and scripts:
+
+```bash
+# Pipe link content to an LLM
+shiori content <id> | llm "summarize this"
+
+# Get recent links with full content as JSON
+shiori list --since 7d --content --json
+
+# Search and pipe results
+shiori search "react" --content --json | jq '.links[].content'
+
+# Duration shortcuts: 1h, 7d, 2w, 1m, 1y
+shiori list --since 2w --json
+```
+
 ## Environment Variables
 
 | Variable          | Description                                        |

package/dist/index.js

@@ -17,7 +17,7 @@ function readConfig() {
   }
 }
 function writeConfig(config) {
-  mkdirSync(CONFIG_DIR, { recursive: true });
+  mkdirSync(CONFIG_DIR, { recursive: true, mode: 448 });
   writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n", {
     mode: 384
   });
@@ -27,9 +27,7 @@ function getApiKey() {
   if (envKey) return envKey;
   const config = readConfig();
   if (config.api_key) return config.api_key;
-  console.error(
-    "Not authenticated. Run `shiori auth` to set up your API key."
-  );
+  console.error("Not authenticated. Run `shiori auth` to set up your API key.");
   console.error("Or set the SHIORI_API_KEY environment variable.");
   process.exit(1);
 }
@@ -198,7 +196,16 @@ function hasFlag(args, ...names) {
 function getPositional(args) {
   for (let i = 0; i < args.length; i++) {
     if (args[i].startsWith("--")) {
-      if (i + 1 < args.length && !args[i + 1].startsWith("--") && ["--limit", "--offset", "--sort", "--read", "--title", "--summary"].includes(args[i])) {
+      if (i + 1 < args.length && !args[i + 1].startsWith("--") && [
+        "--limit",
+        "--offset",
+        "--sort",
+        "--read",
+        "--title",
+        "--summary",
+        "--since",
+        "--format"
+      ].includes(args[i])) {
         i++;
       }
       continue;
@@ -207,9 +214,66 @@ function getPositional(args) {
   }
   return void 0;
 }
+var DURATION_UNITS = {
+  h: 36e5,
+  d: 864e5,
+  w: 6048e5,
+  m: 2592e6,
+  y: 31536e6
+};
+function parseDuration(str) {
+  const match = str.match(/^(\d+)([hdwmy])$/);
+  if (!match) {
+    throw new Error(`Invalid duration "${str}". Use a number + unit: 1h, 7d, 2w, 1m, 1y`);
+  }
+  const amount = Number(match[1]);
+  const ms = amount * DURATION_UNITS[match[2]];
+  return new Date(Date.now() - ms).toISOString();
+}
+function formatLinkList(links, options) {
+  for (const [i, link] of links.entries()) {
+    const readStatus = link.read_at ? "read" : "unread";
+    const title = truncate(link.title || "(untitled)", 60);
+    console.log(
+      `  ${String(options.offset + i + 1).padStart(3)}. ${title}  ${link.domain || ""}  ${formatDate(link.created_at)}  ${readStatus}`
+    );
+    if (options.showContent && link.content) {
+      console.log(`       ${truncate(link.content.replace(/\n/g, " "), 500)}`);
+    }
+  }
+}
 
-// src/commands/delete.ts
+// src/commands/content.ts
 async function run2(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori content - Print link content as markdown
+
+Usage: shiori content <id>
+
+Prints the extracted markdown content to stdout with no decoration.
+Useful for piping into other tools:
+
+  shiori content <id> | llm "summarize this"
+  shiori content <id> | pbcopy
+
+Options:
+  --help, -h  Show this help`);
+    return;
+  }
+  const id = getPositional(args);
+  if (!id) {
+    console.error("Usage: shiori content <link-id>");
+    process.exit(1);
+  }
+  const { data } = await api("GET", `/api/links/${id}`);
+  const content = data.link?.content;
+  if (content) {
+    process.stdout.write(content);
+  }
+}
+
+// src/commands/delete.ts
+async function run3(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori delete - Delete a link (move to trash)
 
@@ -234,7 +298,7 @@ Options:
 }
 
 // src/commands/get.ts
-async function run3(args) {
+async function run4(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori get - Get a link by ID (includes content)
 
@@ -266,9 +330,7 @@ Options:
   console.log(`  Author:    ${link.author || "--"}`);
   console.log(`  Published: ${formatDate(link.publication_date)}`);
   console.log(`  Saved:     ${formatDate(link.created_at)}`);
-  console.log(
-    `  Read:      ${link.read_at ? formatDate(link.read_at) : "unread"}`
-  );
+  console.log(`  Read:      ${link.read_at ? formatDate(link.read_at) : "unread"}`);
   console.log(`  Summary:   ${link.summary || "--"}`);
   if (link.content) {
     console.log(`
@@ -281,7 +343,7 @@ Options:
 }
 
 // src/commands/list.ts
-async function run4(args) {
+async function run5(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori list - List saved links
 
@@ -292,6 +354,8 @@ Options:
   --offset <n>             Pagination offset (default: 0)
   --sort <newest|oldest>   Sort order (default: newest)
   --read <all|read|unread> Filter by read status (default: all)
+  --since <duration>       Only links saved within this period (e.g. 1h, 7d, 2w, 1m, 1y)
+  --content                Include extracted markdown content
   --json                   Output raw JSON
   --help, -h               Show this help`);
     return;
@@ -300,12 +364,16 @@ Options:
   const offset = getFlag(args, "--offset", "0");
   const sort = getFlag(args, "--sort", "newest");
   const read = getFlag(args, "--read", "all");
+  const sinceFlag = getFlag(args, "--since");
+  const includeContent = hasFlag(args, "--content");
   const params = new URLSearchParams({
     limit,
     offset,
     sort,
     read
   });
+  if (includeContent) params.set("include_content", "true");
+  if (sinceFlag) params.set("since", parseDuration(sinceFlag));
   const { data } = await api("GET", `/api/links?${params}`);
   if (hasFlag(args, "--json")) {
     console.log(JSON.stringify(data, null, 2));
@@ -314,13 +382,7 @@ Options:
   console.log(`
 Links: ${data.links.length} of ${data.total} total
 `);
-  for (const [i, link] of data.links.entries()) {
-    const readStatus = link.read_at ? "read" : "unread";
-    const title = truncate(link.title || "(untitled)", 60);
-    console.log(
-      `  ${String(Number(offset) + i + 1).padStart(3)}. ${title}  ${link.domain || ""}  ${formatDate(link.created_at)}  ${readStatus}`
-    );
-  }
+  formatLinkList(data.links, { offset: Number(offset), showContent: includeContent });
   if (data.links.length === 0) {
     console.log("  No links found.");
   }
@@ -328,7 +390,7 @@ Links: ${data.links.length} of ${data.total} total
 }
 
 // src/commands/me.ts
-async function run5(args) {
+async function run6(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori me - Show current user info
 
@@ -349,12 +411,14 @@ Options:
   Name:         ${user.full_name || "--"}`);
   const plan = user.subscription?.plan === "subscription" ? "Pro" : user.subscription?.plan || "Free";
   console.log(`  Plan:         ${plan}`);
-  console.log(`  Member since: ${new Date(user.created_at).toLocaleDateString("en-US", { month: "long", year: "numeric" })}`);
+  console.log(
+    `  Member since: ${new Date(user.created_at).toLocaleDateString("en-US", { month: "long", year: "numeric" })}`
+  );
   console.log();
 }
 
 // src/commands/save.ts
-async function run6(args) {
+async function run7(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori save - Save a new link
 
@@ -388,8 +452,214 @@ Options:
   }
 }
 
+// src/commands/search.ts
+async function run8(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori search - Search saved links
+
+Usage: shiori search <query> [options]
+
+Options:
+  --limit <n>           Number of links (1-100, default: 25)
+  --offset <n>          Pagination offset (default: 0)
+  --since <duration>    Only links saved within this period (e.g. 1h, 7d, 2w, 1m, 1y)
+  --content             Include extracted markdown content
+  --json                Output raw JSON
+  --help, -h            Show this help`);
+    return;
+  }
+  const query = getPositional(args);
+  if (!query) {
+    console.error("Usage: shiori search <query>");
+    process.exit(1);
+  }
+  const limit = getFlag(args, "--limit", "25");
+  const offset = getFlag(args, "--offset", "0");
+  const sinceFlag = getFlag(args, "--since");
+  const includeContent = hasFlag(args, "--content");
+  const params = new URLSearchParams({
+    search: query,
+    limit,
+    offset
+  });
+  if (includeContent) params.set("include_content", "true");
+  if (sinceFlag) params.set("since", parseDuration(sinceFlag));
+  const { data } = await api("GET", `/api/links?${params}`);
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  console.log(`
+Results: ${data.links.length} of ${data.total} matches
+`);
+  formatLinkList(data.links, { offset: Number(offset), showContent: includeContent });
+  if (data.links.length === 0) {
+    console.log("  No links found.");
+  }
+  console.log();
+}
+
+// src/commands/subscriptions.ts
+var HELP = `shiori subscriptions - Manage RSS subscriptions
+
+Usage: shiori subscriptions <subcommand> [options]
+
+Subcommands:
+  list                   List your subscriptions
+  add <url>              Subscribe to an RSS feed
+  remove <id>            Remove a subscription
+  sync <id>              Sync a subscription now
+
+Options:
+  --json                 Output raw JSON
+  --help, -h             Show this help
+
+Examples:
+  shiori subscriptions list
+  shiori subscriptions add https://example.com/feed.xml
+  shiori subscriptions add https://example.com --sync
+  shiori subscriptions remove <id>
+  shiori subscriptions sync <id> --limit 5`;
+async function run9(args) {
+  if (hasFlag(args, "--help", "-h") && !args[0]) {
+    console.log(HELP);
+    return;
+  }
+  const subcommand = args[0];
+  const subArgs = args.slice(1);
+  switch (subcommand) {
+    case "list":
+    case "ls":
+      return listSubscriptions(subArgs);
+    case "add":
+      return addSubscription(subArgs);
+    case "remove":
+    case "rm":
+      return removeSubscription(subArgs);
+    case "sync":
+      return syncSubscription(subArgs);
+    default:
+      if (subcommand) {
+        console.error(`Unknown subcommand: ${subcommand}
+`);
+      }
+      console.log(HELP);
+      if (subcommand) process.exit(1);
+  }
+}
+async function listSubscriptions(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori subscriptions list - List your RSS subscriptions
+
+Usage: shiori subscriptions list [options]
+
+Options:
+  --json        Output raw JSON
+  --help, -h    Show this help`);
+    return;
+  }
+  const { data } = await api("GET", "/api/subscriptions/");
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  const subs = data.subscriptions;
+  if (subs.length === 0) {
+    console.log("\n  No subscriptions. Add one with: shiori subscriptions add <url>\n");
+    return;
+  }
+  console.log(`
+Subscriptions: ${subs.length}
+`);
+  for (const sub of subs) {
+    const title = truncate(sub.title || sub.feed_url, 50);
+    const synced = sub.last_synced_at ? `synced ${formatDate(sub.last_synced_at)}` : "never synced";
+    console.log(`  ${sub.id}  ${title}  ${synced}`);
+  }
+  console.log();
+}
+async function addSubscription(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori subscriptions add - Subscribe to an RSS feed
+
+Usage: shiori subscriptions add <url> [options]
+
+Options:
+  --sync        Sync the 3 most recent items immediately
+  --json        Output raw JSON
+  --help, -h    Show this help`);
+    return;
+  }
+  const url = getPositional(args);
+  if (!url) {
+    console.error("Usage: shiori subscriptions add <url>");
+    process.exit(1);
+  }
+  const body = { feedUrl: url };
+  if (hasFlag(args, "--sync")) {
+    body.initialSync = true;
+  }
+  const { data } = await api("POST", "/api/subscriptions/", body);
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  const sub = data.subscription;
+  console.log(`Subscribed: ${sub.title || sub.feed_url} (${sub.id})`);
+}
+async function removeSubscription(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori subscriptions remove - Remove a subscription
+
+Usage: shiori subscriptions remove <id> [options]
+
+Options:
+  --json        Output raw JSON
+  --help, -h    Show this help`);
+    return;
+  }
+  const id = getPositional(args);
+  if (!id) {
+    console.error("Usage: shiori subscriptions remove <id>");
+    process.exit(1);
+  }
+  const { data } = await api("DELETE", `/api/subscriptions/${id}`);
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  console.log("Subscription removed.");
+}
+async function syncSubscription(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori subscriptions sync - Sync a subscription now
+
+Usage: shiori subscriptions sync <id> [options]
+
+Options:
+  --limit <n>   Max items to sync (1-100)
+  --json        Output raw JSON
+  --help, -h    Show this help`);
+    return;
+  }
+  const id = getPositional(args);
+  if (!id) {
+    console.error("Usage: shiori subscriptions sync <id>");
+    process.exit(1);
+  }
+  const body = {};
+  const limit = getFlag(args, "--limit");
+  if (limit) body.limit = Number(limit);
+  const { data } = await api("POST", `/api/subscriptions/sync/${id}`, body);
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  console.log(`Synced: ${data.newItems} new, ${data.skipped} skipped, ${data.errors} errors`);
+}
+
 // src/commands/trash.ts
-async function run7(args) {
+async function run10(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori trash - List or empty the trash
 
@@ -440,7 +710,7 @@ Trashed links: ${data.links.length} of ${data.total} total
 }
 
 // src/commands/update.ts
-async function run8(args) {
+async function run11(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori update - Update a link
 
@@ -472,7 +742,9 @@ Options:
     const title = getFlag(args, "--title");
     const summary = getFlag(args, "--summary");
     if (!title && !summary) {
-      console.error("Provide at least one update flag: --read, --unread, --title, --summary, --restore");
+      console.error(
+        "Provide at least one update flag: --read, --unread, --title, --summary, --restore"
+      );
       process.exit(1);
     }
     body = {};
@@ -489,13 +761,14 @@ Options:
 
 // src/error-report.ts
 function reportError(command, error) {
-  const message = error instanceof Error ? error.message : String(error);
+  const raw = error instanceof Error ? error.message : String(error);
+  const message = raw.replace(/shk_[a-zA-Z0-9]+/g, "shk_[REDACTED]");
   const baseUrl = getBaseUrl();
   fetch(`${baseUrl}/api/cli/report`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({
-      version: "0.1.0",
+      version: "0.3.0",
       command,
       error: message,
       platform: process.platform
@@ -512,8 +785,7 @@ async function checkForUpdate(currentVersion, isJson) {
   if (process.env.CI || process.env.NO_UPDATE_NOTIFIER || isJson) return;
   const config = readConfig();
   const now = Date.now();
-  if (config.last_update_check && now - config.last_update_check < CHECK_INTERVAL_MS)
-    return;
+  if (config.last_update_check && now - config.last_update_check < CHECK_INTERVAL_MS) return;
   try {
     const res = await fetch(REGISTRY_URL, {
       signal: AbortSignal.timeout(3e3)
@@ -537,13 +809,16 @@ async function checkForUpdate(currentVersion, isJson) {
 // src/index.ts
 var COMMANDS = {
   auth: { run, desc: "Authenticate with your Shiori API key" },
-  list: { run: run4, desc: "List saved links" },
-  get: { run: run3, desc: "Get a link by ID (includes content)" },
-  save: { run: run6, desc: "Save a new link" },
-  update: { run: run8, desc: "Update a link" },
-  delete: { run: run2, desc: "Delete a link (move to trash)" },
-  trash: { run: run7, desc: "List or empty the trash" },
-  me: { run: run5, desc: "Show current user info" }
+  list: { run: run5, desc: "List saved links" },
+  search: { run: run8, desc: "Search saved links" },
+  get: { run: run4, desc: "Get a link by ID (includes content)" },
+  content: { run: run2, desc: "Print link content as markdown" },
+  save: { run: run7, desc: "Save a new link" },
+  update: { run: run11, desc: "Update a link" },
+  delete: { run: run3, desc: "Delete a link (move to trash)" },
+  trash: { run: run10, desc: "List or empty the trash" },
+  subscriptions: { run: run9, desc: "Manage RSS subscriptions" },
+  me: { run: run6, desc: "Show current user info" }
 };
 function printHelp() {
   console.log(`shiori - Manage your Shiori link library from the terminal
@@ -558,9 +833,11 @@ Options:
   --version, -v    Show version
 
 Get started:
-  shiori auth        Authenticate with your API key
-  shiori list        List your recent links
-  shiori save <url>  Save a new link`);
+  shiori auth            Authenticate with your API key
+  shiori list            List your recent links
+  shiori save <url>      Save a new link
+  shiori search <query>  Search your links
+  shiori content <id>    Print markdown content (pipe to other tools)`);
 }
 async function main() {
   const args = process.argv.slice(2);
@@ -570,7 +847,7 @@ async function main() {
     return;
   }
   if (command === "--version" || command === "-v") {
-    console.log("0.1.0");
+    console.log("0.3.0");
     return;
   }
   const cmd = COMMANDS[command];
@@ -583,7 +860,7 @@ async function main() {
   const cmdArgs = args.slice(1);
   const isJson = cmdArgs.includes("--json");
   await cmd.run(cmdArgs);
-  checkForUpdate("0.1.0", isJson).catch(() => {
+  checkForUpdate("0.3.0", isJson).catch(() => {
   });
 }
 main().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shiori-sh/cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "CLI for managing your Shiori link library",
   "author": "Brian Lovin",
   "license": "MIT",
@@ -21,11 +21,13 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "vitest": "^3.0.0"
   },
   "engines": {
     "node": ">=18"