convez.ai
PluginDevOps & InfraestruturaIntermediário
WhenLabs-org

WhenLabs When

WhenLabs-org/when

Seis ferramentas dev, uma instalação, máxima produtividade no Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Kit de ferramentas para desenvolvedores TypeScript que integra seis utilitários em um único servidor MCP: detecção de stack, validação de .env, verificação de portas, sincronização de documentação, análise de licenças e cronometragem de tarefas. Funciona nativamente no Claude Code com auto-discovery de quando usar cada ferramenta.

Instalação

$npx convez-ai WhenLabs-org/when

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
4
Forks
0
Acompanhando
1
Saúde
50%
Último commit
há 3 dias
Versão
@whenlabs/when@0.12.3
Issues abertas
9
Contribuidores
2

Casos de uso

  • Onboarding automático de projetos com detecção de stack e contexto para IA
  • Validação de variáveis de ambiente antes de iniciar dev servers
  • Monitoramento de portas em conflito em tempo de desenvolvimento
  • Detecção de desatualização entre documentação e código
  • Auditoria de licenças de dependências contra políticas
  • Rastreamento e aprendizado de velocidade de tarefas de coding

Veredito

Toolkit bem pensado que resolve dores reais do workflow dev com integração limpa no Claude Code. A abordagem de 'seis ferramentas, um servidor' reduz fricção — ideal para equipes que querem automatizar health checks de projeto sem overhead.

README

A tradução para o português deste README ainda está na fila.

@whenlabs/when

Six tools. One install.

A single installable toolkit that brings six WhenLabs developer tools into your Claude Code workflow. After install, the tools are exposed over a single MCP server and Claude calls them automatically when relevant.

Install

npx @whenlabs/when install

One-time setup. The installer:

  1. Registers a single MCP server (whenlabs) in your Claude Code configuration
  2. Injects a CLAUDE.md block so Claude knows when to use each tool
  3. Cleans up any legacy velocity-mcp registration (velocity is now bundled)

The six tools

ToolPurpose
awareAuto-detect stack and generate AI context files (CLAUDE.md, .cursorrules, …)
berthDetect port conflicts before starting dev servers
envalidValidate .env files against a schema
staleDetect documentation drift between docs and code
vowScan dependency licenses and validate against policy
velocityTime coding tasks and learn from historical data

MCP tools

Eight endpoints across the six tools:

EndpointWhat it does
aware_syncDetect stack and regenerate AI context files
berth_checkScan project for port conflicts
envalid_validateValidate .env files against schema
stale_scanDetect documentation drift
vow_scanScan licenses and validate against policy
velocity_start_taskStart timing a coding task
velocity_end_taskEnd timing and record results
whenlabs_summaryUnified rollup across all five scanners in one call

All eight are served by the single whenlabs MCP server (stdio, Node 20+). Fix/init/auxiliary commands remain available via each tool's CLI (npx @whenlabs/<tool> --help).

CLI

when init       # Onboard a project — detect stack, bootstrap configs, run all checks
when doctor     # Run all six tools and show a unified health report
when install    # Register MCP server in Claude Code
when uninstall  # Remove MCP server

For per-tool operations, use the tool directly:

npx @whenlabs/stale scan
npx @whenlabs/envalid validate
npx @whenlabs/berth check
npx @whenlabs/aware sync
npx @whenlabs/vow scan

Manual MCP configuration

If you're not using the install command, add this to your Claude Code MCP config:

{
  "mcpServers": {
    "whenlabs": {
      "command": "npx",
      "args": ["@whenlabs/when", "when-mcp"]
    }
  }
}

License

MIT — see LICENSE


Built by Siddharth at WhenLabs

Ver o original no GitHub

Bom para

Relacionados