slkcli 0.1.1 → 0.1.2

package/README.md

@@ -59,6 +59,9 @@ slk unread
 # See starred items and VIP users
 slk starred
 
+# See saved for later items
+slk saved
+
 # See pinned messages in a channel
 slk pins general
 
@@ -84,6 +87,7 @@ slk react general 1234567890.123456 thumbsup
 | `slk activity` | `a` | Show all channel activity with unread/mention counts |
 | `slk unread` | `ur` | Show only channels with unreads (excludes muted) |
 | `slk starred` | `star` | Show VIP users and starred items |
+| `slk saved [count]` | `sv` | Show saved for later items (active by default, `--all` includes completed) |
 | `slk pins <channel>` | `pin` | Show pinned items in a channel |
 
 ### Flags
@@ -92,6 +96,7 @@ slk react general 1234567890.123456 thumbsup
 |------|-------------|
 | `--ts` | Show raw Slack timestamps (useful for getting ts to read threads) |
 | `--no-emoji` | Disable emoji in output (or set `NO_EMOJI=1`) |
+| `--all` | Include completed items in `slk saved` |
 
 ```bash
 # Get timestamps to use with thread command

package/bin/slk.js

@@ -28,6 +28,7 @@ Commands:
   slk activity          (a)               Channel activity with unread/mention counts
   slk unread            (ur)              Channels with unreads (excludes muted)
   slk starred           (star)            VIP users + starred items
+  slk saved [n]         (sv)              Saved for later items (--all includes completed)
   slk pins <ch>         (pin)             Pinned items in a channel
 
 Drafts (synced to Slack UI):
@@ -119,6 +120,11 @@ async function main() {
         await cmd.starred();
         break;
 
+      case "saved":
+      case "sv":
+        await cmd.saved(parseInt(args[1]) || 20, args.includes("--all"));
+        break;
+
       case "pins":
       case "pin":
         if (!args[1]) { console.error("Usage: slk pins <channel>"); process.exit(1); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slkcli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Slack CLI for macOS, so your agents can read and send messages",
   "type": "module",
   "license": "MIT",

package/src/api.js

@@ -29,6 +29,7 @@ export async function slackApi(method, params = {}, retried = false) {
     "conversations.open",
     "client.counts",
     "users.prefs.get",
+    "saved.list",
   ];
 
   const isWrite = writeMethods.some((m) => method.startsWith(m));

package/src/commands.js

@@ -333,6 +333,72 @@ export async function pins(channelRef) {
   }
 }
 
+export async function saved(count = 20, includeCompleted = false) {
+  const users = await getUsers();
+
+  // Build channel name map
+  const chData = await slackPaginate("conversations.list", {
+    types: "public_channel,private_channel,mpim,im",
+    exclude_archived: true,
+  });
+  const chMap = {};
+  if (chData.ok) {
+    for (const ch of chData.channels) {
+      chMap[ch.id] = ch.name || (ch.user ? `DM:${userName(users, ch.user)}` : ch.id);
+    }
+  }
+
+  const data = await slackApi("saved.list", { count });
+  if (!data.ok) {
+    console.error(`Error: ${data.error}`);
+    process.exit(1);
+  }
+
+  const items = data.saved_items || [];
+  const counts = data.counts || {};
+  console.log(`📑 Saved for Later — ${counts.uncompleted_count || 0} active, ${counts.completed_count || 0} completed\n`);
+
+  if (!items.length) {
+    console.log("No saved items.");
+    return;
+  }
+
+  for (const item of items) {
+    if (!includeCompleted && item.state === "completed") continue;
+
+    const chName = chMap[item.item_id] || item.item_id;
+    const savedAt = formatTs(item.date_created);
+    const state = item.state === "completed" ? " ✅" : "";
+
+    // Fetch the actual message
+    try {
+      const msgData = await slackApi("conversations.history", {
+        channel: item.item_id,
+        latest: item.ts,
+        inclusive: true,
+        limit: 1,
+      });
+      if (msgData.ok && msgData.messages?.[0]) {
+        const msg = msgData.messages[0];
+        const who = userName(users, msg.user);
+        const msgTime = formatTs(msg.ts);
+        console.log(`[saved ${savedAt}]${state} #${chName} — ${who} (${msgTime}):`);
+        console.log(`  ${(msg.text || "").substring(0, 300)}`);
+        if (msg.files?.length) {
+          for (const f of msg.files) {
+            console.log(`  📎 ${f.name} (${f.mimetype})`);
+          }
+        }
+      } else {
+        console.log(`[saved ${savedAt}]${state} #${chName} (ts: ${item.ts}) — could not fetch message`);
+      }
+    } catch {
+      console.log(`[saved ${savedAt}]${state} #${chName} (ts: ${item.ts}) — access denied or channel not found`);
+    }
+    console.log();
+  }
+}
+
 export async function react(channelRef, ts, emoji) {
   const channel = await resolveChannel(channelRef);
   const data = await slackApi("reactions.add", {