@shiori-sh/cli 0.5.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
 
@@ -54,6 +55,12 @@ 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

package/dist/index.js

@@ -291,7 +291,9 @@ function getPositional(args) {
         "--summary",
         "--since",
         "--format",
-        "--ids"
+        "--ids",
+        "--tag",
+        "--name"
       ].includes(args[i])) {
         i++;
       }
@@ -458,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
@@ -469,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,
@@ -478,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));
@@ -734,8 +739,226 @@ Options:
   console.log(`Synced: ${data.newItems} new, ${data.skipped} skipped, ${data.errors} errors`);
 }
 
-// src/commands/trash.ts
+// 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")) {
     console.log(`shiori trash - List or empty the trash
 
@@ -786,7 +1009,7 @@ Trashed links: ${data.links.length} of ${data.total} total
 }
 
 // src/commands/update.ts
-async function run10(args) {
+async function run11(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori update - Update links
 
@@ -858,7 +1081,7 @@ Options:
 }
 
 // src/commands/whoami.ts
-async function run11(args) {
+async function run12(args) {
   if (hasFlag(args, "--help", "-h")) {
     console.log(`shiori whoami - Show current user info
 
@@ -894,7 +1117,7 @@ function reportError(command, error) {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({
-      version: "0.5.0",
+      version: "0.7.0",
       command,
       error: message,
       platform: process.platform
@@ -940,11 +1163,12 @@ var COMMANDS = {
   get: { run: run4, desc: "Get a link by ID (includes content)" },
   content: { run: run2, desc: "Print link content as markdown" },
   save: { run: run6, desc: "Save a new link" },
-  update: { run: run10, desc: "Update a link" },
+  update: { run: run11, desc: "Update a link" },
   delete: { run: run3, desc: "Delete a link (move to trash)" },
-  trash: { run: run9, desc: "List or empty the trash" },
+  trash: { run: run10, desc: "List or empty the trash" },
   subscriptions: { run: run8, desc: "Manage RSS subscriptions" },
-  whoami: { run: run11, desc: "Show current user info" }
+  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
@@ -974,7 +1198,7 @@ async function main() {
     return;
   }
   if (command === "--version" || command === "-v") {
-    console.log("0.5.0");
+    console.log("0.7.0");
     return;
   }
   const cmd = COMMANDS[command];
@@ -987,7 +1211,7 @@ async function main() {
   const cmdArgs = args.slice(1);
   const isJson = cmdArgs.includes("--json");
   await cmd.run(cmdArgs);
-  checkForUpdate("0.5.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.5.0",
+  "version": "0.7.0",
   "description": "CLI for managing your Shiori link library",
   "author": "Brian Lovin",
   "license": "MIT",