Dados de uso

Os downloads dizem quantas vezes um pacote foi baixado; não dizem se um item é usado. Quando esta instância coleta dados de uso, o rmk conta, para os itens que instalou, quantas vezes cada um é instalado e removido, em qual ferramenta de IA, quantas vezes ele roda e como essas execuções terminam, e envia essas contagens para esta instância.

As contagens servem para todos que estão escolhendo um item, e para moderadores e autores: o que vale a pena continuar mantendo, e o que uma depreciação ou uma retirada atingiria. Elas aparecem na página do item (Como ler os números). Só totais são guardados: nada diz quem, nem onde.

O root decide, para a instância inteira, em Admin › Settings. A mudança vale na hora e fica registrada no log de auditoria.

• Off (a configuração de uma instância nova): o rmk não informa nada, e a instância recusa relatórios de uso.
• People choose: o rmk informa, a menos que a pessoa desligue (Como desligar).
• Required: todo rmk que instala desta instância informa, e nada desliga isso.

O rmk pede a política à instância no máximo uma vez por dia, e no rmk login. Na primeira vez que informa a uma instância, ele avisa isso, uma vez, com um link para esta página.

Um relatório é uma lista de contagens diárias. Esta é uma linha inteira, exatamente como ela trafega:

{ "day": "2026-10-01", "item": "@platform/code-reviewer", "version": "1.4.0",
  "tool": "claude-code", "event": "run", "trigger": "model",
  "outcome": "success", "count": 3 }

• event: install, remove ou run.
• trigger, para uma execução: digitada pela pessoa (user), escolhida pelo modelo (model), usada dentro de outro agente (agent), na CI (ci) ou unknown.
• outcome, para uma execução: success, error, cancelled ou unknown quando a ferramenta não informa.

Os relatórios vão só para a instância de onde o item foi instalado, com o seu token de acesso, no fim de um comando rmk. rmk telemetry preview imprime o que está esperando para ser enviado.

Nunca: quem você é, o seu projeto ou repositório (nome, pasta, remote ou branch), prompts ou argumentos, conteúdo ou caminhos de arquivos, o que uma ferramenta recebeu ou devolveu, ids de sessão, valores de ambiente, ou qualquer coisa sobre itens que o rmk não instalou. O seu token é enviado para autorizar o relatório, e nada sobre ele é guardado com as contagens.

Onde a instância deixa cada pessoa escolher:

rmk telemetry off       # stop, on this machine, and delete what's waiting
rmk telemetry on        # report again
rmk telemetry status    # each instance's policy, and whether rmk reports to it
rmk telemetry preview   # what would be sent now

Definir RMK_TELEMETRY=0 no ambiente também desliga, para um script ou para uma máquina inteira. Onde o uso é obrigatório, nenhum dos dois funciona: rmk telemetry off avisa isso, e o rmk continua informando a essa instância.

Instalações e remoções são contadas pelo próprio rmk. Execuções precisam que a ferramenta de IA avise o rmk, então, quando ele informa, o rmk install adiciona um hook, rmk telemetry hook <tool>, às configurações da ferramenta na sua pasta pessoal (nunca às de um projeto, então nada vai para um commit), e avisa isso. rmk telemetry off remove o hook.

Hooks, regras, estilos de saída, linhas de status, políticas de permissões e servidores LSP não rodam sozinhos: contam só instalações. O Codex só roda um hook novo depois que você o revisa na tela /hooks dele.

A instância soma cada relatório a totais diários por item, versão, ferramenta, evento, gatilho e resultado, e os guarda por 90 dias. Nada sobre a pessoa, o token ou o projeto é guardado com eles. Uma linha que ela não consegue contar (um item que ela não tem, um dia antigo demais) é ignorada.

O uso de um item aparece na página dele assim que qualquer instalação ou execução dele tiver sido informada nos últimos 30 dias. Sem nenhuma, a aba Overview avisa isso e mostra os cards de sempre. Números pequenos aparecem como são: poucas execuções podem ser uma pessoa experimentando o item.

O root pode definir um mínimo em Admin › Settings: um item então só mostra o uso a partir desse número de instalações mais execuções em 30 dias, e, abaixo dele, a aba Overview informa o mínimo. Isso evita que um punhado de eventos pareça uma tendência; não distingue uma pessoa muito ativa de muitas pessoas.

• Installs, 30 days: instalações informadas pelo rmk, uma vez por ferramenta (um item instalado para duas ferramentas conta duas vezes), com as remoções e os downloads de todos os tempos abaixo.
• Runs, 30 days: quantas vezes as ferramentas de IA o rodaram, a média por dia e a parcela de execuções bem-sucedidas entre as que tiveram o resultado informado, a partir de 20 delas. Hooks, regras, estilos de saída, linhas de status, políticas de permissões, servidores LSP e pacotes não rodam sozinhos: mostram instalações no lugar.
• Works in: a parcela de cada ferramenta nas execuções (ou instalações), com uma barra na cor de cada ferramenta.
• Usage, last 14 days: execuções por dia, sem o dia de hoje, porque ele ainda está sendo preenchido, com o dia mais movimentado. Os dias são dias UTC, já que o uso é somado por dia UTC, ao contrário dos outros horários do app; depois, execuções por ferramenta, pelo que as iniciou (digitadas, escolhidas pelo modelo, usadas dentro de um agente, CI) e pela forma como terminaram. Uma ferramenta que não consegue informar as execuções deste item aparece ali (O que cada ferramenta de IA informa).
• Versions: execuções e instalações por versão em 30 dias, também nas caixas de diálogo de depreciação e de retirada.

Quando o root desliga o uso, o que já está guardado continua aparecendo, com uma nota, até acabarem os 90 dias.