convez.ai
MCP ServerIntegração & APIsIntermediário
CJHwong

slacker.sh

CJHwong/slacker.sh

CLI Slack minimalista em bash que retorna XML estruturado para agentes

Ver no GitHub
InicialPluginScore · de 0 a 100

CLI 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.sh

1 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

Estrelas
0
Forks
3
Acompanhando
0
Saúde
28%
Último commit
há 2 semanas
Versão
—
Issues abertas
0
Contribuidores
1

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 varEffect
SLACKER_SH_TOKENthe xoxp-… user token (required)
SLACKER_SHpath to slacker.sh, if not invoking it by full path
SLACKER_CACHE_TTLusers/channels cache TTL, seconds (default 3600)
SLACKER_CONCURRENCYparallel thread fetches for --threads (default 8)
SLACKER_SH_NO_UPDATE_CHECKset 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
Ver o original no GitHub

Bom para

Relacionados