💾Backup da memória

Seus arquivos CLAUDE.md e memory.md são a parte mais valiosa da instalação: meses de decisões, preferências e contexto. O backup os envia todos os dias para um repositório privado do GitHub, com histórico completo.

O que é salvo

Somente uma lista de permissão, relativa ao workspace:

sempre: todos os CLAUDE.md e memory.md, além de CUSTOMIZATIONS.md e customizations/*.patch (suas alterações no código do produto, veja Personalização);
por padrão, também: **/NOTES.md, tasks.json, projects/*/topics/*/accounts.md (o inventário de assinaturas, mantido em general/inbox), extensions/**, .claude/skills/** (editável em Configurações -> Backup);
além das configurações não secretas (fuso horário, idioma, modelo padrão, layout do painel...) e das suas tarefas agendadas, em uma pasta _maxxing/.

Nunca são salvos, mesmo que um padrão corresponda: secrets.json, chaves, arquivos .env, chaves privadas, credenciais, logs, attachments/, .git, node_modules, ambientes virtuais e arquivos com mais de 5 MB.

Verificações de segurança

Scanner de segredos: antes de cada commit, cada arquivo é examinado em busca de formatos reais de segredos (chaves da Anthropic e no estilo OpenAI, tokens do GitHub, tokens do Slack, chaves AWS, tokens de bot do Telegram, tokens da Shopify, chaves e segredos de webhook da Stripe, chaves de API do Google, tokens do npm, do Hugging Face e do SendGrid, JSON web tokens, chaves privadas (inclusive PGP), uma senha em um endereço (postgres://user:Pa55word@host) e uma senha escrita ao lado do seu rótulo, como password: Hunter2xyz9 ou "password": "…" - útil no accounts.md; arquivos UTF-16 também são lidos). Se algum for encontrado, o backup para antes de enviar e informa qual arquivo e que tipo de segredo (nunca o valor). Remova-o do arquivo – mantenha apenas o nome da chave, guarde o valor em Configurações -> Chaves – e execute novamente.
Somente privado: o repositório precisa ser privado; isso é verificado quando você o configura e novamente antes de cada envio. Se ele se tornar público, os backups param.
O token do GitHub é guardado em secrets.json (modo 600) e nunca é escrito em um arquivo de configuração do git.

Configuração (Configurações -> Backup)

No GitHub, crie um fine-grained personal access token (token de acesso pessoal de escopo detalhado):
Acesso ao repositório: apenas o repositório de backup (ou todos os repositórios, se você quiser que o Claude Maxxing o crie);
Permissões: Contents: read and write, Metadata: read; adicione Administration: read and write somente se o repositório precisar ser criado para você.
Em Configurações -> Backup, informe owner/name e o token; marque "criar o repositório" se ele ainda não existir.
Clique em Fazer backup agora e confira o commit no GitHub.

Uma tarefa diária Backup da memória é criada (padrão 04:40). Altere o horário e a lista de permissão em Configurações -> Backup.

Restauração

Configurações -> Backup -> Restaurar (ou maxxing backup restore): restaura os arquivos da lista de permissão do último commit (ou de um commit escolhido). Os arquivos que seriam sobrescritos são antes movidos para a lixeira (/var/lib/claude-maxxing/trash/backup-restore-<date>/).
Em um servidor novo (nenhuma sessão iniciada ainda: a restauração do instalador, uma mudança para outro servidor), tudo volta como era, com tarefas e extensões ativadas. Em um servidor já em uso, o código que roda no servidor volta desativado: tarefas agendadas (shell ou Claude) que este servidor não tem exatamente iguais, e extensões em que qualquer arquivo de código seja escrito pela restauração (desativadas antes de seus arquivos serem escritos: o código delas nunca roda, nem por um instante); os hooks do Claude Code e as outras configurações que executam um comando ou redirecionam o Claude (statusLine, apiKeyHelper, env, servidores MCP de projeto...) são removidos dos arquivos .claude/settings.json restaurados (guardados em hooks-held.json na pasta da lixeira da restauração); arquivos que a lista de backup deste servidor não cobre (um .mcp.json, um script...) não são escritos, mas ficam separados na pasta outside da lixeira da restauração; servidores MCP locais (um comando que o Claude Code inicia a cada turno) não são adicionados de volta - eles ficam salvos em mcp-held.json na pasta da lixeira da restauração, adicione novamente os que você considerar confiáveis em Configurações → MCP (servidores remotos, uma URL, são restaurados). Skills e personalizações restauradas são listadas para revisão antes do uso. Uma notificação lista tudo isso; confira, depois ative em Crons e Extensões. Caso contrário, qualquer pessoa com permissão para enviar ao repositório de backup poderia executar seu código aqui. A própria tarefa de backup da memória continua ativada.
Uma versão antiga de um arquivo: navegue pelo histórico dele no GitHub e copie de volta.

Mudando para um novo servidor

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

O instalador restaura sua memória, suas configurações e suas tarefas. Depois, faça login, informe novamente o que nunca entra no backup (token do Claude, token do bot do Telegram, Chaves) e vincule o Telegram de novo – pare o servidor antigo antes, pois um bot só pode ser atendido por um servidor.

Linha de 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