agent-slack 0.4.2 → 0.4.4

package/README.md

@@ -4,15 +4,17 @@ 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
 
 Install via Bun (recommended):
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/stablyai/agent-slack/master/install.sh | sh
+curl -fsSL https://raw.githubusercontent.com/stablyai/agent-slack/main/install.sh | sh
 ```
 
 OR npm global install (requires Node >= 22.5):
@@ -27,7 +29,7 @@ npm i -g agent-slack
 - **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
+- **Channels**: list conversations, create channels, and invite users by id/handle/email
 - **Canvas**: fetch Slack canvases as Markdown
 
 ## Agent skill
@@ -42,21 +44,24 @@ npx skills add stablyai/agent-slack
 
 <details>
 <summary>Manual installation</summary>
+    
 ```bash
 bash ./scripts/install-skill.sh
 ```
+
 </details>
 
 ## Command map (high level)
 
 ```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 )
@@ -69,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
@@ -92,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:
 
@@ -100,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
 ```
 
@@ -208,9 +215,18 @@ 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
+### 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"
 
@@ -229,6 +245,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.