preparar-ferramentas · git:20261112.86248a7 · 2026-11-12 · sha256 0dd56f6d878a330a

preparar-ferramentas git:20261112.86248a7A

Immutable. This exact content never changes and is served at /api/v1/blob/0dd56f6d878a330a.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_gqcvd7go3mhzcnxi/0dd56f6d878a330a77e566bc22235c807c3f2452f56cfba96aebbd6347d74e30.json

Then /plugin install preparar-ferramentas@markdownregistry-gqcvd7go3mhzcnxi in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: preparar-ferramentas
description: Instala e atualiza ferramentas locais de agentes para o SO e arquitetura atuais.
---

# Preparar ferramentas

Identifique a operação e a seleção pedidas. Confira Node.js 24+ e npm antes
dos `.mjs`; reutilize o runtime disponível e seu caminho absoluto.
Com Node 18+, o [bootstrap JavaScript][bootstrap] e `--runtime-only` preparam
Node 24+; depois execute a operação original. Sem Node/npm, instale primeiro
pelo mecanismo nativo do SO. Faça o preparo pelo usuário e reutilize o runtime.

Em `instalar-ferramentas`, o bootstrap sem essa opção já executa
`setup <seleção>`; não repita a instalação. Consultas e execução não devem
acionar `setup`: `check`, `info` e `run` preservam sua operação e seleção.

As definições ficam em `.pbai4devs/tools/<nome>/TOOL.json`: origem, download,
plataformas, entrada e prova de funcionamento. Consulte o
[índice](../../../tools/README.md) e use o script da ferramenta para operações
individuais. Execute `SCRIPT.mjs` com o Node selecionado; ele delega ao
instalador compartilhado.

No preparo inicial, execute `preparar-ferramentas setup` pelo seletor:
instala e verifica todas as ferramentas compatíveis, sem atualizar as saudáveis.
Aceita seleção por nome/grupo; relate falhas e itens não aplicáveis.
Para npm, `update` consulta `latest` oficial; ferramentas nativas de segurança
seguem o pin revisado em `TOOL.json`, sem atualização silenciosa para outro binário.
`install` reutiliza uma instalação saudável; `check` verifica sem rede;
`info` mostra a configuração; `run <nome> [argumentos]` executa sem instalar.
Sem ação, mostre ajuda. Não interprete ausência de argumentos como instalação.

Use `update agent-desktop` quando houver tarefa desktop, ou outro nome definido.
Nenhum modo baixa Chrome ou concede permissões automaticamente. Prefira o
navegador instalado com `--executable-path`; se faltar, combine seu preparo.

Escolha pelo caso de uso no [índice](../../../tools/README.md): `opensrc` para
consultar fontes de dependências; `skills` para descoberta; `just-bash` para
shell virtual; `webreel` para roteiro de vídeo; `portless` para URLs locais.
Em `skills`, use `find` ou `add <origem> --list`; incorporações passam por
`criar-skill` e `sincronizar-agentes`, sem instalador externo nos espelhos.
O shell virtual não substitui testes reais. Só ative proxy, certificados,
serviços ou gravação quando necessários à tarefa e com dependências preparadas.

Para segurança, use [preparar-seguranca](../../../commands/preparar-seguranca/COMMAND.md).
Preparar o CLI e atualizar bases são operações separadas da análise offline.

Antes de usar agent-desktop, leia `skills get desktop` e `skills get platform`
da versão instalada e confira `status`. Para agent-browser, leia
`skills get core` e `--help` da versão instalada e
observe a página antes de agir. Use `verificar-trabalho` para provar resultados.

Versione `TOOL.json`, `SCRIPT.mjs` e `README.md` de
cada ferramenta. Pacotes e registros ficam em `<nome>/.local/`; cache e launchers
em `.pbai4devs/tools/.cache/` e `bin/`, ignorados. O estado próprio da aplicação
segue os caminhos suportados e documentados por ferramenta. Não espelhe tools.
Preserve a instalação anterior se a atualização falhar; informe versões,
resultado e limitações. Um probe de versão não prova um fluxo de interface.

[bootstrap]: ../../../scripts/preparar-ferramentas/BOOTSTRAP.md