slkcli 0.1.0 → 0.1.2

package/README.md

@@ -20,6 +20,20 @@ npx slkcli auth
 
 **Requirements:** macOS, Slack desktop app (installed and logged in), Node.js 18+.
 
+## Agent Skill
+
+Add to your AI agent (Claude Code, Codex, Moltbot, etc.):
+
+```bash
+# ClawdHub
+clawdhub install slack-personal
+
+# skills.sh
+npx skills add therohitdas/slkcli
+```
+
+Browse on [ClawdHub](https://www.clawhub.ai/therohitdas/slack-personal).
+
 ## Quickstart
 
 ```bash
@@ -45,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
 
@@ -70,8 +87,26 @@ 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
+
+| Flag | Description |
+|------|-------------|
+| `--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
+slk read general 10 --ts
+# Output: [1/30/2026, 11:41:19 AM ts:1769753479.788949] User [3 replies]:
+
+# Then read that thread
+slk thread general 1769753479.788949
+```
+
 ### Drafts
 
 Drafts sync to Slack — they appear in the Slack editor UI.

package/bin/slk.js

@@ -11,6 +11,7 @@ const args = process.argv.slice(2);
 const command = args[0];
 
 const supportsEmoji = !process.env.NO_EMOJI && !process.argv.includes("--no-emoji");
+const showTs = process.argv.includes("--ts");
 const e = (emoji, fallback = "") => supportsEmoji ? emoji + " " : fallback;
 
 const HELP = `${e("💬")}slk — Slack CLI for macOS (auto-auth from Slack desktop app)
@@ -27,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):
@@ -37,6 +39,7 @@ Drafts (synced to Slack UI):
   slk draft drop <id>                     Delete a draft
 
 Settings:
+  --ts                                    Show raw Slack timestamps (for thread commands)
   --no-emoji                              Disable emoji output (or set NO_EMOJI=1)
 
 Channels: name ("general") or ID ("C08A8AQ2AFP"). Aliases shown in parens.
@@ -68,8 +71,8 @@ async function main() {
 
       case "read":
       case "r":
-        if (!args[1]) { console.error("Usage: slk read <channel> [count]"); process.exit(1); }
-        await cmd.read(args[1], parseInt(args[2]) || 20);
+        if (!args[1]) { console.error("Usage: slk read <channel> [count] [--ts]"); process.exit(1); }
+        await cmd.read(args[1], parseInt(args[2]) || 20, showTs);
         break;
 
       case "send":
@@ -117,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.0",
+  "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

@@ -75,7 +75,7 @@ export async function channels() {
   }
 }
 
-export async function read(channelRef, count = 20) {
+export async function read(channelRef, count = 20, showTs = false) {
   const channel = await resolveChannel(channelRef);
   const users = await getUsers();
   const data = await slackApi("conversations.history", {
@@ -91,8 +91,9 @@ export async function read(channelRef, count = 20) {
   for (const msg of messages) {
     const who = userName(users, msg.user);
     const time = formatTs(msg.ts);
+    const tsStr = showTs ? ` ts:${msg.ts}` : "";
     const thread = msg.reply_count ? ` [${msg.reply_count} replies]` : "";
-    console.log(`[${time}] ${who}${thread}:`);
+    console.log(`[${time}${tsStr}] ${who}${thread}:`);
     console.log(`  ${msg.text}`);
     if (msg.files?.length) {
       for (const f of msg.files) {
@@ -332,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", {