slacker.sh
CJHwong/slacker.sh
CLI Slack minimalista em bash que retorna XML estruturado para agentes
Ver no GitHubCLI portátil e amigável a agentes para Slack que retorna payloads XML totalmente resolvidos. Implementado em bash puro com jq e curl, sem dependências de servidor MCP ou runtimes. Cada comando agrupa múltiplas chamadas da API Slack em uma única intenção, transformando IDs em nomes, decodificando menções, agregando reações e humanizando timestamps.
Instalação
npx convez-ai CJHwong/slacker.sh1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Leitura e navegação de canais Slack com contexto completo
- Integração de agentes IA com workspace Slack sem SDKs pesados
- Automação de workflows Slack em ambientes com recursos limitados
Veredito

Ferramenta bem projetada para integração leve de Slack com agentes Claude. A abordagem minimalista (bash + jq + curl) é pragmática e reduz fricção de deployment, embora o XML gerado requeira ajuste dos prompts do agente para interpretação correta.
README
A tradução para o português deste README ainda está na fila.
slacker.sh
A portable, agent-friendly Slack CLI. It's plain bash and leans only on tools
you almost certainly already have (jq and curl), so there's no MCP server,
language runtime, or SDK to install; drop the scripts anywhere and run.
Each command is one intention that composes several Slack Web API calls into one fully-resolved XML payload — IDs become names, mentions and links decoded, reactions and files folded in, thread sizes shown, timestamps humanized — so an agent gets the whole picture in one call, with no follow-up ID-chasing.
$ slacker.sh read-channel '#general' --limit 3
<channel name="general" id="C0743D6UF">
<message author="Alice Lee" time="2026-06-14 10:02" replies="2">
<text>shipping the release today, thanks @Bob and #release-mgmt</text>
<reactions><reaction emoji="rocket" count="2" by="Bob, Carol"/></reactions>
</message>
</channel>
Install
curl -fsSL https://raw.githubusercontent.com/CJHwong/slacker.sh/main/install.sh | bash
This installs the skill to ~/.claude/skills/slacker-sh (it fetches the repo and
copies the payload). Or clone and run it yourself:
git clone https://github.com/CJHwong/slacker.sh.git && ./slacker.sh/install.sh.
Then add a Slack user token (xoxp-…) — follow the
setup guide
to create the app and get one:
echo 'SLACKER_SH_TOKEN=xoxp-…' > ~/.claude/skills/slacker-sh/.env
~/.claude/skills/slacker-sh/slacker.sh whois @yourname # verify -> a <user> record
Requirements: bash, jq, curl (checked at startup). To call it as plain
slacker.sh, symlink it onto your PATH. The installed copy is self-contained, so
you can delete the clone afterward.
Updating
Re-run the installer — it reinstalls the latest:
curl -fsSL https://raw.githubusercontent.com/CJHwong/slacker.sh/main/install.sh | bash
Docs
- Commands, output markers, gotchas — SKILL.md. The authoritative reference; it's also what the agent reads.
- Create the Slack app — reference/setup.md: manifest, scopes, token.
- Design rationale & limitations — .dev/PLAN.md.
Configuration
| Env var | Effect |
|---|---|
SLACKER_SH_TOKEN | the xoxp-… user token (required) |
SLACKER_SH | path to slacker.sh, if not invoking it by full path |
SLACKER_CACHE_TTL | users/channels cache TTL, seconds (default 3600) |
SLACKER_CONCURRENCY | parallel thread fetches for --threads (default 8) |
SLACKER_SH_NO_UPDATE_CHECK | set 1 to silence the update notice |
Development
The repo root is the skill (what install.sh ships); .dev/ is dev-only.
./.dev/tests/run.sh # offline unit + live round-trips (self-DM, cleaned up)
SLACKER_SKIP_LIVE=1 ./.dev/tests/run.sh # unit only (no token)
./.dev/tests/unit.sh # just the offline unit tests
shellcheck -x slacker.sh lib/*.sh actions/*.sh install.sh .dev/tests/*.sh