macbook-performance-tuning

name	macbook-performance-tuning
description	Diagnóstico e otimização de performance do MacBook — memória RAM, LaunchAgents, processos, bateria e swap. Workflow completo de 5 ações testado no MacBook Pro M1 Pro 16GB.
trigger	Quando o utilizador pede "optimizar Mac", "performance do Mac", "libertar RAM", "Mac lento", "diagnóstico do Mac", "limpar caches", "espaço em disco", "mac cheio", "otimizar macbook"
category	apple
tags	["macos","performance","ram","launchagents","memory","swap","battery","m1"]
owner	bianinho

MacBook Performance Tuning

Diagnóstico Completo do MacBook Pro

Step 1: Inventário de Hardware e Sistema

# Modelo, chip, RAM, macOS
system_profiler SPHardwareDataType | grep -E "Model Name|Model Identifier|Chip|Memory"
sw_vers

# Espaço em disco
df -h /

# CPU e núcleos
sysctl -n machdep.cpu.brand_string
sysctl -n hw.ncpu
sysctl -n hw.memsize | awk '{print $1/1024/1024/1024 " GB"}'

Step 2: Estado da Memória (CRÍTICO)

# Memory pressure e swap
vm_stat | grep -E "Pages free|swap"
memory_pressure
sysctl -n vm.swapusage

# Pages free é o indicador principal:
# < 10.000 páginas = PRESSÃO ALTA
# > 20.000 páginas = BOM

Step 3: LaunchAgents ativos

ls -la ~/Library/LaunchAgents/

# Processos Setapp/Steam/Canva ativos
pgrep -af "setapp|steam|canva|google updater"

Step 4: Processos que mais consomem RAM

# Top 10 por memória
top -l 1 -n 10 -o mem -s 0 | grep -E "^\s*[0-9]"

# Top 10 por CPU
top -l 1 -n 10 -o cpu -s 0 | grep -E "^\s*[0-9]"

Step 5: Estado da Bateria

pmset -g batt
ioreg -r -k "CycleCount" -k "MaxCapacity" | grep -E "CycleCount|MaxCapacity"

---

Framework de Ações de Otimização (5 Ações)

AÇÃO 1: Consolidar Processos Duplicados/Órfãos (Impacto: ALTO)

Problema: Processos órfãos (Hermes, Python, etc.) ficam em sleep consumindo RAM.

# Listar todos os processos Python/agent
ps aux | grep -E "Python.*hermes|Python.*rag_server|Python.*bianinho_bridge" | grep -v grep

# Identificar órfãos (mesmo processo, um ativo e outro em sleep antigo)
# Encerrar apenas o órfão (manter o que tem CPU ativo)
kill <PID_ORFÃO>

Como identificar órfão: dois processos iguais, um com CPU% alto (ativo), outro com CPU% 0.0 e uptime muito antigo. O uptime aparece na coluna TIME do ps aux.

Exemplo real (MacBook Pro M1 Pro Álvaro):

• PID 57692 hermes acp — CPU 25.9%, uptime 8:21AM → ATIVO ✅
• PID 37895 hermes acp — CPU 0.0%, uptime 10:54PM (anterior) → ÓRFÃO ❌ → kill 37895 libertou ~58MB RAM

AÇÃO 2: Desativar LaunchAgents Desnecessários (Impacto: ALTO)

# Agentes a DESATIVAR (desnecessários em background):
launchctl unload ~/Library/LaunchAgents/com.setapp.DesktopClient.SetappAgent.plist
launchctl unload ~/Library/LaunchAgents/com.setapp.DesktopClient.SetappLauncher.plist
launchctl unload ~/Library/LaunchAgents/com.setapp.DesktopClient.SetappAssistant.plist
launchctl unload ~/Library/LaunchAgents/com.setapp.DesktopClient.SetappUpdater.plist
launchctl unload ~/Library/LaunchAgents/com.canva.availability-check-agent.plist
launchctl unload ~/Library/LaunchAgents/com.google.GoogleUpdater.wake.plist
launchctl unload ~/Library/LaunchAgents/com.valvesoftware.steamclean.plist

# Matar processos residuais
kill $(pgrep -f "SetappAgent") 2>/dev/null
kill $(pgrep -f "Steamclean") 2>/dev/null
kill $(pgrep -f "canva") 2>/dev/null

Agentes a MANTER:

• AlDente Pro — crítico para saúde da bateria (nunca matar)
• CleanMyMac-setapp — ferramenta de manutenção

AÇÃO 3: Limpar Finder e Apps com Memória Acumulada (Impacto: MÉDIO)

# Finder — reinicia automaticamente
killall Finder

# Telegram — encerra e alerta utilizador para reabrir
killall Telegram

# Brave Browser — fechar abas desnecessárias manualmente

Nota: Quando apps ficam com uptime muito alto (20h+), acumulam memória cached. Encerrar limpa.

AÇÃO 4: Otimizar Browser Brave (Impacto: MÉDIO)

# Múltiplos processos Brave consomem RAM excessiva
# Reduzir abas abertas
# Desativar extensões desnecessárias
# Preferir uma janela com poucas abas

AÇÃO 5: Verificar AlDente Pro (Impacto: BATERIA)

# Garantir que AlDente está ativo e limitado
ps aux | grep -i "aldente" | grep -v grep

Manter carregamento entre 50-80% para preservar longevidade da bateria.

AÇÃO 6: Limpeza de Caches e /tmp (Impacto: DISCO, ~10-12 GB recuperáveis)

ATENÇÃO:-report before execute — usar sempre o padrão: investigar primeiro, apresentar relatório, depois pedir confirmação antes de limpar.

Diagnóstico de caches e disco:

# Espaço em /tmp (lixo de instalações antigas)
du -sh /tmp/* 2>/dev/null | sort -rh

# Caches do sistema (Application Support)
du -sh ~/Library/Application\ Support/* 2>/dev/null | sort -rh | head -15

# Caches do usuário
du -sh ~/Library/Caches/* 2>/dev/null | sort -rh | head -10

# Logs grandes
du -sh ~/Library/Logs/* 2>/dev/null | sort -rh | head -10

Limpeza SEGURA (nunca afeta dados reais):

# /tmp — seguro pois são cópias de instalação, não dados
rm -rf /tmp/aionui-mac
rm -rf /tmp/AionUi
rm -rf /tmp/app_original_hermes
rm -rf /tmp/app_original_check

# Caches de apps (regeneram automaticamente)
rm -rf ~/Library/Caches/com.brave.Browser/*
rm -rf ~/Library/Caches/BraveSoftware/*
rm -rf ~/Library/Caches/SiriTTS/*
rm -rf ~/Library/Caches/electron-builder/*
rm -rf ~/Library/Caches/electron/*
rm -rf ~/Library/Caches/Google/*
rm -rf ~/Library/Caches/Steam/*
rm -rf ~/Library/Caches/Homebrew/*

# Logs
rm -rf ~/Library/Application\ Support/Google/DriveFS/Logs/*

NÃO LIMPAR (dados reais):

Pasta	Tamanho típico	Motivo
anythingllm-desktop/storage	12 GB	Vector database RAG — dados TEN
Google/Chrome/Default/	8 GB	Dados reais do browser
hermes/venv/	644 MB	Ambiente Python
Whisky/Bottles/	5 GB	Jogos Windows (requer confirmação)

Limites de limpeza por app:

App	Limpar?	Comandos seguros
Brave Browser	✅ Cache sim, dados não	~/Library/Caches/BraveSoftware/*, com.brave.Browser/*
SiriTTS	✅ Sim	~/Library/Caches/SiriTTS/*
Electron apps	✅ Cache sim	~/Library/Caches/electron*/*
Google Drive	⚠️ Só logs	DriveFS/Logs/* — nunca tocar em content/
Whisky	❌ Confirmar	Bottle de 5GB pode ser jogo ativo
Steam	⚠️ Só cache	~/Library/Caches/Steam/*
AnythingLLM	❌ Nunca	storage/ = dados RAG

Descoberta real (MacBook Pro M1 Pro Álvaro):

Lixo em /tmp:               ~8.5 GB  (aionui-mac 6.4GB, AionUi 979MB, app_original* 1.1GB)
Caches Brave/electron:       ~1.6 GB
Logs DriveFS/MiniMax:        ~184 MB
─────────────────────────────────────────
TOTAL recuperável seguro:    ~10.3 GB

---

Referência: Comandos de Diagnóstico Rápido

# Resumo completo numa linha
echo "=== MEMÓRIA ===" && vm_stat | grep -E "Pages free|swap"

# Verificar se há swap activo (sinal de pressão)
sysctl -n vm.swapusage

# Pages free: below 10000 = problem, above 20000 = good

# Calcular ganho de RAM (pages × page_size / 1024 / 1024 = MB)
# page_size do M1 Pro = 16384 bytes
vm_stat | grep "Pages free" | awk '{print "Pages livres:", $3, "~"(($3 * 16384) / 1024 / 1024)"MB"}'

Importante: macOS ARM usa page size de 16384 bytes (16KB), não 4KB como x86. Isto afecta cálculos de RAM.

---

Indicadores de Sucesso

Métrica	Antes	Depois
Pages free	< 10.000	> 20.000
Swap usado	> 1 GB	< 500 MB
RAM consumo total	> 12 GB	< 9 GB
Processos órfãos	> 0	0
Espaço em disco livre	basal	+10-12 GB após limpeza
/tmp	com resíduos	< 10 MB

---

armadilhas (Pitfalls)

1. NUNCA matar AlDente Pro — é crítico para a bateria. Se a bateria degrana rapidamente sem ele.
2. NUNCA matar CleanMyMac — é a ferramenta de manutenção do sistema. Confirmado com utilizador: "CleanMyMac é fundamental deixar aberto".
3. Matar apenas o órfão — quando há dois processos iguais, verificar qual está ativo antes de matar.
4. Python 3.14 — path beta em /Library/Frameworks/Python.framework/Versions/3.14/ pode ter memory leaks. Monitorizar instâncias Python.
5. Telegram — após matar, informar o utilizador para reabrir manualmente.
6. Swap activo — se swap > 1GB, prioridade é matar processos, não há outra solução.
7. Regra do utilizador: REPORT BEFORE EXECUTE — "me traga um relatório sempre antes de executar qualquer tarefa". Nunca fazer limpeza sem apresentar dados primeiro e pedir confirmação.

---

AÇÃO 4 — Brave Browser: NOTA IMPORTANTE

O Brave NÃO pode ser otimizado remotamente — não há forma de fechar abas ou desativar extensões via terminal sem encerrar todo o browser (perdes todas as tabs).

Estado real do Brave (MacBook Pro M1 Pro Álvaro):

• 27 processos activos
• ~5.3 GB RAM consumida
• 13 extensões instaladas

Recomendações: informar o utilizador para fechar abas manualmente. Se ele confirmar que quer encerrar tudo: killall "Brave Browser".

AÇÃO 6 — Descobertas Adicionais (Session 04/05/2026)

Bottles Whisky (5GB) — encontrado ~/Library/Containers/com.isaacmarovitz.Whisky/Bottles/AB208556-E3C7-4D7A-9E80-8D5D4B1727E1 com 5GB. NUNCA limpar sem confirmação — pode ser jogo activo.

Python 3.14 — detectado em /Library/Frameworks/Python.framework/Versions/3.14/ (beta/candidate). Instâncias Python com path 3.14 devem ser monitorizadas — podem ter memory leaks.

Cron Job — Criar Tarefas Agendadas de Limpeza

Para criar um cron job que executa limpeza automática do Desktop:

# 1. Criar script em ~/.hermes/scripts/ (OBRIGATORIO path absoluto do hermes)
cat << 'SCRIPT' > ~/.hermes/scripts/organizar_desktop.sh
#!/bin/bash
DESKTOP="$HOME/Desktop"
MESA="$HOME/Documents/Mesa"
mkdir -p "$MESA/Capturas" "$MESA/Documentos" "$MESA/Screen Recordings"
# ... lógica de categorização
SCRIPT
chmod +x ~/.hermes/scripts/organizar_desktop.sh

# 2. Criar via hermes cron (script path SEM ~/ ou /home/, apenas nome do ficheiro)
hermes cron create \
  --name "Organizar Desktop automaticamente" \
  --deliver local \
  --workdir ~/Documents/Mesa \
  --script organizar_desktop.sh \
  -- "0 * * * *" \
  "Execute o script organizar_desktop.sh para organizar o Desktop."

Regras do hermes cron create:

• script deve ser apenas o nome do ficheiro (não path completo) — o script vai para ~/.hermes/scripts/
• schedule é expressão cron (0 * * * * = hourly)
• prompt ou --skill é obrigatório (não é opcional)
• workdir é caminho absoluto

Relatório Gerado

Quando pedir diagnóstico completo, formatar assim:

• Tabela hardware + estado
• Tabela processos que mais consomem RAM
• Tabela LaunchAgents (a manter vs a desativar)
• Tabela de ações com prioridade e impacto
• Expectativa de ganho percentual
• Nota sobre estado da bateria (saúde, ciclos)
• Nota sobre Python 3.14 (se detectado)