slk — Slack CLI

适用于macOS的基于会话的Slack命令行界面。自动从Slack桌面应用进行身份验证——无需令牌、无需OAuth、无需安装应用。以您的用户身份操作（xoxc-会话令牌）。

命令

# Auth
slk auth                              # Test authentication, show user/team

# Read
slk channels                          # List channels (alias: ch)
slk dms                               # List DM conversations with IDs (alias: dm)
slk read <channel> [count]            # Read recent messages, default 20 (alias: r)
slk read @username [count]            # Read DMs by username
slk read <channel> --threads          # Auto-expand all threads
slk read <channel> --from 2026-02-01  # Date range filter
slk thread <channel> <ts> [count]     # Read thread replies, default 50 (alias: t)
slk search <query> [count]            # Search messages across workspace
slk users                             # List workspace users (alias: u)

# Activity
slk activity                          # All channels with unread/mention counts (alias: a)
slk unread                            # Only unreads, excludes muted (alias: ur)
slk starred                           # VIP users + starred items (alias: star)
slk saved [count] [--all]             # Saved for later items (alias: sv)
slk pins <channel>                    # Pinned items in a channel (alias: pin)

# Write
slk send <channel> <message>          # Send a message (alias: s)
slk react <channel> <ts> <emoji>      # React to a message

# Drafts (synced to Slack editor UI)
slk draft <channel> <message>         # Draft a channel message
slk draft thread <ch> <ts> <message>  # Draft a thread reply
slk draft user <user_id> <message>    # Draft a DM
slk drafts                            # List active drafts
slk draft drop <draft_id>             # Delete a draft

频道参数接受名称（general）、ID（C08A8AQ2AFP）、@用户名用于私信，或用户ID（U07RQTFCLUC）。

身份验证

自动进行——从Slack桌面应用的LevelDB提取会话令牌，并从macOS钥匙串解密cookie。

首次运行：macOS将显示一个钥匙串对话框，要求允许访问"Slack安全存储"：

• 允许——一次性访问，下次会再次提示
• 始终允许—— 永久性，无需未来提示（方便，但任何以您用户身份运行的进程都可以静默提取凭据）
• 拒绝—— 阻止访问，slk 无法进行身份验证

令牌缓存： ~/.local/slk/token-cache.json—— 自动验证，在以下情况自动刷新：身份验证无效时。

如果身份验证失败（令牌轮换、Slack 已登出）：

rm ~/.local/slk/token-cache.json
slk auth

必须安装并登录 Slack 桌面应用。如果令牌已缓存，则无需运行该应用。

读取线程

线程需要 Slack 时间戳。使用--ts获取时间戳，然后读取线程：

slk read general 10 --ts
# Output: [1/30/2026, 11:41 AM ts:1769753479.788949] User [3 replies]: ...

slk thread general 1769753479.788949

代理工作流程示例

• 心跳/定时任务检查未读消息——slk unread→slk read <频道>针对需要关注的频道
• 保存并继续处理— 人类在Slack中保存对话线索（"稍后阅读"）。代理运行slk saved在心跳期间，读取完整对话线索slk thread，进行总结或提取行动项
• 每日频道摘要—slk read <channel> 100跨关键频道 → 编译决策、待解决问题、行动项 →slk send daily-digest "📋 ..."
• 每周私信摘要—slk read @boss 200 --from 2026-02-01 --threads→ 提取行动项、决策、背景信息
• 对话线索监控— 监控特定对话线索的新回复（事件、PR审查、决策）
• 供人类审阅的草稿—slk draft <channel> "..."发布到Slack的编辑器界面，供人类在发送前审阅
• 搜索驱动的上下文—slk search "部署流程"或slk pins <频道>在回答问题前拉取上下文

限制

• 仅限 macOS— 使用钥匙串 + Electron 存储路径
• 基于会话— 以您的用户身份操作，而非机器人。请注意您发送的内容
• 草稿丢弃可能会因draft_has_conflict而失败，如果 Slack 已打开该对话
• 会话令牌登出时失效 — 保持 Slack 应用运行或依赖缓存的令牌

缺失功能与问题

创建 PR 或报告问题请至：https://github.com/therohitdas/slkcli