Cosa sincronizza
KoNiMa Claude Sync organizza ciò che sincronizza in domini indipendenti. Ogni dominio è opt-in e si attiva in base alla tua edizione: lo stesso VSIX è installato ovunque, è la licenza a decidere cosa è disponibile. Tutto viaggia esclusivamente attraverso il tuo repository git.
I domini in breve
| Dominio | Cosa viaggia |
|---|---|
| Configurazione | Regole, skill, comandi slash, agenti, settings.json e CLAUDE.md — opt-in per singolo dominio. |
| Plugin | L’inventario dei plugin installati: installi una volta, si propaga a ogni macchina. |
| Server MCP | Le definizioni dei server MCP. Le credenziali vengono ripulite prima dell’export e non raggiungono mai il repository. |
| Memorie | Le memorie di Claude e le note di progetto, unite e deduplicate tra le macchine; i progetti sono riconosciuti dal remote git. |
| Hook | Gli hook personalizzati di Claude Code con le loro varianti per sistema operativo; un manifesto li ricollega su qualsiasi macchina. |
Configurazione
Il cuore del prodotto. La configurazione di Claude Code che vive in ~/.claude — regole, skill,
comandi, agenti, CLAUDE.md e settings.json — diventa una baseline coerente su tutte le tue
macchine. Ogni categoria è opt-in: puoi sincronizzare le skill ma non i comandi, o viceversa.
Plugin
L’inventario dei plugin di Claude Code viaggia con te. Installi un plugin una sola volta e alla sincronizzazione successiva ogni altra macchina lo riceve. Allo stesso modo, rimuovere un plugin lo rimuove ovunque: è una decisione che vale per l’intero parco macchine, quindi richiede una conferma esplicita.
Server MCP
Le definizioni dei server MCP si sincronizzano tra le macchine, ma con una cautela fondamentale:
le credenziali non lasciano mai la tua macchina. Prima dell’export, i valori delle chiavi che
corrispondono a token, secret, key, password, auth, bearer e credential vengono
azzerati. Nel repository finisce la struttura del server, non i suoi segreti.
Memorie
Le memorie di Claude e le note di progetto vengono fuse e deduplicate tra le macchine: ogni macchina porta con sé ciò che le altre hanno imparato. I progetti sono identificati dal loro remote git, non dal percorso locale — così lo stesso progetto, clonato in cartelle diverse su macchine diverse, viene comunque riconosciuto e le sue memorie vengono rimappate sulla cartella locale corretta. Il dominio Memorie richiede un’edizione che lo includa.
Hook
Gli hook personalizzati di Claude Code viaggiano con le loro varianti per sistema operativo: un unico manifesto sa quale variante eseguibile usare su Windows, macOS o Linux. Se un hook non ha una variante valida per la macchina corrente, l’app lo segnala invece di eseguirlo a vuoto.
Progettato per essere sicuro
La sincronizzazione segue alcuni principi che evitano la perdita di lavoro:
- Le tue modifiche vincono sempre. Un pull non sovrascrive mai ciecamente il lavoro locale: viene fatta una riconciliazione a tre vie contro una baseline per-macchina, e prima di applicare qualsiasi cosa viene salvato uno snapshot di backup locale.
- Nessun force-push, mai. I conflitti vengono mostrati nella dashboard e non risolti in silenzio.
- Idempotente. Ogni operazione è dichiarativa e ri-eseguibile senza danni.
- Consapevole delle finestre multiple. Una sola finestra di VS Code guida la sincronizzazione; le altre seguono senza collisioni.
- Tollerante all’offline. I push falliti vengono accodati e ritentati; la licenza funziona offline fino a sette giorni dall’ultima validazione riuscita.
Cosa non viaggia mai
I tuoi dati non transitano dai server KoNiMa. L’unico endpoint contattato è l’API di licenza, e solo per la validazione (e, in fase di richiesta prova, un hash anonimo e monodirezionale della macchina per prevenire abusi). Le credenziali del repository e la chiave di licenza restano nel secret store di VS Code, mai scritte su disco.