What's Running

Ground truth ao vivo do SO para agentes: sessões de agentes em execução, portas TCP em escuta, daemons carregados e carga do sistema, lidos direto do SO em vez de documentação desatualizada ou memória.

Documentação

whats-running-mcp

npm license Glama

Fonte da verdade para frotas de agentes. Um servidor MCP que informa ao seu agente de IA o que está realmente em execução na máquina — sessões de agentes ativas, portas TCP em escuta, daemons carregados, carga do sistema — lido diretamente do SO (ps / lsof / launchctl / df), nunca de documentos, transcrições ou arquivos de memória.

Por quê

Se você executa mais de uma sessão de agente de codificação (Claude Code, Codex, Aider…), já viu esse modo de falha: um agente faz "health-check" de um servidor que morreu há semanas, ou relata com confiança que um daemon está ativo porque uma transcrição antiga dizia isso. A memória do modelo é um cache sem invalidação. O SO é a fonte da verdade.

Este servidor começou como um script de shell (whats-running) que escrevi depois que minha própria frota de sessões do Claude Code continuava reportando estado obsoleto como ativo. Envolvê-lo em MCP significa que cada sessão se ancora da mesma forma, automaticamente.

Ferramentas

FerramentaO que responde
whats_runningSnapshot completo em uma única chamada — use no início da sessão
agent_sessionsQuais processos de agente estão ativos? Anexados ao terminal vs. destacados/órfãos, com pid, tempo de atividade e diretório de trabalho
listening_portsO serviço X está realmente no ar? Cada socket TCP LISTEN com o processo dono
daemonsQuais serviços persistentes estão carregados? launchctl (macOS, não-Apple) ou serviços de usuário do systemd (Linux), com filtro opcional de rótulo
system_statsCarga média, tempo de atividade, espaço livre no disco raiz

Instalação

Claude Desktop (um clique, sem terminal): baixe o whats-running-mcp-<version>.dxt mais recente de Releases e abra-o com o Claude Desktop (duplo clique, ou Configurações → Extensões → Instalar Extensão…). O servidor e suas dependências vêm dentro do pacote — sem npm, sem instalação de Node.

Registre com o Claude Code (disponível em todas as sessões):

claude mcp add --scope user whats-running -- npx -y whats-running-mcp

Ou em qualquer configuração de cliente MCP:

{
  "mcpServers": {
    "whats-running": {
      "command": "npx",
      "args": ["-y", "whats-running-mcp"]
    }
  }
}
Do código-fonte
git clone https://github.com/stcmain/whats-running-mcp.git
cd whats-running-mcp
npm install && npm run build
# then point your client at node /path/to/whats-running-mcp/dist/index.js

Publicado como whats-running-mcp no npm e como io.github.stcmain/whats-running-mcp no MCP Registry.

Configuração

Variável de ambientePadrãoFinalidade
WR_AGENT_PATTERNSclaude,codex,aider,cursor-agent,copilot,gooseSubstrings separadas por vírgula que marcam um processo como "agente" em agent_sessions

Notas de design

  • Somente leitura por construção. Cada comando é um binário fixo com flags fixas via execFile — sem shell, e nada derivado de entrada do modelo é jamais executado. As únicas entradas controladas pelo modelo são um booleano e um filtro de substring aplicados em processo.
  • Divulgação local de informações é o objetivo. O modelo vê nomes de processos, pids, diretórios de trabalho e portas da sua própria máquina. Não anexe este servidor a um cliente não confiável.
  • Melhor esforço, nunca bloqueante. Comandos expiram em 10s e degradam para resultados vazios em vez de gerar erro no snapshot inteiro.

Plataforma: macOS primeiro (meu driver diário), Linux em melhor esforço (systemd --user no lugar de launchctl).

Ferramentas gratuitas relacionadas

Mesma ideia — somente leitura, MIT, sem telemetria — apontadas para diferentes pontos cegos:

  • whats-loaded-mcp — o que está consumindo o contexto do seu agente antes de uma sessão começar: descrições de skills ranqueadas por custo de tokens, skills instalados mais de uma vez, tamanhos de CLAUDE.md/AGENTS.md incluindo o que seus imports puxam. npx -y whats-loaded-mcp
  • whats-inherited-mcp — o que um checkout diz ao seu agente para fazer antes de você executá-lo: arquivos de instrução, comandos ligados a execução automática, servidores MCP declarados, skills incluídos. Strings de repositório retornam rotuladas como dados, não instruções. npx -y whats-inherited-mcp
  • whats-allowed-mcp — o que seu agente pode fazer sem pedir a você: cada arquivo de configuração que contribui com regras de permissão, qual vence, o que roda sem supervisão, e as regras que seu cliente aceita e depois ignora. npx -y whats-allowed-mcp

Quem faz isso

Construído pela Shift The Culture — operamos uma empresa de uma pessoa com agentes de IA e publicamos as ferramentas que precisávamos nós mesmos. Este servidor é gratuito e licenciado sob MIT, sem amarras.

Este servidor é a peça gratuita e independente de uma configuração multi-agente maior. O restante dessas ferramentas é pago:

  • Agent Fleet Ops Kit (US$ 29) — os outros modos de falha de rodar três ou quatro agentes em uma única máquina: duas sessões editando o mesmo checkout, um servidor de desenvolvimento que ninguém é dono (então o agente testa um app diferente do que edita), e servidores MCP vazados de sessões que travaram e seguram portas e RAM por semanas. Prefere PayPal? O mesmo kit no Payhip.
  • Agent Reliability Kit (US$ 29) — um hook Stop e duas CLIs que bloqueiam um turno quando um agente declara "concluído" em relação a um repositório, URL ou build que nunca foi de fato verificado. Prefere PayPal? O mesmo kit no Payhip.

O servidor acima permanece gratuito e MIT de qualquer forma — não tem upsell, não tem telemetria e não tem dependência dos kits pagos.

Patrocinadores

Este servidor é MIT e permanece MIT. Não há edição pro, nem telemetria, e nada é retido da versão gratuita. O patrocínio é como a manutenção é paga sem que nada disso mude.

Ainda sem patrocinadores — a primeira vaga está aberta. Patrocinadores empresariais têm seu nome ou logotipo nesta seção, nos dois servidores irmãos e na página de patrocinadores. Níveis, exatamente o que a colocação inclui e o que ela explicitamente não compra: https://shifttheculture.media/sponsor

Pessoas físicas: https://paypal.me/ShiftTheCultureLLC — qualquer valor, sem regalias, sem nível.

Licença

MIT © Zachary Pampu