Cómo reiniciar y optimizar iCloud Drive desde la Terminal en macOS
Si iCloud Drive se queda bloqueado en “subiendo…”, no sincroniza correctamente, los archivos no aparecen o el icono de progreso nunca termina, puedes reiniciar y optimizar el servicio desde la Terminal con comandos seguros. Esta guía te muestra paso a paso cómo hacerlo.
1️⃣ Forzar reinicio de iCloud Drive (brutal pero seguro)
Este comando cierra todos los procesos relacionados con iCloud y obliga a macOS a reiniciar el servicio.
killall bird; killall cloudd; killall CloudKeychainProxy
No borra archivos. Solo reinicia el motor que gestiona iCloud Drive.
2️⃣ Reparar la base de datos de iCloud Drive
Si iCloud Drive está lento, atascado o sincronizando mal, puedes forzar una verificación de la base interna:
brctl log -w
Este comando no arregla por sí solo, pero te muestra exactamente qué falla en el motor “bird”.
3️⃣ Vaciar cachés de iCloud Drive (100% seguro)
Si la sincronización sigue sin funcionar, puedes eliminar únicamente la caché de iCloud (NO tus archivos).
rm -rf ~/Library/Caches/com.apple.bird
macOS regenerará la carpeta automáticamente.
4️⃣ Reiniciar completamente "bird" (el motor de iCloud)
Bird es el proceso encargado de sincronizar todos los archivos de iCloud Drive.
launchctl stop com.apple.bird
launchctl start com.apple.bird
5️⃣ Forzar una sincronización inmediata
Con esto obligas a iCloud a revisar todos los archivos y empezar una sincronización nueva:
brctl diagnose --full-sync
❓ Preguntas frecuentes
¿Puedo perder mis archivos con estos comandos?
No. Nada de esto borra archivos almacenados en iCloud Drive.
¿Tengo que reiniciar el Mac?
No es necesario, pero puede acelerar la recuperación del servicio.
¿Esto funciona en cualquier versión de macOS?
Sí, todos estos comandos funcionan en macOS Monterey, Ventura, Sonoma y posteriores.