@shiori-sh/cli 0.4.0 → 0.7.0

package/README.md

@@ -29,6 +29,7 @@ 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 --tag "design"         # Filter links by tag
 shiori list --since 7d             # Links saved in the last 7 days
 shiori list --content --json       # Include full markdown content
 
@@ -46,11 +47,20 @@ shiori update <id> --read          # Mark as read
 shiori update <id> --unread        # Mark as unread
 shiori update <id> --title "..."   # Update title
 shiori update <id> --restore       # Restore from trash
+shiori update --ids <id1,id2,...> --read   # Bulk mark as read
+shiori update --ids <id1,id2,...> --unread # Bulk mark as unread
 
 shiori delete <id>                 # Move to trash
+shiori delete --ids <id1,id2,...>  # Bulk move to trash
 shiori trash                       # List trashed links
 shiori trash --empty               # Permanently delete all trash
 
+shiori tags list                    # List your tags
+shiori tags create "design"        # Create a tag
+shiori tags update <id> --name "dev"  # Rename a tag
+shiori tags delete <id>            # Delete a tag
+shiori tags set <link-id> design,work  # Set tags on a link
+
 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
@@ -58,7 +68,7 @@ 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 whoami                      # Show account info
 shiori auth --status               # Check auth status
 shiori auth --logout               # Remove stored credentials
 ```

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/commands/auth.ts
-import { exec } from "child_process";
+import { execFile } from "child_process";
 import { hostname } from "os";
 import { createInterface } from "readline";
 
@@ -92,7 +92,7 @@ function promptSecret(question) {
 function openUrl(url) {
   const platform = process.platform;
   const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
-  exec(`${cmd} ${JSON.stringify(url)}`);
+  execFile(cmd, [url]);
 }
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -290,7 +290,10 @@ function getPositional(args) {
         "--title",
         "--summary",
         "--since",
-        "--format"
+        "--format",
+        "--ids",
+        "--tag",
+        "--name"
       ].includes(args[i])) {
         i++;
       }
@@ -361,18 +364,35 @@ Options:
 // src/commands/delete.ts
 async function run3(args) {
   if (hasFlag(args, "--help", "-h")) {
-    console.log(`shiori delete - Delete a link (move to trash)
+    console.log(`shiori delete - Delete links (move to trash)
 
 Usage: shiori delete <id> [options]
+       shiori delete --ids <id1,id2,...> [options]
 
 Options:
-  --json      Output raw JSON
-  --help, -h  Show this help`);
+  --ids <ids>   Comma-separated list of link IDs for bulk delete
+  --json        Output raw JSON
+  --help, -h    Show this help`);
+    return;
+  }
+  const idsFlag = getFlag(args, "--ids");
+  if (idsFlag) {
+    const ids = idsFlag.split(",").map((id2) => id2.trim()).filter(Boolean);
+    if (ids.length === 0) {
+      console.error("No valid IDs provided.");
+      process.exit(1);
+    }
+    const { data: data2 } = await api("PATCH", "/api/links", { ids, deleted: true });
+    if (hasFlag(args, "--json")) {
+      console.log(JSON.stringify(data2, null, 2));
+      return;
+    }
+    console.log(`Deleted ${data2.updated} link(s).`);
     return;
   }
   const id = getPositional(args);
   if (!id) {
-    console.error("Usage: shiori delete <id>");
+    console.error("Usage: shiori delete <id> or shiori delete --ids <id1,id2,...>");
     process.exit(1);
   }
   const { data } = await api("DELETE", `/api/links/${id}`);
@@ -440,6 +460,7 @@ Options:
   --offset <n>             Pagination offset (default: 0)
   --sort <newest|oldest>   Sort order (default: newest)
   --read <all|read|unread> Filter by read status (default: all)
+  --tag <name>             Filter by tag name
   --since <duration>       Only links saved within this period (e.g. 1h, 7d, 2w, 1m, 1y)
   --content                Include extracted markdown content
   --json                   Output raw JSON
@@ -451,6 +472,7 @@ Options:
   const sort = getFlag(args, "--sort", "newest");
   const read = getFlag(args, "--read", "all");
   const sinceFlag = getFlag(args, "--since");
+  const tag = getFlag(args, "--tag");
   const includeContent = hasFlag(args, "--content");
   const params = new URLSearchParams({
     limit,
@@ -460,6 +482,7 @@ Options:
   });
   if (includeContent) params.set("include_content", "true");
   if (sinceFlag) params.set("since", parseDuration(sinceFlag));
+  if (tag) params.set("tag", tag);
   const { data } = await api("GET", `/api/links?${params}`);
   if (hasFlag(args, "--json")) {
     console.log(JSON.stringify(data, null, 2));
@@ -475,36 +498,8 @@ Links: ${data.links.length} of ${data.total} total
   console.log();
 }
 
-// src/commands/me.ts
-async function run6(args) {
-  if (hasFlag(args, "--help", "-h")) {
-    console.log(`shiori me - Show current user info
-
-Usage: shiori me [options]
-
-Options:
-  --json      Output raw JSON
-  --help, -h  Show this help`);
-    return;
-  }
-  const { data } = await api("GET", "/api/user/me");
-  if (hasFlag(args, "--json")) {
-    console.log(JSON.stringify(data, null, 2));
-    return;
-  }
-  const user = data.user;
-  console.log(`
-  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();
-}
-
 // src/commands/save.ts
-async function run7(args) {
+async function run6(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori save - Save a new link
 
@@ -539,7 +534,7 @@ Options:
 }
 
 // src/commands/search.ts
-async function run8(args) {
+async function run7(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori search - Search saved links
 
@@ -606,7 +601,7 @@ Examples:
   shiori subscriptions add https://example.com --sync
   shiori subscriptions remove <id>
   shiori subscriptions sync <id> --limit 5`;
-async function run9(args) {
+async function run8(args) {
   if (hasFlag(args, "--help", "-h") && !args[0]) {
     console.log(HELP);
     return;
@@ -744,6 +739,224 @@ Options:
   console.log(`Synced: ${data.newItems} new, ${data.skipped} skipped, ${data.errors} errors`);
 }
 
+// src/commands/tags.ts
+var HELP2 = `shiori tags - Manage tags
+
+Usage: shiori tags <subcommand> [options]
+
+Subcommands:
+  list                           List your tags
+  create <name>                  Create a tag
+  update <id> --name <name>      Rename a tag
+  delete <id>                    Delete a tag
+  set <link-id> <tag1,tag2,...>  Set tags on a link (by name)
+
+Options:
+  --json                         Output raw JSON
+  --help, -h                     Show this help
+
+Examples:
+  shiori tags list
+  shiori tags create "design"
+  shiori tags update <id> --name "dev"
+  shiori tags delete <id>
+  shiori tags set <link-id> design,work`;
+async function run9(args) {
+  if (hasFlag(args, "--help", "-h") && !args[0]) {
+    console.log(HELP2);
+    return;
+  }
+  const subcommand = args[0];
+  const subArgs = args.slice(1);
+  switch (subcommand) {
+    case "list":
+    case "ls":
+      return listTags(subArgs);
+    case "create":
+      return createTag(subArgs);
+    case "update":
+      return updateTag(subArgs);
+    case "delete":
+    case "rm":
+      return deleteTag(subArgs);
+    case "set":
+      return setLinkTags(subArgs);
+    default:
+      if (subcommand) {
+        console.error(`Unknown subcommand: ${subcommand}
+`);
+      }
+      console.log(HELP2);
+      if (subcommand) process.exit(1);
+  }
+}
+async function listTags(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori tags list - List your tags
+
+Usage: shiori tags list [options]
+
+Options:
+  --json        Output raw JSON
+  --help, -h    Show this help`);
+    return;
+  }
+  const { data } = await api("GET", "/api/tags/");
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  const tags = data.tags;
+  if (tags.length === 0) {
+    console.log("\n  No tags. Create one with: shiori tags create <name>\n");
+    return;
+  }
+  console.log(`
+Tags: ${tags.length}
+`);
+  for (const tag of tags) {
+    console.log(`  ${tag.id}  ${tag.name}`);
+  }
+  console.log();
+}
+async function createTag(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori tags create - Create a tag
+
+Usage: shiori tags create <name> [options]
+
+Options:
+  --json        Output raw JSON
+  --help, -h    Show this help`);
+    return;
+  }
+  const name = getPositional(args);
+  if (!name) {
+    console.error("Usage: shiori tags create <name>");
+    process.exit(1);
+  }
+  const { data } = await api("POST", "/api/tags/", { name });
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  console.log(`Created: ${data.tag.name} (${data.tag.id})`);
+}
+async function updateTag(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori tags update - Update a tag
+
+Usage: shiori tags update <id> [options]
+
+Options:
+  --name <name>  New tag name
+  --json         Output raw JSON
+  --help, -h     Show this help`);
+    return;
+  }
+  const id = getPositional(args);
+  if (!id) {
+    console.error("Usage: shiori tags update <id> --name <name>");
+    process.exit(1);
+  }
+  const name = getFlag(args, "--name");
+  if (!name) {
+    console.error("Provide --name to update.");
+    process.exit(1);
+  }
+  const { data } = await api("PATCH", `/api/tags/${id}`, { name });
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  console.log(`Updated: ${data.tag.name} (${data.tag.id})`);
+}
+async function deleteTag(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori tags delete - Delete a tag
+
+Usage: shiori tags delete <id> [options]
+
+Options:
+  --json        Output raw JSON
+  --help, -h    Show this help`);
+    return;
+  }
+  const id = getPositional(args);
+  if (!id) {
+    console.error("Usage: shiori tags delete <id>");
+    process.exit(1);
+  }
+  const { data } = await api("DELETE", `/api/tags/${id}`);
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  console.log("Tag deleted.");
+}
+async function setLinkTags(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori tags set - Set tags on a link
+
+Usage: shiori tags set <link-id> <tag1,tag2,...> [options]
+
+Pass a comma-separated list of tag names. Tags are replaced, not appended.
+Pass an empty string "" to remove all tags.
+
+Options:
+  --json        Output raw JSON
+  --help, -h    Show this help`);
+    return;
+  }
+  const positionals = [];
+  for (let i = 0; i < args.length; i++) {
+    if (args[i].startsWith("--")) {
+      i++;
+      continue;
+    }
+    positionals.push(args[i]);
+  }
+  const linkId = positionals[0];
+  const tagNamesRaw = positionals[1];
+  if (!linkId) {
+    console.error("Usage: shiori tags set <link-id> <tag1,tag2,...>");
+    process.exit(1);
+  }
+  const tagNames = tagNamesRaw === void 0 || tagNamesRaw === "" ? [] : tagNamesRaw.split(",").map((t) => t.trim()).filter(Boolean);
+  const tagIds = [];
+  if (tagNames.length > 0) {
+    const { data: tagsData } = await api("GET", "/api/tags/");
+    const tagMap = /* @__PURE__ */ new Map();
+    for (const tag of tagsData.tags) {
+      tagMap.set(tag.name.toLowerCase(), tag.id);
+    }
+    const missing = [];
+    for (const name of tagNames) {
+      const id = tagMap.get(name.toLowerCase());
+      if (id) {
+        tagIds.push(id);
+      } else {
+        missing.push(name);
+      }
+    }
+    if (missing.length > 0) {
+      console.error(`Tags not found: ${missing.join(", ")}`);
+      console.error("Create them first with: shiori tags create <name>");
+      process.exit(1);
+    }
+  }
+  const { data } = await api("PUT", `/api/links/${linkId}/tags`, { tagIds });
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  if (tagIds.length === 0) {
+    console.log("All tags removed from link.");
+  } else {
+    console.log(`Set ${tagIds.length} tag${tagIds.length === 1 ? "" : "s"} on link.`);
+  }
+}
+
 // src/commands/trash.ts
 async function run10(args) {
   if (hasFlag(args, "--help", "-h")) {
@@ -798,20 +1011,42 @@ Trashed links: ${data.links.length} of ${data.total} total
 // src/commands/update.ts
 async function run11(args) {
   if (hasFlag(args, "--help", "-h")) {
-    console.log(`shiori update - Update a link
+    console.log(`shiori update - Update links
 
 Usage: shiori update <id> [options]
+       shiori update --ids <id1,id2,...> --read|--unread [options]
 
 Options:
+  --ids <ids>        Comma-separated list of link IDs for bulk update
   --read             Mark as read
   --unread           Mark as unread
-  --title <title>    Update title
-  --summary <text>   Update summary
-  --restore          Restore from trash
+  --title <title>    Update title (single link only)
+  --summary <text>   Update summary (single link only)
+  --restore          Restore from trash (single link only)
   --json             Output raw JSON
   --help, -h         Show this help`);
     return;
   }
+  const idsFlag = getFlag(args, "--ids");
+  if (idsFlag) {
+    const ids = idsFlag.split(",").map((id2) => id2.trim()).filter(Boolean);
+    if (ids.length === 0) {
+      console.error("No valid IDs provided.");
+      process.exit(1);
+    }
+    if (!hasFlag(args, "--read") && !hasFlag(args, "--unread")) {
+      console.error("Bulk update requires --read or --unread.");
+      process.exit(1);
+    }
+    const read = hasFlag(args, "--read");
+    const { data: data2 } = await api("PATCH", "/api/links", { ids, read });
+    if (hasFlag(args, "--json")) {
+      console.log(JSON.stringify(data2, null, 2));
+      return;
+    }
+    console.log(`Updated ${data2.updated} link(s).`);
+    return;
+  }
   const id = getPositional(args);
   if (!id) {
     console.error("Usage: shiori update <id> [--read | --unread | --title <title> | --restore]");
@@ -845,6 +1080,34 @@ Options:
   console.log(data.message || "Updated.");
 }
 
+// src/commands/whoami.ts
+async function run12(args) {
+  if (hasFlag(args, "--help", "-h")) {
+    console.log(`shiori whoami - Show current user info
+
+Usage: shiori whoami [options]
+
+Options:
+  --json      Output raw JSON
+  --help, -h  Show this help`);
+    return;
+  }
+  const { data } = await api("GET", "/api/user/me");
+  if (hasFlag(args, "--json")) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  const user = data.user;
+  console.log(`
+  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();
+}
+
 // src/error-report.ts
 function reportError(command, error) {
   const raw = error instanceof Error ? error.message : String(error);
@@ -854,7 +1117,7 @@ function reportError(command, error) {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({
-      version: "0.4.0",
+      version: "0.7.0",
       command,
       error: message,
       platform: process.platform
@@ -896,15 +1159,16 @@ async function checkForUpdate(currentVersion, isJson) {
 var COMMANDS = {
   auth: { run, desc: "Authenticate with Shiori (browser or API key)" },
   list: { run: run5, desc: "List saved links" },
-  search: { run: run8, desc: "Search saved links" },
+  search: { run: run7, 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" },
+  save: { run: run6, 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" }
+  subscriptions: { run: run8, desc: "Manage RSS subscriptions" },
+  tags: { run: run9, desc: "Manage tags" },
+  whoami: { run: run12, desc: "Show current user info" }
 };
 function printHelp() {
   console.log(`shiori - Manage your Shiori link library from the terminal
@@ -923,7 +1187,8 @@ Get started:
   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)`);
+  shiori content <id>    Print markdown content (pipe to other tools)
+  shiori whoami          Show your account info`);
 }
 async function main() {
   const args = process.argv.slice(2);
@@ -933,7 +1198,7 @@ async function main() {
     return;
   }
   if (command === "--version" || command === "-v") {
-    console.log("0.4.0");
+    console.log("0.7.0");
     return;
   }
   const cmd = COMMANDS[command];
@@ -946,7 +1211,7 @@ async function main() {
   const cmdArgs = args.slice(1);
   const isJson = cmdArgs.includes("--json");
   await cmd.run(cmdArgs);
-  checkForUpdate("0.4.0", isJson).catch(() => {
+  checkForUpdate("0.7.0", isJson).catch(() => {
   });
 }
 main().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shiori-sh/cli",
-  "version": "0.4.0",
+  "version": "0.7.0",
   "description": "CLI for managing your Shiori link library",
   "author": "Brian Lovin",
   "license": "MIT",