AssetDiet MCP

AssetDiet

Inteligência de ativos para agentes de codificação de IA — audite, otimize e reverta mídia com segurança.

Configuração em um comando · Experimente com seu agente · Migração de código · Formatos suportados · Segurança e reversão · Documentação

Agentes de codificação de IA criam interfaces de frontend em segundos, mas tratam mídia como blocos opacos — enviando fotos cruas de 4 MB da câmera, SVGs não comprimidos e ícones duplicados diretamente para o git. O AssetDiet dá olhos para a mídia do seu agente: audita repositórios em milissegundos, executa otimizações nativas sem perdas, atualiza referências no código-fonte e mantém cada byte reversível.

⚡ Configuração em um comando

Conecte o AssetDiet ao seu assistente de codificação de IA sem configuração manual:

npx -y assetdiet-mcp@latest setup --yes

Detecta e registra automaticamente o AssetDiet com Cursor, Claude Desktop, Claude Code, Windsurf e Codex, com backups de configuração .bak com carimbo de data/hora.

Resultados do mundo real

public/hero.png          4.8 MB  →  642 KB   (−86.6%)   balanced
public/icons/logo.svg    184 KB  →   42 KB   (−77.2%)   safe
models/character.glb     8.6 MB  →  3.2 MB   (−62.8%)   balanced

🤖 Experimente com seu agente

Após a configuração, copie e cole este prompt no seu assistente de codificação de IA (Cursor Composer, Claude Code, Windsurf ou Claude Desktop):

Run an AssetDiet audit on this repo under the safe policy. Show me the top assets by potential savings, any exact duplicates, and a short optimization plan. Don't change any files yet.

Seu agente chamará assetdiet_audit, indexará hashes SHA-256, exibirá grupos duplicados e apresentará uma proposta sem riscos antes de pedir sua aprovação.

💻 Ou execute pelo seu terminal

# 1. Read-only audit with instant savings & duplicate discovery
npx -y assetdiet-mcp@latest audit . --policy safe

# 2. Or get a concise 3-line scorecard summary
npx -y assetdiet-mcp@latest audit . --policy safe --summary

# 3. Apply lossless optimizations with atomic journal safety
npx -y assetdiet-mcp@latest optimize . --policy safe

git clone https://github.com/092Abdullah/AssetDiet.git
cd AssetDiet
pnpm install
pnpm build
pnpm test

🔗 Além dos arquivos: migração de referências no código

A maioria dos otimizadores apenas altera arquivos no disco. O AssetDiet também pode atualizar seu código quando os formatos mudam.

Ao converter formatos legados pesados (como .png para os modernos .webp ou .avif), seu agente usa o mecanismo de referência AST e regex do AssetDiet:

• assetdiet_find_references: Rastreia cada referência de código, JSX, TS, CSS e HTML a um ativo em todo o repositório.
• assetdiet_migrate_references: Atualiza atomicamente declarações de importação e caminhos de ativos nos seus arquivos de origem para corresponder aos novos nomes de arquivo otimizados.

// Before
import hero from "./hero.png";
<img src="/assets/hero.png" />;

// After assetdiet_migrate_references
import hero from "./hero.webp";
<img src="/assets/hero.webp" />;

📦 Formatos de ativos suportados

O AssetDiet usa mecanismos nativos testados em batalha e parsers WebAssembly. Zero idas e voltas para a nuvem.

🔄 Como o AssetDiet funciona

1. Escaneamento e grafo: Percorre os arquivos do repositório (respeitando .gitignore, .assetdietignore e exclusões padrão de build), gera hashes de conteúdo com SHA-256 e vincula referências de código.
2. Política e plano: Avalia oportunidades de acordo com a política escolhida (safe, balanced ou aggressive) e cria um plano de execução em memória.
3. Otimização do mecanismo: Envia cada ativo para seu mecanismo nativo, gravando em arquivos de troca temporários isolados (.tmp.<random>).
4. Verificação e commit: Valida profundamente a decodificabilidade e as dimensões. Em caso de sucesso, troca o arquivo atomicamente. Em caso de falha, descarta o arquivo temporário, deixando o original intacto.

🛡️ Segurança e reversão atômica

Cada operação de arquivo é 100% reversível:

1. Backups pré-otimização: Originais exatos, byte por byte, são salvos em .assetdiet/backups/<runId>/ antes da modificação.
2. Diário write-ahead: Transições de estado são registradas em .assetdiet/runs/<runId>.json.
3. Substituições atômicas: Usa renomeações atômicas de nível de sistema operacional (fs.rename). Arquivos nunca são sobrescritos parcialmente.
4. Restauração instantânea:

   npx -y assetdiet-mcp@latest restore --run <runId>
   

🎯 Matriz de políticas de otimização

📊 Resultados do mundo real

AssetDiet avaliado em ativos típicos de repositórios web e de jogos:

🔒 100% local e privado

• Zero telemetria: Sem análises, beacons de rastreamento ou pings de retorno.
• Execução 100% local: Todo o processamento acontece na sua CPU usando mecanismos nativos incorporados. A mídia nunca sai da sua máquina.
• Integração segura com agentes: Apenas metadados de texto concisos são passados via stdio local para seu assistente.

📚 Documentação

• Referência de CLI — Comandos para setup, doctor, audit, optimize, restore e mcp.
• Referência de ferramentas MCP — Especificações completas para todas as 16 ferramentas do Model Context Protocol.
• Configuração e regras de ignorar — Personalizando .assetdietignore, políticas e assetdiet.config.json.
• Guia de instalação — Instalação global, configuração manual e guias por plataforma.
• Arquitetura — Design do monorepo, distribuição autocontida e isolamento via stdio.
• Política de segurança — Práticas de segurança e relatórios.
• Changelog — Histórico de versões.

📄 Licença

MIT © 2026 Contribuidores do AssetDiet