pp-slack

name: pp-slack description: "Slack workspace CLI for the terminal. Send messages, search channels and DMs, list conversations, get user/bot/emoji info, analyze channel health, find stale threads, and sync the workspace locally for fast offline queries. Two auth surfaces coexist: SLACK_BOT_TOKEN (xoxb-, for workspace-wide read + post) and SLACK_USER_TOKEN (xoxp-, for user-scoped actions like DM history or search). Use when the user asks to send a Slack message, search Slack, check channel activity, summarize a digest, find who's on a team, find stale threads, analyze channel health, list users / emoji / reminders / pinned items, or wants offline-capable Slack queries." author: "Matt Van Horn" license: "Apache-2.0" argument-hint: " [args] | install cli|mcp" allowed-tools: "Read Bash" metadata: openclaw: requires: bins: - slack-pp-cli install: - kind: go bins: [slack-pp-cli] module: github.com/mvanhorn/printing-press-library/library/productivity/slack/cmd/slack-pp-cli

Slack - Printing Press CLI

Prerequisites: Install the CLI

This skill drives the slack-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install slack --cli-only
   

2. Verify: slack-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.4 or newer):

go install github.com/mvanhorn/printing-press-library/library/productivity/slack/cmd/slack-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Reach for this when the user wants:

• send a Slack message to a channel or DM
• search Slack across channels, DMs, and threads (live or synced)
• list users, channels, usergroups, custom emoji, pinned items, or reminders
• understand channel health (quiet channels, activity trends, response times, digest)
• find stale or unanswered threads across the workspace
• pull an activity summary for a user or channel
• export channel history to JSONL for archival or migration
• discover the funniest messages in public channels (local-sync-powered novelty query)

Skip it when the user wants to create Slack apps, workflows, or manage admin-only team settings beyond team access logs. Those surfaces are better served by the Slack web admin.

Two Auth Surfaces

Slack has two parallel token types and this CLI supports both:

Set whichever the workspace permits. If both are set, user-token wins for user-scoped endpoints and bot-token otherwise. Get a token at https://api.slack.com/apps -> your app -> OAuth & Permissions.

Argument Parsing

Parse $ARGUMENTS:

1. Empty, help, or --help -> show slack-pp-cli --help
2. Starts with install -> ends with mcp -> MCP installation; otherwise -> CLI installation
3. Anything else -> Direct Use (map to the best command and run it)

MCP Server Installation

The CLI also ships an MCP server at slack-pp-mcp. Install and register:

go install github.com/mvanhorn/printing-press-library/library/productivity/slack/cmd/slack-pp-mcp@latest
claude mcp add -e SLACK_BOT_TOKEN=xoxb-... slack-pp-mcp -- slack-pp-mcp

Ask the user for the actual token value before running.

Direct Use

1. Check installed: which slack-pp-cli. If missing, offer CLI installation.
2. Discover commands: slack-pp-cli --help; drill into slack-pp-cli <cmd> --help.
3. Match the user query to the best command (see Notable Commands below).
4. Execute with --agent for structured output:

   slack-pp-cli <command> [args] --agent
   

5. The --agent flag sets --json --compact --no-input --no-color --yes.

Source routing (local vs live) is controlled by --data-source: auto (default) prefers local-synced data with live fallback; live always hits the API; local runs fully offline against the SQLite snapshot. Run slack-pp-cli sync first to populate the local store for analytics queries.

Notable Commands

Run any command with --help for full flag documentation.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

• Pipeable — JSON on stdout, errors on stderr
• Filterable — --select keeps a subset of fields, with dotted-path support (see below)
• Previewable — --dry-run shows the request without sending
• Cacheable — GET responses cached for 5 minutes, bypass with --no-cache
• Non-interactive — never prompts, every input is a flag

Filtering output

--select accepts dotted paths to descend into nested responses; arrays traverse element-wise:

slack-pp-cli <command> --agent --select id,name
slack-pp-cli <command> --agent --select items.id,items.owner.name

Use this to narrow huge payloads to the fields you actually need — critical for deeply nested API responses.

Response envelope

Data-layer commands wrap output in {"meta": {...}, "results": <data>}. Parse .results for data and .meta.source to know whether it's live or local. The N results (live) summary is printed to stderr only when stdout is a TTY; piped/agent consumers see pure JSON on stdout.

Exit Codes