Per sviluppatori

File normali e una sincronizzazione di cui ragionare.

Ogni documento è un vero file, nel suo vero formato, in una cartella che scegli tu. Punta Claude Code, Codex, Cursor o i tuoi script su di essa. La demo nella home page ha una scheda con un terminale.

Cosa c’è nella cartella

I file .docx, .md, .txt, .csv, .svg, .epub e .mhtml restano quello che sono.
I PDF vengono scritti con annotazioni, campi dei moduli e modifiche al loro interno, e le immagini con i livelli disegnati dentro.
Le cartelle in Golem Docs sono cartelle sul disco. Sposta o rinomina un file e il documento lo segue, cronologia compresa.
I nomi che iniziano con un punto vengono saltati, quindi .git resta in pace. .golemdocs/ contiene lo stato della sincronizzazione; non modificarla.

Le regole della sincronizzazione

Un file cambiato qui	Vince il file. Se è cambiato anche l’account, la sua copia viene prima conservata come versione.
Un file è stato eliminato	Il documento va nel cestino dell’account per 30 giorni.
Un file è stato spostato o rinominato	Stessi byte, posto nuovo: resta un solo documento, con la sua cronologia.
Dieci o più file spariscono	La sincronizzazione si ferma e chiede. Di solito è un disco non montato.
Con che frequenza	La cartella viene controllata ogni 4 secondi, l’account ogni minuto.

Tenere la cartella allineata con il tuo account, e tramite esso i tuoi altri dispositivi e le persone con cui condividi, fa parte della sincronizzazione, 3 $ al mese. Senza, la cartella e Golem Docs restano comunque allineati su questo computer, e versioni e cestino vengono conservati qui. Sullo stesso computer, una modifica nella cartella compare in Golem Docs entro pochi secondi, e una fatta in Golem Docs arriva alla cartella entro un minuto. Gli altri dispositivi controllano il tuo account circa una volta al minuto.

Un AGENTS.md per la tua cartella

Gli agenti leggono un file di istruzioni in cima alla cartella. Ecco un punto di partenza; cambialo in base a come archivi le cose.

AGENTS.md

# Questa cartella è il mio secondo cervello

È la mia cartella di Golem Docs: ogni file qui è un documento del mio account,
e ciò che cambi qui si sincronizza con tutti i miei dispositivi.

- Cerca nella cartella prima di scrivere su un argomento, e parti dalle note
  che ci sono già.
- Metti ogni nuova nota nella cartella adatta al suo argomento. Elenca prima
  le cartelle. Chiedi prima di creare una nuova cartella di primo livello.
- Usa i [[wikilinks]] verso le note correlate, e aggiungi le nuove note alla
  nota indice della cartella.
- Lascia le mie note con la mia voce. Aggiungi link o una riga alla fine;
  non riscrivere ciò che ho scritto.
- Non toccare mai .golemdocs/.