agent-slack 0.4.3 → 0.5.0

package/README.md

@@ -4,8 +4,10 @@ Slack automation CLI for AI agents (TypeScript + Bun).
 
 Guiding principle:
 
-- **token-efficient output by default** (compact JSON, minimal duplication, and empty/null fields pruned) so LLMs can consume results cheaply.
-- **zero-config auth** -- Auth just works if you have Slack Desktop (with fallbacks available). No Python dependency.
+- **Token-efficient** — (compact JSON, minimal duplication, and empty/null fields pruned) so LLMs can consume results cheaply.
+- **Zero-config auth** — Auth just works if you have Slack Desktop (with fallbacks available). No Python dependency.
+- **Human-in-the-loop** — When appropriate (not in CI environments), loop humans in. Ex: `message draft`
+  <img width="1228" height="741" alt="image" src="https://github.com/user-attachments/assets/92ecbb71-18ca-4516-a874-c83c154b0709" />
 
 ## Getting started
 
@@ -26,8 +28,8 @@ npm i -g agent-slack
 - **Read**: fetch a message, browse channel history, list full threads
 - **Search**: messages + files (with filters)
 - **Artifacts**: auto-download snippets/images/files to local paths for agents
-- **Write**: reply, edit/delete messages, add reactions
-- **Channels**: create channels and invite users by id/handle/email
+- **Write**: reply, edit/delete messages, add reactions (bullet lists auto-render as native Slack rich text)
+- **Channels**: list conversations, create channels, and invite users by id/handle/email
 - **Canvas**: fetch Slack canvases as Markdown
 
 ## Agent skill
@@ -53,17 +55,18 @@ bash ./scripts/install-skill.sh
 
 ```text
 agent-slack
-├── update                            # self-update (detects npm/bun/binary)
+├── update                         # self-update (detects npm/bun/binary)
 ├── auth
 │   ├── whoami
 │   ├── test
 │   ├── import-desktop
 │   ├── import-chrome
+│   ├── import-firefox
 │   └── parse-curl
 ├── message
 │   ├── get   <target>             # fetch 1 message (+ thread meta )
 │   ├── list  <target>             # fetch thread or recent channel messages
-│   ├── send  <target> <text>      # send / reply (does the right thing)
+│   ├── send  <target> <text>      # send / reply (supports --attach)
 │   ├── draft <target> [text]      # open Slack-like editor in browser
 │   ├── edit  <target> <text>      # edit a message
 │   ├── delete <target>            # delete a message
@@ -71,6 +74,7 @@ agent-slack
 │       ├── add    <target> <emoji>
 │       └── remove <target> <emoji>
 ├── channel
+│   ├── list                        # list conversations (user-scoped or all)
 │   ├── new                         # create channel
 │   └── invite                      # invite users to channel
 ├── user
@@ -94,7 +98,7 @@ Notes:
 On macOS, authentication happens automatically:
 
 - Default: reads Slack Desktop local data (no need to quit Slack)
-- Fallback: if that fails, tries Chrome extraction (if Slack is open in Chrome)
+- Fallbacks: if that fails, tries Chrome/Firefox extraction
 
 You can also run manual imports:
 
@@ -102,6 +106,7 @@ You can also run manual imports:
 agent-slack auth whoami
 agent-slack auth import-desktop
 agent-slack auth import-chrome
+agent-slack auth import-firefox
 agent-slack auth test
 ```
 
@@ -197,6 +202,7 @@ After sending, the editor shows a "View in Slack" link to the posted message.
 
 ```bash
 agent-slack message send "https://workspace.slack.com/archives/C123/p1700000000000000" "I can take this."
+agent-slack message send "#alerts-staging" "here's the report" --attach ./report.md
 agent-slack message edit "https://workspace.slack.com/archives/C123/p1700000000000000" "I can take this today."
 agent-slack message delete "https://workspace.slack.com/archives/C123/p1700000000000000"
 agent-slack message react add "https://workspace.slack.com/archives/C123/p1700000000000000" "eyes"
@@ -210,9 +216,22 @@ agent-slack message edit "#general" "Updated text" --workspace "myteam" --ts "17
 agent-slack message delete "#general" --workspace "myteam" --ts "1770165109.628379"
 ```
 
-### Create channels and invite users
+Attach options for `message send`:
+
+- `--attach <path>` upload a local file (repeatable)
+
+### List, create, and invite channels
 
 ```bash
+# List conversations for current user (users.conversations)
+agent-slack channel list
+
+# List conversations for a specific user
+agent-slack channel list --user "@alice" --limit 50
+
+# List all workspace conversations (conversations.list)
+agent-slack channel list --all --limit 100
+
 # Create a public channel
 agent-slack channel new --name "incident-war-room"
 
@@ -231,6 +250,8 @@ agent-slack channel invite --channel "incident-war-room" --users "partner@vendor
 
 Notes:
 
+- `channel list` returns a single page plus `next_cursor`; use `--cursor` to fetch the next page.
+- `channel list --all` and `channel list --user` are mutually exclusive.
 - `--external` maps to `conversations.inviteShared` and expects email targets.
 - External invites default to restricted mode (`external_limited=true`); add `--allow-external-user-invites` to disable that restriction.
 - External invites require Slack Connect permissions/scopes in your workspace.