use-slack

scripts/slack.py <method> [key=value ...] calls any Slack Web API method as the user and prints the JSON. Stdlib only.

python3 scripts/slack.py auth.test
python3 scripts/slack.py search.messages query="deploy failed in:#general after:2026-10-01" count=20
python3 scripts/slack.py conversations.replies channel=C0123ABCD ts=1730730000.123456

Auth

Env vars, usually exported from ~/.zshrc:

• SLACK_D_COOKIE: value of the d cookie (xoxd-...), from DevTools > Application > Cookies on https://app.slack.com.
• SLACK_URL: https://<workspace>.slack.com.
• SLACK_XOXC_TOKEN: optional. The script fetches a fresh xoxc-... token from the workspace page with the cookie when this is unset or rejected.

If a var is missing in the agent's shell, run with zsh -ic 'python3 scripts/slack.py ...' so ~/.zshrc loads. On "the d cookie expired", ask the user to copy a fresh d cookie. Never print the cookie or token.