Slackcli

slackcli

Three phases, always in this order. Phases 1 and 2 are checks; only do their setup work when the check fails. $ARGUMENTS, if set, is the request for phase 3.

1. Installed?

command -v slackcli && slackcli --version

Passes: go to phase 2. Fails: first check ls ~/.local/bin/slackcli (installed but off PATH; fix PATH, do not reinstall). Otherwise ask the user with AskUserQuestion before installing. Never sudo, never system directories.

• Homebrew (recommended if brew exists): brew tap shaharia-lab/tap && brew install slackcli
• Binary to ~/.local/bin: asset from uname -sm: Linux x86_64 slackcli-linux, Linux arm64 slackcli-linux-arm64, Darwin x86_64 slackcli-macos, Darwin arm64 slackcli-macos-arm64.

  A=slackcli-linux; B=https://github.com/shaharia-lab/slackcli/releases/latest/download; T=$(mktemp -d)
  curl -fsSL "$B/$A" -o "$T/$A" && curl -fsSL "$B/checksums.txt" -o "$T/checksums.txt"
  (cd "$T" && grep " $A\$" checksums.txt | sha256sum -c -)   # macOS: shasum -a 256 -c
  chmod +x "$T/$A" && mkdir -p ~/.local/bin && mv "$T/$A" ~/.local/bin/slackcli

  Checksum mismatch: stop, do not install. Tell the user if ~/.local/bin is not on PATH.
• Windows: point to https://github.com/shaharia-lab/slackcli/releases/latest (slackcli-windows.exe).
• Skip: stop and say what was not done.

Confirm with slackcli --version.

2. Authenticated?

slackcli auth list        # always exits 0

• Prints No authenticated workspaces found.: propose authentication (below).
• Lists workspaces (one marked (default), each with ID and auth type): verify the token with slackcli team info --json (add --workspace=<id|name> if the user named one). On exit 1 the last stderr line is {"error":{"code":…,"hint":…}}: code auth_failed means stale credentials: for a Browser profile try slackcli auth login-auto --headless first, else propose authentication (hint has the command). unknown command, or a last line that is not JSON, means the binary predates team info or JSON errors: probe with slackcli conversations list --limit=1 instead and, once authenticated, offer slackcli update (Homebrew: brew upgrade slackcli), since the reference in phase 3 describes the latest release. Other codes are not auth problems; report and continue.
• Several workspaces and the request does not say which: ask, or use the default and say so.

Propose authentication with AskUserQuestion; never authenticate unasked. Credentials are stored locally in ~/.config/slackcli/.

1. Browser sign-in (recommended; needs Chrome/Edge/Chromium/Brave and a display): run slackcli auth login-auto --timeout=300 with a Bash timeout above 300 s. A window opens; the user signs in (SSO/2FA included) to every workspace they want. All of them are enrolled. No browser found: set SLACKCLI_BROWSER=/path/to/chrome or pick another option.
2. Slack app token (xoxb-/xoxp-): the user runs it themselves so the token never enters the chat: ! slackcli auth login --token=xoxb-… --workspace-name="Team". Bot tokens cannot search messages.
3. cURL from DevTools (no browser window available): user copies any Slack request as cURL and runs ! slackcli auth parse-curl --from-clipboard --login.
4. Not now: stop and say what needs auth.

Verify with slackcli auth list and slackcli team info.