preparar-ferramentas · git:20261111.1b4910b · 2026-11-11 · sha256 552e1f05e5f49007

preparar-ferramentas git:20261111.1b4910bA

Immutable. This exact content never changes and is served at /api/v1/blob/552e1f05e5f49007.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_gqcvd7go3mhzcnxi/552e1f05e5f49007f78e8844347d5683277670de285b796811ded82976bee2f0.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.
Se faltar ou falhar, siga o [preparo automático](../../../scripts/preparar-ferramentas/BOOTSTRAP.md):
use `--runtime-only` no shell macOS/Linux ou `-RuntimeOnly` no PowerShell para
preparar apenas Node/npm, depois execute a operação original. Faça esses passos
pelo usuário e reutilize o caminho de Node informado.

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 buscar versões novas, `update` consulta `latest` oficial.
`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.

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.