agent-slack で Slack を自動化

agent-slack は $PATH にある CLI バイナリです。直接実行してください (例: agent-slack user list)。

インストール

agent-slack が $PATH に見つからない場合は、インストールしてください:

• curl -fsSL https://raw.githubusercontent.com/stablyai/agent-slack/main/install.sh | sh (推奨)
• npm i -g agent-slack (Node >= 22.5 が必要)
• nix run github:stablyai/agent-slack -- <args> (インストール不要、すべてのコマンドにプレフィックス)

重要: Bash コマンドフォーマットルール

Claude Code のパーミッションチェッカーにはセキュリティヒューリスティックがあり、手動承認プロンプトを強制します。これらのパターンを避けることで、コマンドを自動許可のままにできます。参照: https://github.com/anthropics/claude-code/issues/34379

1. コマンド文字列内に # がないこと。 クォート内でも、コメント区切り文字として扱われます。チャネル名は #general ではなく general のように記述します。インラインスクリプトに # コメントは使わず、Bash ツールの description パラメータを使用します。
2. '' (連続する単一引用符) または "" (連続する二重引用符) がないこと。 「潜在的な難読化」チェックをトリガーします。d.get('key', '') のような Python の空文字列リテラルを避けます — d.get('key') を代わりに使用してください。
3. フィルタリングには | jq のみ — python3 や他のコマンドは不可。 python3 -c は許可リストに含まれておらず、プロンプトをトリガーします。単一引用符のみの式を使用する jq (内部に " がない) は安全です:
   • 間違い: agent-slack search ... | python3 -c "..." (許可されていない)
   • 間違い: agent-slack search ... | jq '.a + "x"' (混在したクォート)
   • 正解: agent-slack search ... | jq '.a'
   • 正解: agent-slack search ... | jq '.messages[] | .ts'
4. || または && チェーンはないこと。 複数の agent-slack コマンドを別々の Bash ツール呼び出しとして実行します。
5. ファイルリダイレクト (>, >>) はないこと。 JSON 出力を直接処理し、ファイルに書き込まないでください。

クイックスタート (認証)

認証は macOS と Windows では自動です (Slack Desktop 優先、macOS では Chrome/Firefox へのフォールバック)。

認証情報が利用できない場合は、以下のいずれかを実行してください:

• Slack Desktop インポート (macOS/Windows):

agent-slack auth import-desktop
agent-slack auth test

• Chrome フォールバック:

agent-slack auth import-chrome
agent-slack auth test

• Firefox フォールバック:

agent-slack auth import-firefox
agent-slack auth test

• または環境変数を設定 (ブラウザトークン; チャットログへの貼り付けを避けてください):

export SLACK_TOKEN="xoxc-..."
export SLACK_COOKIE_D="xoxd-..."
agent-slack auth test

• または標準トークンを設定:

export SLACK_TOKEN="xoxb-..."  # or xoxp-...
agent-slack auth test

構成されたワークスペースを確認:

agent-slack auth whoami

標準的なワークフロー (Slack メッセージ URL が与えられた場合)

1. 単一のメッセージを取得 (スレッド概要がある場合は含む):

agent-slack message get "https://workspace.slack.com/archives/C123/p1700000000000000"

1. 完全なスレッドが必要な場合:

agent-slack message list "https://workspace.slack.com/archives/C123/p1700000000000000"

最近のチャネルメッセージを閲覧

チャネルに最近投稿されたものを確認 (チャネル履歴):

agent-slack message list "general" --limit 20
agent-slack message list "C0123ABC" --limit 10
agent-slack message list "general" --with-reaction eyes --oldest "1770165109.000000" --limit 20
agent-slack message list "general" --without-reaction dart --oldest "1770165109.000000" --limit 20
agent-slack message list "general" --resolve-users

これは最近のメッセージを時系列順で返します。--limit を使用して数を制御します (デフォルト 25)。 --with-reaction または --without-reaction を使用する場合は、スキャンをバウンドするために --oldest も渡す必要があります。

添付ファイル (スニペット/画像/ファイル)

message get/list と search は自動的に添付ファイルをダウンロードし、JSON 出力に含めます (通常は message.files[] / files[] 下)。利用可能な場合は name と、ローカルダウンロード用の path を含みます。失敗したメッセージ添付ファイルダウンロードは添付ファイルエントリを保持し、ローカルの .download-error.txt パスを保存し、message get/list の場合は message.files[].error、search messages|all の場合は messages[].files[].error を含めます; search files はダウンロードに失敗したファイルをスキップします。

メッセージをドラフト (ブラウザエディタ)

フォーマットツールバー (太字、イタリック、打消し線、リンク、リスト、引用符、コード、コードブロック) を使用してメッセージを構成するための Slack のようなリッチテキストエディタをブラウザで開きます。送信後、「View in Slack」リンクを表示します。

agent-slack message draft "general"
agent-slack message draft "general" "initial text"
agent-slack message draft "https://workspace.slack.com/archives/C123/p1700000000000000"

送信、編集、削除、またはリアクション

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 send "general" "Here's the plan:
- Step 1: do the thing
- Step 2: verify it worked
  - Sub-step: check logs"
agent-slack message react add "https://workspace.slack.com/archives/C123/p1700000000000000" "eyes"
agent-slack message react remove "https://workspace.slack.com/archives/C123/p1700000000000000" "eyes"

編集/削除にはチャネルモードで --ts が必要:

agent-slack message edit "general" "Updated text" --workspace "myteam" --ts "1770165109.628379"
agent-slack message delete "general" --workspace "myteam" --ts "1770165109.628379"

message send の添付オプション:

• --attach <path> ローカルファイルをアップロード (繰り返し可)
• --blocks <path> JSON ファイル (または stdin の場合は -) から raw Block Kit ブロックを送信します。ヘッダー、区切り線、テーブルブロック、その他の構造化レイアウトを有効にします。--attach と互換性がありません。

message send は channel_id と投稿された ts および permalink を返します (非添付ファイル送信の場合)。thread_ts はスレッドに返信するときにのみ表示されます。

メンション: @U05BRPTKL6A、@here、@channel、@everyone を記述するだけです — CLI はそれらを実際の Slack メンショントークンに変換し、テキスト内のリテラル &/</> をエスケープします。ID を自分でラップする必要はありません。

チャネルリストの表示 + チャネル作成/ユーザー招待

agent-slack channel list
agent-slack channel list --user "@alice" --limit 50
agent-slack channel list --all --limit 100
agent-slack channel new --name "incident-war-room"
agent-slack channel new --name "incident-leads" --private
agent-slack channel invite --channel "incident-war-room" --users "U01AAAA,@alice,bob@example.com"
agent-slack channel invite --channel "incident-war-room" --users "partner@vendor.com" --external
agent-slack channel invite --channel "incident-war-room" --users "partner@vendor.com" --external --allow-external-user-invites

--external の場合、招待先はメールアドレスである必要があります。デフォルトでは、招待者は外部に制限されます; --allow-external-user-invites を追加して、他のユーザーを招待することを許可します。

検索 (メッセージ + ファイル)

信頼性のためにチャネルスコープ検索を優先:

agent-slack search all "smoke tests failed" --channel "alerts" --after 2026-01-01 --before 2026-02-01
agent-slack search messages "stably test" --user "@alice" --channel general
agent-slack search messages "stably test" --resolve-users
agent-slack search files "testing" --content-type snippet --limit 10

マルチワークスペースガードレール (重要)

複数のワークスペースが構成されていて、チャネル名 (例: general) を使用する場合は、あいまいさを避けるために --workspace を渡してください (または SLACK_WORKSPACE_URL を設定):

agent-slack message get "general" --workspace "https://myteam.slack.com" --ts "1770165109.628379"
agent-slack message get "general" --workspace "myteam" --ts "1770165109.628379"

DM / グループ DM チャネル

DM またはグループ DM のチャネル ID を取得します。ユーザーのグループにメッセージを送信するのに便利です:

agent-slack user dm-open @alice @bob
agent-slack user dm-open U01AAAA U02BBBB U03CCCC

既読にマーク

チャネル、DM、またはグループ DM を特定のメッセージまで既読にマーク:

agent-slack channel mark "https://workspace.slack.com/archives/C123/p1700000000000000"
agent-slack channel mark "general" --workspace "myteam" --ts "1770165109.628379"
agent-slack channel mark "D0A04PB2QBW" --workspace "myteam" --ts "1770165109.628379"

特定のメッセージを未読に見えるようにするには、--ts をその直前に設定します (0.000001 を減算)。これにより、読み取りカーソルが移動し、そのメッセージ以降がすべて新規に表示されます:

agent-slack channel mark "general" --workspace "myteam" --ts "1770165109.628378"

ワークフロー

チャネルにブックマークされている Slack ワークフローを発見して実行:

# チャネル内のワークフローをリスト
agent-slack workflow list "#ops"

# トリガーメタデータをプレビュー (副作用なし)
agent-slack workflow preview "Ft123ABC"

# フォームフィールドとステップを含むワークフロー定義を取得
agent-slack workflow get "Ft123ABC"
agent-slack workflow get "Wf456DEF"

# ワークフロートリガーをトリップ
agent-slack workflow run "Ft123ABC" --channel "#ops"

Later (保存されたメッセージ)

後で見るメッセージを管理:

agent-slack later list
agent-slack later list --counts-only
agent-slack later list --state completed
agent-slack later complete "<message-url>"
agent-slack later archive "<message-url>"
agent-slack later reopen "<message-url>"
agent-slack later save "<message-url>"
agent-slack later remove "<message-url>"
agent-slack later remind "<message-url>" --in 1h
agent-slack later remind "<message-url>" --in tomorrow

Unreads (受信トレイ表示)

チャネル、DM、スレッド全体のすべての未読メッセージを表示:

agent-slack unreads
agent-slack unreads --counts-only
agent-slack unreads --max-messages 5
agent-slack unreads --include-system

Canvas + Users

agent-slack canvas get "https://workspace.slack.com/docs/T123/F456"
agent-slack user list --workspace "https://workspace.slack.com" --limit 100
agent-slack user get "@alice" --workspace "https://workspace.slack.com"

参考資料

• references/commands.md: 完全なコマンドマップ + すべてのフラグ
• references/targets.md: URL vs #channel ターゲットルール
• references/output.md: JSON 出力形状 + ダウンロードパス