slkcli 0.1.0 → 0.1.1

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
@@ -72,6 +86,22 @@ slk react general 1234567890.123456 thumbsup
 | `slk starred` | `star` | Show VIP users and starred items |
 | `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`) |
+
+```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)
@@ -37,6 +38,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 +70,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":

package/package.json

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

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) {