slackcli

name

slackcli

description

Slack CLI: Send messages, read conversations, search, and manage Slack workspaces from the terminal. Use when the user asks anything related to Slack — sending messages, checking unreads, searching conversations, or managing workspaces. Also trigger when a Slack URL is provided (e.g., https://*.slack.com/archives/*, app.slack.com/*) or when the conversation context mentions Slack threads, channels, or messages.

slackcli

Slack ワークスペースを操作する CLI ツール。メッセージ送信・会話管理・検索・保存済みアイテムの操作が可能。

Security Rules

• messages send / messages react / messages draft は 実行前にユーザー確認必須（外部に影響する操作）
• 読み取り系（conversations list/read/unread, search, saved list）は確認なしで実行可
• トークン値を出力に含めない

Prerequisites

# インストール確認
which slackcli

# 認証状態の確認
slackcli auth list

未認証の場合は「認証セットアップ」セクションを案内する。

認証セットアップ（ブラウザトークン）

parse-curl（推奨・最も簡単）

ブラウザの DevTools で Slack API リクエストを右クリック → Copy as cURL → CLI にペースト。

# クリップボードから自動抽出してログイン
slackcli auth parse-curl --from-clipboard --login

# パイプ経由
pbpaste | slackcli auth parse-curl --login

# インタラクティブモード
slackcli auth parse-curl --login

login-browser（手動指定）

ブラウザの DevTools から xoxd / xoxc トークンを手動で抽出して指定する。

slackcli auth login-browser \
  --xoxd=xoxd-YOUR-TOKEN \
  --xoxc=xoxc-YOUR-TOKEN \
  --workspace-url=https://yourteam.slack.com

トークン抽出手順のガイドを表示:

slackcli auth extract-tokens

認証管理

コマンド	説明
slackcli auth list	認証済みワークスペース一覧
slackcli auth set-default <workspace-id>	デフォルトワークスペース設定
slackcli auth remove <workspace-id>	ワークスペース削除
slackcli auth logout	全ワークスペースからログアウト

Command Reference

共通オプション: ほぼ全コマンドに --workspace <id|name> がある（デフォルト以外のワークスペースを指定可能）。

conversations — 会話管理

コマンド	説明	主要オプション
slackcli conversations list	会話一覧	--types (public_channel,private_channel,mpim,im), --limit (default:100), --exclude-archived, --cursor, --workspace
slackcli conversations read <channel-id>	メッセージ履歴取得	--thread-ts, --exclude-replies, --limit (default:100), --oldest, --latest, --workspace, --json
slackcli conversations unread	未読会話一覧	--types (channels,dms,groups), --workspace, --json

messages — メッセージ操作

注意: send / react / draft は実行前にユーザー確認を取ること。

コマンド	説明	主要オプション
slackcli messages send	メッセージ送信	--recipient-id (必須), --message (必須), --thread-ts, --workspace
slackcli messages react	リアクション追加	--channel-id (必須), --timestamp (必須), --emoji (必須), --workspace
slackcli messages draft	下書き作成 (ブラウザトークン専用)	--recipient-id (必須), --message (必須), --thread-ts, --workspace

search — 検索

コマンド	説明	主要オプション
slackcli search messages <query>	メッセージ検索	--in, --from, --limit (default:20), --page, --sort (score/timestamp), --sort-dir (asc/desc), --workspace, --json
slackcli search channels <query>	チャンネル検索	--limit (default:20), --workspace, --json
slackcli search people <query>	ユーザー検索	--limit (default:20), --workspace, --json

saved — 保存済みアイテム

コマンド	説明	主要オプション
slackcli saved list	保存済みアイテム一覧	--limit (default:20), --state (saved/completed), --workspace, --json

update — 更新

コマンド	説明
slackcli update	最新バージョンに更新
slackcli update check	更新の有無を確認

Discovering Commands

# ヘルプ表示
slackcli --help
slackcli <command> --help