💾Backup della memoria

I tuoi file CLAUDE.md e memory.md sono la parte più preziosa dell'installazione: mesi di decisioni, preferenze e contesto. Il backup li invia ogni giorno a un repository GitHub privato, con la cronologia completa.

Cosa viene salvato

Solo una whitelist, relativa al workspace:

sempre: ogni CLAUDE.md e memory.md, più CUSTOMIZATIONS.md e customizations/*.patch (le tue modifiche al codice del prodotto, vedi Personalizzare);
di default anche: **/NOTES.md, tasks.json, projects/*/topics/*/accounts.md (l'inventario degli abbonamenti, conservato in general/inbox), extensions/**, .claude/skills/** (modificabile in Impostazioni -> Backup);
più le impostazioni non segrete (fuso orario, lingua, modello predefinito, layout della dashboard...) e le tue attività pianificate, in una cartella _maxxing/.

Mai salvati, anche se un pattern corrisponde: secrets.json, chiavi, file .env, chiavi private, credenziali, log, attachments/, .git, node_modules, ambienti virtuali e file oltre i 5 MB.

Controlli di sicurezza

Scanner dei segreti: prima di ogni commit, ogni file viene analizzato alla ricerca di veri formati di segreti (chiavi in stile Anthropic e OpenAI, token GitHub, token Slack, chiavi AWS, token di bot Telegram, token Shopify, chiavi Stripe e segreti dei webhook, chiavi API Google, token npm, Hugging Face e SendGrid, JSON web token, chiavi private (anche PGP), una password in un indirizzo (postgres://user:Pa55word@host) e una password scritta accanto alla sua etichetta come password: Hunter2xyz9 o "password": "…" - utile in accounts.md; vengono letti anche i file UTF-16). Se ne viene trovato uno, il backup si ferma prima di inviare e ti dice quale file e che tipo di segreto (mai il valore). Toglilo dal file – tieni solo il nome della chiave, conserva il valore in Impostazioni -> Chiavi – e riesegui.
Solo privato: il repository deve essere privato; lo verifichiamo quando lo configuri e di nuovo prima di ogni push. Se diventa pubblico, i backup si fermano.
Il token GitHub è conservato in secrets.json (modalità 600) e non viene mai scritto in un file di configurazione di git.

Configurazione (Impostazioni -> Backup)

Su GitHub, crea un fine-grained personal access token:
Accesso ai repository: solo il repository di backup (o tutti i repository se vuoi che Claude Maxxing lo crei);
Permessi: Contents: read and write, Metadata: read; aggiungi Administration: read and write solo se il repository deve essere creato per te.
In Impostazioni -> Backup inserisci owner/name e il token; spunta "crea il repository" se non esiste ancora.
Clicca Esegui backup ora e controlla il commit su GitHub.

Viene creata un'attività giornaliera Backup della memoria (di default alle 04:40). Cambia l'orario e la whitelist in Impostazioni -> Backup.

Ripristino

Impostazioni -> Backup -> Ripristina (oppure maxxing backup restore): ripristina i file in whitelist dell'ultimo commit (o di uno a tua scelta). I file che verrebbero sovrascritti vengono prima spostati nel cestino (/var/lib/claude-maxxing/trash/backup-restore-<date>/).
Su un server nuovo (nessuna sessione ancora avviata: il ripristino dell'installer, un trasloco su un altro server) tutto torna com'era, attività ed estensioni attive. Su un server già in uso, il codice che gira sul server torna disattivato: le attività pianificate (shell o Claude) che questo server non ha già esattamente uguali, e le estensioni di cui il ripristino scrive anche solo uno dei file di codice (disattivate prima che i loro file vengano scritti: il loro codice non gira mai, nemmeno per un istante); gli hooks di Claude Code e le altre impostazioni che eseguono un comando o reindirizzano Claude (statusLine, apiKeyHelper, env, server MCP di progetto...) vengono rimossi dai file .claude/settings.json ripristinati (conservati in hooks-held.json nella cartella del cestino del ripristino); i file che la lista di backup di questo server non copre (un .mcp.json, uno script...) non vengono scritti ma messi da parte nella cartella outside del cestino del ripristino; i server MCP locali (un comando che Claude Code avvia a ogni turno) non vengono riaggiunti - sono salvati in mcp-held.json nella cartella del cestino del ripristino, aggiungi di nuovo quelli di cui ti fidi in Impostazioni → MCP (i server remoti, cioè un URL, vengono ripristinati). Le skill e le personalizzazioni ripristinate sono elencate da controllare prima dell'uso. Una notifica elenca tutto; controllali, poi attivali in Cron ed Estensioni. Altrimenti chiunque possa fare push sul repository di backup potrebbe far eseguire qui il proprio codice. L'attività di backup della memoria resta attiva.
Una vecchia versione di un singolo file: sfoglia la sua cronologia su GitHub e copiala di nuovo al suo posto.

Trasferirsi su un nuovo server

curl -fsSL https://get.harness-maxxing.com | RESTORE_FROM=owner/name RESTORE_TOKEN=<token> bash

L'installer ripristina la tua memoria, le impostazioni e le attività. Poi accedi, reinserisci ciò che non viene mai salvato nel backup (token Claude, token del bot Telegram, Chiavi) e ricollega Telegram – ferma prima il vecchio server, un bot può essere servito da un solo server.

Riga di comando

maxxing backup status [--json]
maxxing backup run
maxxing backup restore [--ref <commit>]
maxxing backup restore --from owner/name      # token from $MAXXING_GITHUB_TOKEN or prompted