Manutenzione del repository

Col tempo un repository di sincronizzazione può accumulare cronologia, riferimenti non più usati o stati anomali del clone locale. Le operazioni di manutenzione mettono ordine senza mai rischiare i tuoi dati. Le trovi nella scheda Sistema della dashboard (e nei comandi corrispondenti), ognuna con la propria scheda repository — nell’edizione Team ci sono Core e Memorie.

Il clone locale è solo una cache

Prima di tutto, una garanzia che rende sicure tutte queste operazioni: il clone locale del repository è una cache derivata. La fonte di verità è la cartella ~/.claude, dove vive la tua configurazione di Claude Code. Per questo azzerare e ri-clonare il repository non perde nulla: ricostruisce semplicemente la cache da capo.

Le operazioni

Ogni operazione chiede sempre conferma in-app prima di eseguire.

Reset / Reinizializza

Azzera il clone locale e lo ri-clona da zero. È l’operazione più sicura e spesso risolve molti stati anomali: poiché il clone è una cache derivata, ricostruirlo non comporta perdita di dati.

Compatta cronologia

Riduce la dimensione del repository comprimendo la storia in un singolo commit. La cronologia precedente non sparisce: resta raggiungibile tramite un recovery ref conservato apposta.

Pulisci

Rimuove dal repository le “zone non gestite”: contenuti che non sono più sincronizzati e che quindi non servono più nel repository.

Cambia repo

Migra la cronologia verso un nuovo URL. Utile quando il repository viene spostato o rinominato, o quando vuoi adottare un host git diverso.

Sempre con conferma, mai force-push

Tutte le operazioni di manutenzione rispettano due principi del prodotto:

• Idempotenti — puoi rieseguirle senza danni: ripetere un’operazione lascia il sistema nello stesso stato finale, non lo peggiora.
• Senza force-push — la cronologia remota non viene mai riscritta in modo distruttivo. Nessuna macchina può sovrascrivere il lavoro di un’altra: gli eventuali conflitti vengono segnalati nella dashboard per una decisione umana, mai risolti di nascosto.

Quando usarle

Situazione	Operazione
Lo stato di sincronizzazione resta anomalo e non si risolve da sé	Reset / Reinizializza
Il repository è cresciuto molto e vuoi alleggerirlo	Compatta cronologia
Restano contenuti non più sincronizzati che vuoi togliere dal repository	Pulisci
Hai spostato o rinominato il repository, o cambi host git	Cambia repo

Consiglio

Se un’azione resta “in attesa” con uno spinner, lasciala completare: ogni pulsante di manutenzione si disabilita finché l’operazione non risponde. Non ripetere il click.

Vedi anche

• Privacy e sicurezza — perché idempotenza e assenza di force-push proteggono i tuoi dati.
• Edizione Team — manutenzione su due repository, CORE e MEMORIES.
• Risoluzione dei problemi — diagnostica e stati anomali.