Home › Guida

Guida & funzioni

Documentazione completa di tutto ciò che fa LightNote — la stessa guida che si apre nell'app con il tasto F1. Usa l'indice qui sotto per andare a qualsiasi funzione.

✍️ Editor di codice 🧠 Note & secondo cervello 🤖 Vibe coding (IA + MCP)

Guida di LightNote

Editor leggero di codice e note per Windows. La barra laterale elenca le sezioni e segue ciò che stai leggendo; i pulsanti Home e Indietro in alto nella finestra riportano all'inizio, e il campo Cerca cerca nel testo di questa guida (Invio avanza; F3 / Maiusc+F3 navigano). Premi F1 in qualsiasi momento per aprire questa guida direttamente alla sezione della schermata attuale.

Indice

Modifica

Strumenti

Automazione (IA / script)

Riferimento

Panoramica

LightNote apre una cartella come Spazio di lavoro e mostra l'albero dei file a sinistra, le schede di modifica a destra e la barra di stato in basso. La piccola striscia in cima alla barra laterale passa tra le sezioni Esplora risorse (albero), Ricerca, Versionamento (Git), Cronologia file e Elementi in sospeso (TODO/FIXME e attività dalle note).

Oltre a codice e note, apre e modifica molti formati nel posto giusto: tabelle (Parquet/CSV/JSON tramite DuckDB ed Excel .xlsx), PDF, immagini (incluse GIF animate), .zip come cartella, notebook Blocchi (.lnb), bacheche Attività (.lnt), tabelle personalizzate (.lnd), connessioni a database (.lnc) e connessioni SSH (.lns). C'è un terminale integrato, una ricerca globale (ripgrep), un versionamento Git semplificato, l'integrazione con le CLI di IA, un server MCP e una riga di comando (lnote) per l'automazione.

Sei nuovo qui? Il materiale introduttivo (lo spazio di lavoro di benvenuto) resta disponibile in qualsiasi momento in Aiuto → Riapri il tour di benvenuto.

Spazio di lavoro e finestre

La cartella radice aperta è il tuo Spazio di lavoro. Aprirla non crea nulla; quando la chiudi, LightNote scrive solo un piccolo file di sessione (schede aperte e posizione). Lo spazio di lavoro diventa un "progetto" — con una configurazione persistente propria — solo quando abiliti il Versionamento (Git) o l'MCP in Strumenti → Impostazioni dello spazio di lavoro.

Le Impostazioni generali si applicano a tutta l'applicazione; le Impostazioni dello spazio di lavoro si applicano solo alla cartella aperta. Configurazione e stato risiedono in un database centrale, non sparsi nella cartella.

LightNote gira come istanza singola: aprire una seconda cartella riutilizza il processo (multi-finestra, meno memoria). C'è un'icona nel tray e un launcher con un campo di ricerca che elenca gli Spazi di lavoro (fissa i tuoi preferiti in cima tramite il menu contestuale) — vedi Note giornaliere e tray. Ogni scheda può ricevere un'etichetta di colore tramite il menu contestuale della barra delle schede. Per note ripetitive, crea una cartella Modelos (o Templates) con file .md e usa File → Nuova nota da modello…

Creare un file scegliendo il tipo. Il menu Nuovo (☰ File, il pulsante Nuovo della barra delle attività o Crea nuovo nel menu contestuale di una cartella) offre Nuova nota (.md), Nuovo file di testo (.txt) e il sottomenu Nuovo file di codice con i linguaggi più usati. In tutti i casi il file nasce subito su disco con un nome predefinito e l'albero apre la modifica del nome: è preselezionato solo il nome, quindi digitare un titolo non cancella l'estensione. Per accettare il nome suggerito basta fare clic nell'editor e iniziare a scrivere. Per un'estensione fuori dal sottomenu, crea un file e rinominalo (F2): cambiare l'estensione cambia la vista — rinominare .txt in .md riapre la stessa scheda come nota, con anteprima e sommario, e viceversa torna l'editor di codice. Le estensioni proprie di LightNote (.lnc, .lne, .lnq, .lnh, .lns e i bundle) fanno eccezione: lì l'estensione dichiara il formato del contenuto, perciò rinominare chiede conferma ed è rifiutato finché la scheda è aperta.

Dove viene creato il nuovo file. Nuovo crea sempre nella cartella contrassegnata dell'Esploratore, e ce n'è sempre esattamente una contrassegnata. In cima all'albero c'è la riga della cartella radice, con il nome dello spazio di lavoro: è un elemento come gli altri — fai clic su di essa per riportare la destinazione alla radice. Selezionare una cartella vi sposta il contrassegno; selezionare un file contrassegna la cartella che lo contiene. Nella modalità Elenco, che non mostra cartelle, il contrassegno resta sulla riga radice ed è quella riga a mostrare la destinazione effettiva. Il menu contestuale della riga radice offre Crea nuovo e Crea cartella.

Per aprire un file sciolto senza trasformarlo in uno spazio di lavoro, usa Apri file sciolto… (menu del tray): la finestra autonoma mostra l'albero dei file, ma senza Git, MCP o override del tema. Se abilitato in Impostazioni → Generale → Funzionalità, LightNote si integra nel menu di Esplora file di Windows (per utente, senza bisogno di amministratore): oltre all'elenco "Apri con", il menu contestuale guadagna "Apri con LightNote" su qualsiasi file e "Apri come spazio di lavoro LightNote" sulle cartelle (su Windows 11, in Mostra altre opzioni). I file si aprono in quella finestra autonoma; le cartelle come spazio di lavoro.

Selezionando più file insieme in Esplora file di Windows — anche da cartelle diverse — si aprono tutti nella stessa finestra autonoma, scheda accanto a scheda (invece di una finestra per file). Le schede di quella finestra vengono ricordate: chiudendola e riaprendola, gli stessi file tornano. Poiché qui contano le schede, l'albero dei file parte richiuso: usa Ctrl+B (o il pulsante in cima alla barra delle attività) per mostrarlo.

Tornare a una sessione. La finestra dei file singoli si chiama File singoli ovunque — compresa la barra del titolo, dove le altre finestre mostrano il nome dello spazio di lavoro, così le distingui in Alt+Tab. Nel menu dell'area di notifica, in Apri, la voce riceve il suffisso (N schede) quando ci sono schede salvate — un clic le riporta tutte. È anche la prima riga del launcher, accanto agli spazi di lavoro. E riaprendo LightNote torna tutto ciò che era aperto quando sei uscito: ogni finestra nella sua cartella, più la finestra singola. Se preferisci aprire solo l'ultima cartella usata, cambialo in Impostazioni → Generale → Interfaccia → All'avvio, apri. Una finestra chiusa prima di uscire resta fuori: chiuderla è il modo di dire "ho finito con questo spazio".

Preferiti: la barra laterale ha una sezione Preferiti con ciò che hai aggiunto (menu contestuale dell'albero o di una scheda → Aggiungi ai preferiti) e i file aperti di recente. Gli elementi aggiunti sono per cartella e salvati come percorsi relativi, quindi sopravvivono allo spostamento dello spazio di lavoro.

Aprire una scheda in una finestra propria: nel menu contestuale della scheda, Apri in una nuova finestra riapre quel file in una finestra autonoma (comodo per tenere una nota accanto al codice). I tipi che dipendono dallo spazio di lavoro (.lnc, .lne, .lns e i bundle) non possono essere staccati.

Selezione multipla. L'albero accetta Ctrl+clic (singolo) e Maiusc+clic (intervallo) in tutte e tre le modalità di vista. Con più elementi selezionati, il menu contestuale agisce su tutta la selezione: Taglia e Copia (in interoperabilità con l'Esplora file di Windows), Elimina (una sola conferma per tutti), Duplica, Copia hash, Comprimi in .zip (un solo archivio, ogni elemento con il proprio nome in cima), Applica colore, Preferiti, Git (add/restore) e Copia percorsi (una riga per elemento). Le azioni che hanno senso solo per un elemento — rinomina in linea, Proprietà, Apri come, Converti — restano disabilitate, con il motivo nel suggerimento. Il clic destro dentro la selezione la mantiene; fuori seleziona solo l'elemento cliccato. Selezionare una cartella e qualcosa al suo interno non esegue l'operazione due volte: l'elemento interno viene scartato.

Sbirciare senza aprire. Un clic singolo su un file apre già una scheda di anteprima (riutilizzata, in corsivo nella barra delle schede). Scorrendo l'albero con le frecce, il tasto Spazio fa lo stesso e restituisce il fuoco all'albero, per continuare a scendere nell'elenco.

Strumenti file. Il menu contestuale dell'Esplora file ha il sottomenu Strumenti file: Rinomina in blocco (filtro per estensione/jolly/regex + una pipeline di regole con anteprima e rilevamento delle collisioni), Dividi file (per righe, dimensione o separatore regex), Unisci file (mantenendo solo la 1ª intestazione CSV, opzionale), Duplica, Copia hash (MD5/SHA-256) e Comprimi in .zip / Estrai qui. Con più elementi selezionati, Rinomina in blocco e Unisci file ricevono esattamente gli elementi scelti (invece di scandire la cartella) — e Unisci rispetta l'ordine della selezione.

Navigazione della finestra singola. Sopra l'albero ci sono indietro (Alt+←), avanti (Alt+→) e su, più un percorso di cartelle cliccabile — ogni segmento porta a quel livello. Anche i pulsanti laterali del mouse tornano indietro e avanti. Per digitare un percorso, fai clic nello spazio vuoto della striscia oppure usa Ctrl+L; Esc annulla e ripristina il percorso. Cambiare scheda sposta anche la cartella mostrata: poiché la finestra autonoma raccoglie schede di cartelle diverse, fare clic su una scheda porta alla sua cartella.

Menu. Il pulsante ☰ (in cima alla barra delle attività) raccoglie i menu File, Modifica, Visualizza, Finestra, Strumenti, IA e Aiuto. Le azioni di IA hanno un menu proprio (anche sul pulsante bacchetta della barra delle attività). In Strumenti i gruppi stanno in sottomenu: Esegui (F5/F6/F8, lint, invia al terminale, macro), Cattura (nota di oggi, cattura rapida, attività rapida, registra audio, note adesive) e Spazio di lavoro (configurazione, snapshot, esporta copia, sposta cartella) — quest'ultimo anche nel menu dell'ingranaggio. Il menu Nuovo è identico nei tre punti in cui compare: ☰ File, il pulsante Nuovo e Crea nuovo nel menu contestuale di una cartella.

Editor di codice

I file di testo/codice si aprono nell'editor (Scintilla) con evidenziazione della sintassi. Sono disponibili commento/decommento (Ctrl+/), sposta e duplica riga, segnalibri (Ctrl+F2), un elenco di simboli/funzioni, autocompletamento basato sulle parole, guide di indentazione, a capo automatico, zoom e rilevamento delle modifiche al file su disco. Con il versionamento abilitato, il margine segna le righe aggiunte/modificate dall'ultima versione.

Ci sono anche le macro (registra/riproduci una sequenza di modifiche con Ctrl+Shift+R / F4, in Strumenti → Macro), formatta/abbellisci (Shift+Alt+F), una tabella ASCII sulla barra degli strumenti della scheda (per inserire caratteri/box-drawing) e un correttore ortografico (Hunspell). pt-BR e en-US sono inclusi; gli altri idiomi si scaricano su richiesta dalla tabella in Impostazioni → Note e scrittura → Ortografia (una riga per idioma, con un pulsante Scarica/Rimuovi). Per seguire un file di log mentre viene scritto, usa il pulsante Monitora (tail -f) nella barra degli strumenti della scheda stessa. I file molto grandi (oltre ~1 MB) si aprono in un editor leggero virtualizzato che carica solo i blocchi visibili; puoi forzarlo tramite File → Apri nell'editor leggero…

Formattazione e lint: Shift+Alt+F formatta il documento con il formattatore esterno del linguaggio (black, prettier, clang-format, gofmt, rustfmt…) se installato, altrimenti ricade sul formattatore interno (JSON/XML) offline; F7 esegue il linter del linguaggio (ruff, eslint, shellcheck, luacheck…) e segna i problemi con una sottolineatura nell'editor e nel pannello Problemi (pannello inferiore, navigabile). Entrambi hanno un catalogo con Aggiungi in Impostazioni → Formattazione e → Linter, oltre alle opzioni formatta al salvataggio / lint al salvataggio. Esegui il file nel pannello di output con F6 (cattura codice di uscita e durata, con stop/riavvio) o solo un frammento con F8.

Altre funzionalità di modifica: multi-cursore per occorrenza (Ctrl+D, tutte con Alt+F3), duplica riga (Ctrl+Shift+D), unisci righe (Ctrl+Shift+J), espandi/riduci la selezione per ambito (Ctrl+Shift+Space / Ctrl+Alt+Space), selezione rettangolare (Alt+trascina), piega/espandi tutto, frammenti (snippet) (Ctrl+J, modificabili in Impostazioni → Editor), Vai al simbolo nel file (# nella tavolozza) e nel progetto (Ctrl+T o ##), cronologia di navigazione (Alt+←/→), una traccia breadcrumb in cima all'editor, righelli di colonna, colorazione delle coppie di parentesi, chiusura/avvolgimento automatico delle coppie e pulizia al salvataggio (rimuovi spazi, riga vuota finale) — tutto in Impostazioni → Editor.

Cronologia locale e appunti: a ogni salvataggio, LightNote conserva una versione del file (File → Cronologia locale…, ripristinabile), indipendente da Git. Ctrl+Alt+V apre la cronologia degli appunti per incollare un elemento copiato in precedenza. Ctrl+Shift+T riapre l'ultima scheda chiusa; le schede possono essere fissate (menu contestuale), il che le protegge dall'essere rilasciate quando inattive.

Vai alla definizione: F12 o Ctrl+clic su un identificatore salta a dove è definito nel progetto; Shift+F12 trova i suoi utilizzi.

Minimappa. Un’anteprima dell’intero documento si trova sul bordo destro dell’editor: mostra la “forma” del codice (i colori dell’evidenziazione della sintassi in scala ridotta) e segna la regione visibile. Fare clic o trascinare per spostarsi in qualsiasi punto del file. Attivala in Visualizza → Minimappa o in Impostazioni → Editor. Il pulsante Minimappa nella barra della scheda di codice (accanto ad ASCII) la attiva e disattiva senza uscire dall’editor. Sul bordo sinistro dell’anteprima corre una striscia di segni: in blu le righe con segnalibro (lo stesso pallino del margine) e in ambra le occorrenze della ricerca rapida — così vedi a colpo d’occhio come si distribuiscono nell’intero file, anche fuori dallo schermo.

Operazioni sul testo. Nel menu Modifica — e nel menu contestuale dell'editor — ci sono i sottomenu Righe (sposta, duplica, elimina, ordina, unisci, inverti, numera) e Pulizia (rimuovi spazi, righe vuote/duplicate, tabulazioni ↔ spazi). Con una selezione, il menu contestuale offre anche Salva la selezione come nuovo file…: scrive il frammento in un file accanto a quello corrente e lo apre in una scheda (l'originale non viene modificato).

Markdown e wikilink

Le note .md si aprono con editor e anteprima affiancati (configurabile). Il markup viene attenuato fuori dal paragrafo del cursore così la pagina sembra un documento finito.

Scorciatoie: Ctrl+B/Ctrl+I applicano grassetto/corsivo e Ctrl+E alterna la modalità di visualizzazione (editor → diviso → lettura).

Wikilink: digita [[ per l'autocompletamento con le note dello spazio di lavoro; il link si chiude da solo con ]]. Tieni premuto Ctrl e clicca su un [[nota]] per aprire la nota corrispondente. Il pannello Collegamenti mostra le connessioni tra le note.

Anteprima ricca: i blocchi di codice recintati appaiono in un riquadro con l'etichetta del linguaggio e un link per copiare; ~~barrato~~ e ==evidenziato== vengono renderizzati; e i callout in stile GitHub (> [!NOTE], [!TIP], [!WARNING], [!IMPORTANT], [!CAUTION]) diventano riquadri colorati. I tag #hashtag sono evidenziati e, con Ctrl+clic, aprono una ricerca per quel tag; il blocco frontmatter YAML in cima (---) è evidenziato. Sulla barra degli strumenti della scheda c'è un pulsante per esportare la nota come PDF/HTML, una colonna di lettura centrata attivabile e le modalità editor/entrambi/anteprima. La modalità Zen (F11) e lo scorrimento a macchina da scrivere aiutano a scrivere senza distrazioni.

Novità nell'anteprima: oltre a ~~barrato~~ e ==evidenziato==, funzionano apice ^x^, pedice ~x~, emoji abbreviate (:rocket:), autolink degli URL, note a piè di pagina [^1], blocchi comprimibili <details>, elenchi di definizioni, attività - [ ]/- [x] (⬜/✅) e il token [TOC] (sommario cliccabile nell'anteprima); inoltre immagini locali e HTML inline (<kbd>, <mark>…). Il pannello Struttura (barra della scheda) percorre i titoli seguendo il cursore, e il pulsante Inserisci (o il menu contestuale → Formato/Inserisci) applica qualsiasi formattazione.

Intestazioni fisse (sticky scroll): mentre scorri, le intestazioni che contengono la riga in alto restano fissate in una fascia in cima all'editor; farci clic salta a quella sezione (attivabile in Impostazioni → Markdown). Il menu contestuale di una cartella nell'albero crea/apre la Nota della cartella (index.md con frontmatter), utile come indice.

Nota della cartella ed elenco file: fare doppio clic su una cartella apre il suo index.md, se esiste. In qualsiasi nota, il token [files] (o [arquivos]) da solo su una riga viene sostituito nell'anteprima con l'elenco dei file della cartella della nota, come link cliccabili — generato al volo, senza scrivere nulla nel file (come [TOC]).

Operazioni di testo e di riga. Le operazioni dell'editor di codice valgono anche nella nota — tramite il pulsante Testo della barra della scheda, il menu contestuale e i sottomenu Righe e Pulizia del menu Modifica: sposta la riga (o le righe selezionate) su/giù (Ctrl+Shift+↑/↓), duplica (Ctrl+Shift+D), elimina (Ctrl+Shift+L), ordina (A→Z / Z→A), inverti l'ordine, unisci righe, rimuovi righe duplicate o vuote, rimuovi spazi e maiuscole/minuscole (e inverti). Numera righe… apre una finestra con inizio, passo, zeri iniziali e separatore — con il valore predefinito (". ") si ottiene un elenco numerato Markdown valido. Con una selezione l'operazione agisce solo su di essa (estesa a righe intere); senza selezione, sull'intero documento — sempre un unico passo di annullamento. La barra della scheda offre anche il pulsante IA (Chiedi / Modifica con l'IA), gli stessi Ctrl+K / Ctrl+I del codice.

Intestazioni comprimibili: fai clic sulla freccetta a sinistra di un'intestazione (o usa Ctrl+Shift+[ / Ctrl+Shift+]) per comprimere ed espandere la sezione; in Visualizza ci sono Comprimi/Espandi tutte le intestazioni. La compressione è solo visiva — non viene mai scritta nel file — e LightNote la ricorda tra le sessioni. Saltare dal Sommario o dalla ricerca dentro una sezione compressa la espande.

Proprietà della nota: il pannello laterale Proprietà mostra il frontmatter YAML come campi tipizzati (testo, numero, data, casella), con la casella Tipo in alto. Impostare il tipo e le proprietà è ciò che permette di raccogliere le note in una Base.

Grafo delle connessioni

Strumenti › Grafo delle connessioni (Ctrl+Alt+G) mostra ogni nota dello spazio di lavoro come un grafo interattivo: ogni nodo è una nota .md, ogni linea un wikilink. I nodi si dispongono da soli (fisica animata) e possono essere trascinati; passandoci sopra vengono evidenziati i vicini e sfumato il resto; il clic apre la nota. Scorri per lo zoom (i nomi appaiono avvicinandosi) e trascina lo sfondo per spostarti.

Sulla barra degli strumenti della scheda: filtro per nome (sfuma le note non corrispondenti), un interruttore per le note orfane (senza alcun collegamento — mostrate in grigio), cursori delle forze (repulsione, distanza e gravità), adatta il grafo alla finestra e riesegui la scansione delle note. Più connessioni ha una nota, più grande è il suo nodo; ogni cartella di primo livello ha il proprio colore.

Tabelle (Parquet, CSV, JSON, Excel)

I file .parquet si aprono come tabella; .csv, .tsv e .json si aprono come testo, e il menu contestuale dell'albero offre Apri come tabella. La lettura è paginata (su richiesta) tramite DuckDB, con ordinamento (clic sull'intestazione) e filtro delegati al motore. Il pulsante Struttura mostra colonne, tipi, numero di righe e, per Parquet, i row-group e la compressione. La vista è di sola lettura.

La barra SQL libero in cima alla tabella accetta qualsiasi query DuckDB — la vista t rappresenta il file aperto. Dal menu contestuale di una cartella nell'albero, Apri cartella come tabella legge tutti i file dello stesso formato come un'unica tabella; dal menu della tabella puoi esportare la vista corrente (CSV/Parquet/JSON), e dal menu dell'albero convertire un file tabellare in un altro formato. L'SQL libero è disponibile anche nel comando query della riga di comando e nell'MCP.

I fogli di calcolo Excel (.xlsx) si aprono come tabella di sola lettura con un selettore di foglio — un lettore leggero, senza bisogno di Excel installato.

Copia come. Nel menu contestuale di qualsiasi tabella di LightNote (Parquet/CSV/JSON, Excel, risultati SQL, Attività, Basi), la voce Copia come mette la selezione negli appunti già formattata. Tabella formattata (Teams, Outlook…) si incolla come una tabella vera, con bordi e intestazione, nei programmi che capiscono il testo formattato — Teams, Outlook, Word, Excel (dove non c'è testo formattato, ripiega automaticamente su TSV). Gli altri si incollano come testo: tabella Markdown (pronta per una nota), CSV (virgolette secondo la RFC 4180), TSV (separato da tabulazioni), HTML (il markup <table>), JSON, JSONL (un record per riga), YAML e il sottomenu Codice, che genera un letterale pronto da incollare in un file sorgente: Python (lista di dizionari) o JavaScript / TypeScript (array di oggetti). In JSON, YAML e codice le celle che sono numeri escono senza virgolette — ma il testo originale è preservato, quindi ID come 007 restano testo. Ctrl+C continua a copiare in TSV, come prima.

Tutte le tabelle si comportano allo stesso modo: Ctrl+F mette a fuoco il filtro rapido ("contiene in qualsiasi colonna"), un contatore mostra quante righe restano e c'è Esporta in CSV — anche nei fogli .xlsx, nelle Attività e nelle Basi. Il menu contestuale della griglia offre ancora Copia come.

Grafico del risultato. La barra laterale della tabella ha un pulsante Grafico (barre, linea o dispersione): l'aggregazione viene eseguita in DuckDB (nessuna riga grezza viene caricata) e un pulsante Aggiungi alla nota del giorno salva il grafico come immagine. Il pannello Struttura include inoltre un profilo per colonna — un mini-istogramma delle colonne numeriche e i valori più comuni delle altre.

PDF e immagini

I file .pdf si aprono in un visualizzatore nativo (Qt6::Pdf, senza dipendenze pesanti), reso dalla CPU e senza WebEngine. Le immagini si aprono nella vista immagine; le GIF animate vengono riprodotte nella vista animata.

La barra della scheda offre cinque pannelli laterali, uno alla volta: Sommario (l'indice salvato nel file stesso — quando il PDF non ce l'ha, il pulsante resta disattivato e lo spiega), Miniature (le pagine a colpo d'occhio, renderizzate mentre scorri), Cerca, Link e Proprietà (titolo, autore, date, dimensione della pagina e del file).

Cerca (Ctrl+F) percorre l'intero documento: le corrispondenze vengono evidenziate sulle pagine ed elencate con il testo circostante, e F3 / Maiusc+F3 passano dall'una all'altra. La scansione è progressiva, quindi l'elenco cresce mentre il documento viene percorso.

Il campo pagina accetta il numero o l'etichetta stampata: in un documento con le pagine iniziali numerate in romano, digitare 1 porta alla pagina stampata "1", non al primo foglio. Il pulsante modalità pagina alterna tra scorrimento continuo e una pagina alla volta.

Un PDF protetto da password chiede la password all'apertura (fino a tre tentativi); annullare lascia semplicemente la scheda chiusa. Nella stessa esecuzione di LightNote la password non viene richiesta di nuovo: l'applicazione riapre la scheda da sola quando la rilascia per inattività, e sarebbe lei stessa a creare il fastidio. Spuntando "Ricorda la password di questo file" nella richiesta, vale anche per le esecuzioni successive: è protetta da Windows (solo per te, solo su questa macchina), non va mai su Git né sul cloud e non viene inclusa nell'esportazione delle impostazioni. Per cancellarle tutte: Impostazioni → Funzionalità → Password PDF. Un PDF protetto non viene riaperto all'avvio: invece di accodare richieste di password prima di mostrare la finestra, aspetta che sia tu ad aprirlo.

Dal menu delle azioni della barra: copiare il testo della pagina, esportare il testo dell'intero documento, copiare o salvare la pagina come immagine e inviare la pagina alla nota del giorno. Il pannello Link esiste perché il componente PDF di Qt segue da solo i link interni ma ignora quelli esterni: è lì che si apre un indirizzo web, con conferma.

Limite: non c'è selezione del testo con il mouse, perché il componente PDF di Qt non la offre. Per portare via il contenuto, usa "copia il testo di questa pagina" o l'esportazione del documento.

Immagini: annotare uno screenshot

Un'immagine si apre in una scheda con barra propria: oltre a ruotare, specchiare e ingrandire, porta con sé gli strumenti di annotazione — la strada che va dallo screenshot all'indicare ciò che conta, fino alla documentazione.

Lo strumento iniziale è Sposta: trascinare continua a spostare l'immagine, come è sempre stato. Seleziona sceglie una parte — trascina per crearla, trascina dall'interno per spostarla e usa le maniglie degli angoli e dei bordi per ridimensionarla; Esc deseleziona e Canc cancella il contenuto della regione. Nella modalità Sposta, Maiusc+trascina seleziona anch'esso. In qualunque strumento, il tasto centrale del mouse sposta l'immagine.

Il Contagocce preleva un colore dall'immagine stessa: il tasto sinistro lo porta al colore del bordo, il destro a quello di riempimento. Legge dall'immagine già annotata, quindi serve anche a ripetere il colore di un'annotazione appena fatta.

Gli altri disegnano: Rettangolo, Ellisse, Freccia, Linea, Evidenziazione (traslucida, come un evidenziatore), Penna (tratto libero), Pennello, Passo numerato (che si numera da solo — 1, 2, 3...), Testo, Sfoca e Riflettore (scurisce tutto tranne la regione scelta). Mentre si disegna, Maiusc blocca quadrati/cerchi e angoli di 45°.

I colori sono due, in due pulsanti: quello del bordo (che è anche quello del tratto e dell'etichetta) e quello di riempimento, che può essere nessuno. Senza riempimento, rettangolo ed ellisse restano di solo contorno, e il passo numerato e il testo usano il colore del bordo come sfondo, con l'etichetta in bianco o in nero — quello che contrasta. Scegliendo un riempimento, esso diventa l'interno della forma e lo sfondo dell'etichetta, e il bordo diventa il colore del testo.

Il Pennello dipinge con il riempimento, con un tocco delle dimensioni dello spessore — tondo o quadrato, dal pulsante accanto allo spessore. Un solo clic lascia già il segno. Con il riempimento bianco è la gomma: copre ciò che sta sotto.

Lo spessore vale per il tratto, per la dimensione dell'etichetta e per la dimensione del blocco della sfocatura; è attenuato negli strumenti che lo ignorano. Colore e spessore vengono ricordati fra una sessione e l'altra. Ctrl+Z e Ctrl+Y annullano e ripetono le annotazioni, e Cancella annotazioni le elimina tutte in una volta (anch'esso annullabile).

Sfocare serve a nascondere (un token, un indirizzo e-mail, un percorso). Finché la scheda è aperta l'annotazione è reversibile, ma al salvataggio o alla copia i pixel di quella regione vengono davvero distrutti: il file che esce non conserva l'originale da nessuna parte.

Tre operazioni hanno nomi simili e fanno cose diverse. Taglia (Ctrl+X) copia la selezione negli appunti e cancella la regione, dipingendola con il colore di riempimento (bianco quando non c'è) — e la selezione resta lì, così che Incolla subito dopo riporti il pezzo esattamente dov'era, fluttuante: è così che si sposta un pezzo dell'immagine. Canc è il taglia senza copiare. Invece Mantieni solo la selezione, nel menu Immagine, fa l'opposto: tiene la regione e butta via il resto, cambiando la dimensione dell'immagine.

Il resto della famiglia: Copia porta via l'immagine annotata o solo la selezione; Incolla porta l'immagine dagli appunti come un incollaggio fluttuante — spostalo e ridimensionalo con le stesse maniglie e fai clic fuori (o premi Invio) per fissarlo, Esc lo scarta; e Ctrl+A (o Ctrl+T) seleziona tutta l'immagine. Ci sono poi Salva (scrive le annotazioni nel file stesso), Salva come... e Invia alla nota del giorno, che salva il PNG in Anexos/ e inserisce il ![]() nella nota. Finché ci sono annotazioni non salvate la scheda mantiene l'asterisco, e chiuderla chiede se vuoi salvare.

Il pulsante Immagine raccoglie tutto ciò che agisce sull'immagine intera: ruota, specchia, ridimensiona in percentuale, riduci a 1600 / 1200 / 800 px di larghezza (uno screenshot nasce troppo grande per la documentazione), rifila i bordi di colore uniforme, aggiungi margine, ombra esterna e fissa le annotazioni nell'immagine — quest'ultimo trasforma subito le annotazioni in pixel, ed è ciò che permette di sfocare sopra un'annotazione. Il ridimensionamento porta con sé le annotazioni e lo spessore del tratto.

Per catturare lo schermo senza uscire da LightNote: Cattura schermo... nel menu dell'area di notifica (o Ctrl+Alt+P) congela il desktop, si trascina per scegliere l'area (Esc annulla) e il ritaglio si apre in una scheda nuova, già pronto per essere annotato.

Limitazioni: un'annotazione già disegnata non si sposta né si modifica — annullala con Ctrl+Z e rifalla; i GIF e i WebP animati si aprono nella vista di animazione, che non ha annotazione; e un .svg viene rasterizzato in lettura, quindi il salvataggio chiede una destinazione PNG.

Zip come cartella (.zip)

Un file .zip si apre nella propria scheda: l'albero dei membri a sinistra (nome, dimensione, data) e il contenuto del membro selezionato a destra — testo/codice, Markdown (con anteprima), immagine o PDF — aperto in memoria, senza estrarre nulla su disco. Testo e Markdown possono essere modificati: Ctrl+S riscrive il membro all'interno dello stesso .zip.

La stessa scheda apre .7z, .rar, .tar (inclusi .tar.gz, .tar.bz2 e .tar.xz), .cab e .iso — questi in sola lettura: si può navigare, visualizzare ed estrarre membri, ma non modificare. Solo lo .zip è scrivibile, perché è l'unico formato che sappiamo riscrivere in sicurezza (il .rar è proprietario e nemmeno le librerie libere lo comprimono).

Immagini e PDF sono di sola lettura; i membri molto grandi (e .parquet) offrono solo Estrai in…. Creare, rinominare o eliminare membri non è supportato.

I membri protetti da password si leggono normalmente: aprendone uno, LightNote chiede la password (fino a tre tentativi) e, spuntando "Ricorda la password di questo file", non chiede più — nella stessa esecuzione per impostazione predefinita e anche in quelle successive se la casella è spuntata (protetta da Windows, solo per te su questa macchina; cancellale tutte in Impostazioni → Funzionalità). Nota una differenza del formato rispetto al PDF: nello .zip la cifratura è per membro e l'indice resta in chiaro, quindi l'elenco dei file si vede per intero anche senza password: è protetto solo il contenuto. Uno .zip con membri cifrati non viene riaperto all'avvio.

Blocchi (.lnb)

Un bundle di Blocchi è una cartella il cui nome termina in .lnb, trattata come un singolo elemento nell'albero (doppio clic per aprirla). Ogni blocco è un file reale su disco; l'ordine risiede in un blocks.json nella radice del bundle. Funziona come un notebook: celle impilate di codice o testo.

Ogni cella ha un nome, un pulsante di tipo (imposta l'interprete/lexer) e pulsanti per copiare, inserire, eliminare ed eseguire. Esegui fino a qui esegue in sequenza tutte le celle di codice fino a quella corrente; l'output (stdout+stderr) appare in un pannello subito sotto la cella. Creane uno dall'albero (Nuovo) o tramite File → Nuovo.

Ctrl+Enter esegue la cella con il focus — lo stesso gesto dell'editor SQL.

Il risultato viene salvato (come in un quaderno di laboratorio): al termine, ogni esecuzione diventa un file .md dentro saida/<cella>/, nel bundle stesso — con l'istante, il codice di uscita, la durata, il comando e l'output stesso. Essendo Markdown, si legge in qualsiasi editor, si versiona in Git insieme al notebook e viene ritrovato da Chat IA. Riaprendo il bundle torna la striscia Ultima esecuzione sopra il pannello: cliccala per vedere il risultato senza rieseguire.

Cronologia: il pulsante Cronologia accanto a quella striscia elenca le esecuzioni precedenti di quella cella (istante e codice di uscita) — utile per confrontare ciò che la stessa cella ha restituito nel tempo. Conserviamo le 10 più recenti per cella; per cambiarlo, modifica la chiave historyLimit nel blocks.json del bundle (0 disattiva il salvataggio). L'output molto grande viene tagliato (il file indica truncated: true). Rinominare la cella o cambiarne il tipo porta con sé la cronologia; eliminare la cella manda la sua cronologia nel Cestino.

Cella SQL su un database vero: punta il notebook a una connessione .lnc dalla striscia in alto (Scegli connessione…) e le celle di tipo sql iniziano a eseguire sul database, non tramite un interprete. Il risultato di un SELECT diventa una tabella nel file di output (Markdown vero, che qualsiasi visualizzatore mostra formattato); INSERT/UPDATE e simili riportano quante righe sono cambiate, e un errore del database interrompe lo script registrando l'istruzione fallita. Portiamo fino a 100 righe per query (il file avvisa quando ce n'erano di più) — il risultato è un'annotazione, non una copia della tabella.

La connessione vive nel blocks.json come percorso relativo, quindi il notebook continua a funzionare spostando o sincronizzando la cartella. Per un notebook autonomo, tieni il .lnc stesso dentro il bundle: conta come configurazione, non diventa una cella. È la stessa connessione della scheda Database — connettersi in un punto vale anche nell'altro, e la password segue le regole della Passphrase. Senza connessione impostata, una cella sql continua a girare con l'interprete configurato, come prima.

Attività (Kanban / Gantt)

Un bundle di Attività (.lnt) apre una bacheca con le viste Kanban (colonne di stato, trascina le schede), Gantt (pianificazione basata sull'impegno) e calendario. Ogni attività può avere un titolo, una colonna (stato), un impegno in ore e una nota .md associata. Le attività sono raggiungibili anche dall'IA, tramite MCP e CLI (creare, spostare, aggiornare, leggere/scrivere la nota).

Campi per attività: oltre a stato e impegno, ogni attività ha una priorità (colora il bordo della scheda e ordina la Tabella), una data di scadenza (chip rosso se in ritardo), più tag, una checklist di sottoattività (badge di avanzamento sulla scheda) e la ricorrenza (completare un'attività ricorrente genera l'occorrenza successiva). Modificali dal menu contestuale (Tabella/Kanban) e nel pannello Proprietà.

Cattura ed elenchi: l'Attività rapida del tray comprende il linguaggio naturale (es. Pay bill tomorrow 5pm #home !high; le parole di data, ora e priorità sono riconosciute in inglese e in portoghese). Il pulsante Modelli salva/applica modelli di attività; gli elenchi per scadenza filtrano Oggi/Prossimi 7 giorni/In ritardo; le Visualizzazioni salvate memorizzano filtro+ordinamento; e il tray/Launcher mostrano i promemoria per le attività in scadenza oggi o in ritardo.

Bacheca Kanban: puoi raggruppare le colonne per stato, priorità o tag, creare corsie (swimlane), impostare limiti WIP per colonna (l'intestazione diventa rossa se superata) e ordinare le schede. Navigazione da tastiera in stile Linear: ←/→ spostano il focus, Ctrl+←/→ spostano la scheda, N crea, Spazio completa/riapre e Canc elimina. C'è anche la vista Calendario (per data di scadenza).

Nota incorporata: selezionare un'attività mostra la sua nota .md accanto alle viste (salvata automaticamente quando cambi attività); il pulsante Nota attiva/disattiva l'editor e Apri nota in una scheda la apre nella propria scheda. Archiviare un'attività la nasconde da tutte le viste; l'interruttore Mostra archiviati rivela quelle archiviate (attenuate).

Nelle Impostazioni delle attività puoi impostare Archivia le attività completate dopo N giorni: all'apertura della bacheca, le attività rimaste nell'ultima colonna più a lungo di così vengono archiviate automaticamente (0 = disattivato).

La nota si apre incorporata per impostazione predefinita (doppio clic sull'attività) e si salva da sola mentre scrivi: le Attività non chiedono mai "salvare?" alla chiusura. Dentro la nota funzionano le azioni IA (Ctrl+K / Ctrl+I).

Barra della scheda. Le azioni che dipendono dall'attività selezionata (Elimina, Dipendenze, Cronologia (Git)) e Esporta CSV stanno nel pulsante ⋮. Il pulsante Viste raccoglie gli elenchi per scadenza, le viste salvate e mostra archiviate — tutti agiscono sulla Tabella. Ctrl+F mette a fuoco il filtro rapido e il contatore a destra mostra quante attività ha lasciato il filtro.

Tabella personalizzata (.lnd)

Una Tabella personalizzata (.lnd, sotto File → Nuovo) è il tuo mini-database: definisci le colonne a runtime — testo, numero, data, elenco fisso con colori, percorso, tag e password — e compili le righe come un foglio di calcolo, con ordinamento e filtro. Un campo percorso raggruppa le righe in un albero (es. Casa/Ufficio).

Le celle Password sono cifrate singolarmente con la Passphrase e rivelate su richiesta. Come le Attività, il bundle persiste come testo Git-friendly (NDJSON) — può essere versionato e unito (merge) tra macchine diverse.

Nelle colonne di testo, aprire una cella mostra un editor multilinea flottante: Invio inserisce un'interruzione di riga e Ctrl+Invio conferma; la griglia mostra il testo su una sola riga (con …) e il contenuto completo nel tooltip. Per cambiare il tipo di una colonna, usa il menu dell'intestazione: convertire testo → password cifra i valori con la Passphrase; convertire password → testo chiede conferma e il PIN/Passphrase e scrive il contenuto come testo semplice (irreversibile). Le altre conversioni mantengono i valori.

Base (query salvate sulle note)

Una Base (.lnq, in File → Nuovo → Nuova Base) è una query salvata sulle tue note: filtra per tipo e per proprietà e vedi il risultato come tabella o bacheca. La Base non conserva alcun dato: le righe sono le tue note .md e la fonte di verità di ogni cella è il frontmatter della nota. Eliminare un .lnq non perde alcuna nota.

Modificare la cella scrive nella nota. Nella tabella, cambiare una proprietà riscrive solo quella riga del frontmatter del file. Nella bacheca, trascinare una scheda da una colonna all'altra scrive il nuovo valore della proprietà di raggruppamento (per esempio da in lettura a letto).

Ogni nota dichiara le sue proprietà nel frontmatter (type, status, autore…). Usa il pannello laterale Proprietà della nota per modificarle come campi tipizzati (testo, numero, data, casella) invece che come YAML grezzo — vedi Note in Markdown.

Il file .lnq è NDJSON (un record per riga), pensato per Git: due macchine possono modificare la stessa Base in parallelo — una aggiunge una colonna, l'altra regola un filtro — e il merge mantiene entrambe le modifiche senza conflitti.

Schema dichiarato (facoltativo). Per impostazione predefinita LightNote deduce i campi di ogni tipo da ciò che le note già usano: non devi dichiarare nulla. Quando vuoi fissare lo schema, apri Strumenti → Tipi di nota... (o il pulsante a ingranaggio della mini-barra Proprietà della nota): dichiara i campi di ogni tipo, il loro tipo di dato (testo, numero, data, casella di controllo, elenco di opzioni) e un modello predefinito. Con lo schema, un campo elenco di opzioni diventa un menu a discesa con i valori ammessi, i campi dichiarati compaiono nei selettori di colonna e filtro della Base anche prima che una nota li usi, e il pulsante Applica il modello del tipo inserisce lo scheletro della nota. Lo schema vive in .lightnote/types.ndjson — NDJSON unibile, versionato in Git insieme alle note; eliminarlo non modifica alcuna nota, si torna soltanto alla deduzione.

Ricerca nei file ed elementi in sospeso

Usa Ctrl+Shift+F per la ricerca globale nella scheda Ricerca della barra laterale, basata su ripgrep: supporta regex, sensibilità alle maiuscole, parola intera e sostituzione in blocco. Nel file corrente, Ctrl+F trova e Ctrl+H sostituisce.

Evidenziazione e segni sono cose diverse. La ricerca rapida (Ctrl+F) si limita a evidenziare le occorrenze in ambra: è temporanea e scompare quando chiudi la barra o svuoti il campo. Segna tutto in Modifica → Ricerca avanzata… è invece una tua decisione: colora le occorrenze di rosso e aggiunge il segnalibro (il pallino blu nel margine) sulle righe corrispondenti, che restano finché non usi Cancella segni. I due canali sono indipendenti: chiudere la ricerca rapida non cancella ciò che hai segnato, e cancellare i segni non elimina l’evidenziazione della ricerca. Entrambi compaiono nella striscia della minimappa, ciascuno con il proprio colore.

La sezione Elementi in sospeso della barra laterale raccoglie in un unico posto i marcatori TODO/FIXME del codice e le attività (- [ ]) delle note Markdown dello spazio di lavoro — clicca per saltare direttamente alla riga.

Versionamento (Git semplificato)

Il versionamento è opt-in per ogni spazio di lavoro. Abilitalo in Strumenti → Impostazioni dello spazio di lavoro: LightNote crea il repository Git (se non ne esiste ancora uno) e mostra la barra laterale di versionamento (Ctrl+Shift+G).

In modalità automatica, LightNote salva le versioni (commit) da solo nei momenti scelti nelle Impostazioni generali (al salvataggio, alla chiusura della scheda o alla chiusura della finestra). In modalità manuale, scrivi il messaggio e salvi la versione nel pannello. L'indicatore della barra di stato mostra lo stato (nessuna modifica, X modificati…) e, se cliccato, apre le impostazioni dello spazio di lavoro. Puoi visualizzare il diff di ogni file e ripristinare (scartare) le modifiche non salvate.

L'automazione ha 3 livelli per cartella (in Impostazioni dello spazio di lavoro): Manuale (nulla di automatico), Commit automatico (salva le versioni da solo, ma non sincronizza) e Completamente automatico (fa commit e sincronizza — push dopo il commit + pull periodico; richiede credenziali Git senza richiesta di password). Il pannello mostra una riga di stato con ↑ da inviare / ↓ da ricevere rispetto al remoto, e il pulsante principale passa da commit a Sincronizza quando ci sono versioni da inviare — rendendo chiaro che, dopo aver salvato, devi ancora sincronizzare.

Il pannello Git e il menu Git dell'albero offrono Aggiungi (git add) e Ripristina (git restore) per file, oltre a Confronta affiancato (l'intero file con l'ultima versione).

Snapshot e backup

Nel menu ⋯ del pannello di versionamento (o sotto Strumenti):

  • Crea snapshot: marca lo stato corrente con un'etichetta di data/ora così puoi tornarci in seguito.
  • Ripristina snapshot: scegli uno snapshot e cosa fare — riportare i file mantenendo la cronologia (consigliato), riavvolgere la cronologia a quel punto, oppure aprirlo come copia separata.
  • Esporta copia (.zip): comprime l'intero spazio di lavoro in un file autonomo (con il marcatore di progetto incorporato) da inviare o archiviare altrove.
  • Sposta cartella dello spazio di lavoro…: sposta la radice su disco e aggiorna i percorsi della sessione e del registro.

Revisione modifiche (checkpoint)

Strumenti → Revisiona modifiche… mostra, in un'unica scheda, il diff aggregato di tutto ciò che è cambiato nello spazio di lavoro a partire da una base: l'elenco dei file aggiunti/modificati/eliminati a sinistra e il diff del file selezionato a destra. È stata pensata per revisionare cosa ha cambiato una sessione di CLI di IA prima di accettare il lavoro.

La base può essere l'ultima versione (HEAD) o un checkpoint: creane uno prima di iniziare un'attività (pulsante sulla scheda stessa) e confrontalo in seguito. I checkpoint non creano commit e non toccano mai la tua cronologia. Richiede il versionamento abilitato per la cartella.

Commenti in lotto. Durante la revisione di una sessione IA, il pulsante Commenta (anche nel menu contestuale dell'elenco file) annota un commento sul file selezionato — ancorato al frammento che scegli. I commenti si accumulano in un elenco e raggiungono il terminale della CLI solo quando premi Invia alla sessione, tutti in un unico messaggio. È voluto: inviarli uno alla volta porta l'agente a correggere un problema e a romperne un altro, perché ogni giro non vede le altre osservazioni. Dopo la revisione i commenti restano nell'elenco per verificare se sono stati accolti; spunta quelli risolti e ciò che resta entra nell'invio successivo. Se l'agente riscrive la zona commentata, il commento viene attenuato invece di sparire. L'invio è confermato nella barra di stato e una sessione ibernata viene ripresa automaticamente per ricevere il lotto.

Confronta file (diff)

Strumenti → Confronta due file… apre entrambi affiancati (due editor) e segna le differenze riga per riga. Il confronto è di sola lettura.

I pulsanti ◀ / ▶ (o F8 / Shift+F8) saltano alla modifica precedente/successiva. Dal pannello Git puoi anche confrontare un file affiancato alla versione salvata (HEAD vs. disco).

Esegui codice (F5)

Strumenti → Esegui file (F5) salva il file corrente e lo esegue nel terminale, secondo l'interprete registrato per l'estensione. I valori predefiniti coprono .py, .sh, .bat, .cmd e .sql; puoi modificare/aggiungere interpreti in Impostazioni → Esecuzione.

Il comando è un template con {file} (file), {folder} (cartella) e {name} (nome) — per esempio, per Python: python {file}. Puoi anche inviare solo la selezione/riga corrente al terminale con Ctrl+Shift+Invio. Nei Blocchi, ogni cella viene eseguita tramite lo stesso meccanismo.

Il pulsante Esegui ha una freccia per scegliere e ricordare il terminale di destinazione quando è aperto più di un terminale.

Errori cliccabili. Nel pannello di output (F6) i riferimenti a file:riga diventano collegamenti: Ctrl+clic o doppio clic apre il file nel punto esatto. Funziona con i traceback di Python, gli stack di Node, gli errori del compilatore (gcc/clang/MSVC) e l’output dei linter. Diventa un collegamento solo ciò che esiste davvero su disco; il resto rimane testo.

Scorrere gli errori. Nel pannello di output, F8 passa all’errore successivo e Shift+F8 al precedente (ci sono anche i pulsanti nella barra del pannello). Il salto è circolare: scorre l’output fino al riferimento, lo evidenzia e apre il file nel punto esatto.

Terminale e CLI di IA

Pallino di stato per comando. Accanto a ogni comando eseguito appare un pallino: blu se ha avuto successo, rosso se ha fallito (il tooltip mostra ora, durata e codice di uscita). LightNote lo abilita automaticamente in PowerShell e Git Bash, senza modificare la tua configurazione — attivalo/disattivalo in Impostazioni → Terminale → Integrazione shell. Altre shell (cmd, WSL) o comandi personalizzati non mostrano il pallino.

Apri un terminale integrato (emulatore VT completo, via ConPTY) con Ctrl+' (sul layout di tastiera US, anche Ctrl+`). Diventa una scheda e può essere spostato tra le aree della finestra. Le shell disponibili e le CLI di IA rilevate nel PATH (es. claude) sono configurabili in Impostazioni → Terminale e Impostazioni → Assistenti IA. Nel menu Nuovo terminale, scegliere una CLI di IA apre quella CLI come terminale — la TUI/i colori appaiono normalmente, e chiuderla chiude la scheda.

Programma un invio. Nel menu contestuale del terminale (clic destro), Programma invio… permette di inviare un Invio (o del testo) più tardi — comodo per riprendere una CLI di IA quando si azzera il limite di utilizzo, senza doverlo controllare. Scegli un trigger: a un'ora, dopo alcuni minuti, ogni intervallo (ricorrente), oppure quando il terminale diventa inattivo. Il computer viene tenuto sveglio finché non scatta. La programmazione dura finché la scheda del terminale resta aperta.

Puoi avere diverse programmazioni contemporaneamente. Quando ce n'è almeno una, la voce di menu mostra Invii programmati (N)… e apre un gestore: una tabella con il terminale, cosa verrà inviato, quando e un conto alla rovescia dal vivo fino al prossimo invio, con i pulsanti Nuovo, Modifica e Rimuovi. Finché ci sono programmazioni, un indicatore a orologio con il conteggio appare nella barra di stato (cliccalo per aprire il gestore) e un piccolo orologio segna la scheda del terminale armata.

Avviso di fine turno dell'IA. Quando un terminale di CLI di IA resta in silenzio — segno che l'agente ha finito il suo turno — LightNote ti avvisa: compare un toast (cliccalo per mettere a fuoco quel terminale) e la scheda lampeggia alcune volte, poi mantiene un'evidenziazione finché non la apri. Se la finestra è in secondo piano, lampeggia anche il suo pulsante nella barra delle applicazioni. L'avviso vale solo per i terminali di CLI di IA e solo quando la scheda non ha il fuoco. Attivalo/disattivalo e regola il tempo di silenzio in Impostazioni → Terminale → Avviso di fine turno dell'IA.

I terminali tornano con la finestra. Chiudendo e riaprendo lo spazio di lavoro, i terminali di shell comune (Prompt dei comandi, PowerShell, Bash) vengono riaperti — e nella cartella in cui eri, non in quella in cui il terminale era partito. Il contenuto dello schermo non torna, ma la cronologia dei comandi è della shell stessa ed è ancora lì: la freccia ↑ funziona normalmente. Le sessioni di assistente IA restano fuori e continuano a essere proposte a parte, perché un terminale nuovo non è la stessa conversazione. Non tornano nemmeno le variabili d'ambiente né gli ambienti attivati a mano in quella sessione (un venv, per esempio): il terminale riapre nella cartella giusta, ma è una shell nuova.

Assistente IA sulla selezione (Ctrl+K / Ctrl+I)

IA predefinita. In cima a Impostazioni → Assistenti IA, l'IA predefinita sceglie l'assistente usato da Ctrl+K/Ctrl+I, dalla chat Chat IA (modificabile per sessione) e dalle attività automatiche (riscrivere la domanda, riassumere, riassunto audio, generare il contesto). Elenca sia le CLI sia i provider API. La trascrizione audio e gli embeddings hanno un provider proprio, e LightNote suggerisce un modello in base al provider scelto.

Premi Ctrl+K (Chiedi all'IA) o Ctrl+I (Modifica con l'IA) nell'editor — con o senza selezione — per aprire un popup flottante in stile chat inline: il campo del prompt viene precompilato con la selezione sotto una riga vuota; digita l'istruzione sopra e invia con Ctrl+Invio. Nel popup scegli l'IA (quella predefinita è preselezionata) e la modalità del risultato: sostituire la selezione tramite un diff (Originale × Suggerimento, con Accetta / Copia / Rifiuta) oppure solo visualizzare la risposta come testo.

LightNote esegue la CLI di IA in modalità "one-shot" (senza aprire un terminale). Le CLI e l'IA predefinita si trovano in Impostazioni → Assistenti IA.

Modelli via API. Oltre alle CLI locali, puoi registrare modelli LLM tramite un'API compatibile con OpenAI (OpenAI, Groq, DeepSeek, OpenRouter, Gemini, Anthropic, istanze locali come Ollama/LM Studio…) in Impostazioni → Assistenti IA. Scegli un provider dal catalogo (URL base già pronto), incolla la chiave (memorizzata codificata solo su questa macchina), usa Cerca modelli… e Test. I modelli registrati compaiono nello stesso selettore di Ctrl+K, insieme alle CLI.

Collegare in un passo. Il percorso normale non è compilare la tabella: in Impostazioni → Assistenti IA fai clic su Collega un'IA…, scegli il provider (l'elenco segnala chi ha un piano gratuito e chi gira sul tuo computer, senza chiave), segui i tre passaggi, apri la pagina delle chiavi con il pulsante e incolla la chiave. LightNote compila da solo indirizzo e modello e testa la connessione prima di salvare: una chiave sbagliata si vede lì, non in mezzo a una conversazione. L'elenco in alto mostra ciò che è già collegato e, per quanto è incompleto, che cosa manca («manca incollare la chiave», «manca scegliere il modello»); un doppio clic riapre l'assistente su quel provider.

Regolazioni fini. Indirizzo, modello, permesso MCP, comandi delle CLI, trascrizione audio ed embedding restano tutti disponibili in Avanzate, in fondo alla pagina — e nell'assistente stesso, in Opzioni avanzate, puoi cambiare l'URL di base e il modello prima di collegare. Non è stato tolto nulla: si è solo spostato dalla strada di chi inizia.

Ancora nessuna IA? Usando Ctrl+K senza alcun assistente collegato, LightNote lo spiega e propone di collegarne uno subito — e appena lo colleghi, l'azione richiesta prosegue, senza ripetere la scorciatoia.

LLM locale (senza chiave). I provider locali — Ollama, LM Studio, llama.cpp — non richiedono una chiave API: scegline uno in Aggiungi (il selettore indica se il server è in esecuzione) e usa Cerca modelli… per scegliere tra i modelli che hai scaricato. Se Ollama non è installato, LightNote si offre di installarlo. È già registrato alla prima esecuzione: devi solo scegliere il modello. Poiché un modello locale può impiegare molto più tempo a rispondere (soprattutto alla prima generazione, mentre il modello viene caricato), LightNote lo attende molto più a lungo di un servizio cloud. Nessun tuo testo lascia la macchina.

Accetta blocco per blocco. Quando il risultato arriva come diff, non devi accettarlo tutto: ogni blocco modificato ha una casella per includerlo o meno, e il testo finale viene ricostruito solo con i blocchi che tieni. Il prompt porta anche il contesto automatico del file (percorso, linguaggio e le righe attorno alla selezione), così l'IA risponde con più precisione senza che tu incolli nulla.

Libreria di prompt. IA → Libreria di prompt… conserva prompt riutilizzabili come file .md in una cartella Prompts/ del tuo spazio di lavoro — formato aperto, versionabile in Git e parte del tuo secondo cervello. Il selettore offre ricerca, anteprima e un pulsante per creare un nuovo prompt. Quando ne scegli uno, i campi {selection}, {file}, {folder}, {name} e {language} vengono riempiti con il contesto dell'editor corrente (le tue variabili sono preservate), e il testo viene inserito nel campo di Ctrl+K oppure inviato al terminale di IA attivo, senza inviarlo.

Non solo nell'editor di codice. Le azioni IA (Ctrl+K / Ctrl+I e il menu contestuale) funzionano anche nell'editor Markdown, nella nota incorporata delle Attività e nell'editor di query SQL del database: in ciascuno il popup si apre sopra il cursore e applica il risultato sul posto.

Tutte le azioni di IA stanno nel menu IA (nel pulsante ☰ e nel pulsante bacchetta della barra delle attività): Chiedi all'IA (Ctrl+K), Modifica con l'IA (Ctrl+I), Sessioni di IA, Chat IA, Libreria di prompt, Genera il file di contesto del progetto, Attiva l'IA in questa cartella e Configura gli assistenti di IA.

Sessioni IA

IA → Sessioni IA… apre un cockpit che elenca, con una scheda per sessione, ogni terminale di CLI IA aperto in qualsiasi finestra di LightNote — con un pallino colorato di stato, il nome della CLI, la finestra e le etichette di ciò che richiede attenzione (invii programmati, copia isolata). Il doppio clic mette a fuoco il terminale; il menu ⋯ della scheda (o il tasto destro) offre rivedere le modifiche di quella sessione (apre la schermata di revisione con la base sul checkpoint creato all'inizio della sessione — vedi Rivedere le modifiche) e programmare un invio. È il modo di tenere d'occhio più sessioni di "vibe coding" contemporaneamente senza perderti tra le finestre.

Quando apri una CLI IA come terminale in un repository Git, LightNote salva automaticamente un checkpoint (etichetta "Sessione …"), così puoi poi vedere e annullare esattamente ciò che quella sessione ha modificato. La funzionalità può essere disattivata in Impostazioni → Generale → Funzionalità.

Copia isolata (worktree): nelle cartelle con Git, LightNote può eseguire l'assistente IA in una copia isolata della cartella (un branch dedicato), senza toccare i file che modifichi a mano. La prima volta chiede; poi è automatico (si attiva/disattiva per cartella in Configurazione dello spazio di lavoro → Integrazioni). Un'etichetta copia isolata segnala la sessione (branch e percorso sono nel suggerimento), e le voci Unisci… (porta le modifiche nella tua cartella — se hai modifiche in sospeso, chiede prima) e Scarta… (butta via la copia e il branch) chiudono il ciclo.

Avviso di sessione inattiva. Quando una CLI di IA diventa inattiva (ha finito o ti sta aspettando), LightNote mostra una notifica; facendo clic si apre la revisione delle modifiche di quella sessione. Così puoi avviare l'attività e allontanarti. Disattivabile in Impostazioni → Terminale.

File di contesto del progetto. Quando apri una CLI di IA in una cartella priva di un file di contesto (CLAUDE.md o AGENTS.md), LightNote propone di generarne uno — e puoi farlo in qualsiasi momento da Strumenti → Genera file di contesto del progetto…. Un buon file di contesto descrive la struttura e le convenzioni del progetto e aiuta l'IA a commettere meno errori, senza rispiegare tutto a ogni sessione. Se è configurato un provider di IA, è lui a generare il contenuto; altrimenti ottieni uno scheletro da completare.

Ibernare le sessioni inattive. Una CLI di IA ferma continua a occupare memoria (la conversazione e il client del modello). In Impostazioni → Terminale puoi impostare un tempo di silenzio dopo il quale LightNote termina il processo e lo riprende da solo quando torni a quella scheda — la cronologia del terminale resta a schermo. Arriva attivo, con 30 minuti — tre sessioni ferme di Claude Code occupavano oltre 1 GB nella misurazione — e vale solo per sessioni in copia isolata le cui CLI sanno riprendere la conversazione della cartella (oggi Claude Code e Antigravity), perché altrimenti la ripresa porterebbe la conversazione di un'altra sessione. Una sessione con un invio programmato non iberna mai. E ciò che torna è la conversazione, non la schermata dello strumento: un testo digitato e non ancora inviato va perso.

Scheda Attività. La tabella mostra ciò che gira ora; la scheda Attività conserva la cronologia: ogni volta che un agente ha finito il turno, è partito in una copia isolata o è andato in ibernazione, con la data e un frammento dell'ultima risposta. Le voci non lette appaiono in grassetto e il conteggio compare anche nel menu dell'area di notifica — così chi si è allontanato dal computer vede ciò che ha perso, dato che le notifiche sono passeggere. Aprire la scheda segna tutto come letto; un doppio clic riporta alla sessione. Anche la fine di una sessione diventa un evento — compreso quando la CLI esce da sola —, così una sessione morta mentre eri via lascia traccia invece di sparire. Se la sessione dell'evento non è più aperta, il doppio clic lo dice invece di non fare nulla.

Chat IA

IA → Chat IA… apre una chat che risponde usando le tue note come contesto. Invece di inviare tutto al cloud, LightNote recupera localmente gli estratti più pertinenti dal tuo vault (tramite ripgrep, senza embedding né servizi esterni), costruisce la domanda con quegli estratti e la invia a un provider IA via API che hai registrato. La risposta arriva con le note di origine come citazioni cliccabili — clicca per aprire la nota. Ottimo per "dialogare con il tuo secondo cervello" e ritrovare ciò che hai già annotato. La cronologia della conversazione resta solo in memoria (non viene salvata); la funzionalità può essere disattivata in Impostazioni → Generale → Funzionalità.

La finestra. I selettori stanno in un'unica barra in alto: l'IA, la cartella delle note e — quando c'è un editor di testo attivo — il contesto; a destra ci sono i due permessi (Strumenti e Consenti modifiche) e il pulsante +, che avvia una nuova conversazione. Prima della prima domanda lo schermo dice su cosa risponderà la finestra e offre scorciatoie con un clic, come Riassumi questa cartella. Nel campo della domanda, Invio invia e Maiusc+Invio va a capo; mentre la risposta arriva, il pulsante di invio diventa Ferma.

Lasciare che l'IA usi gli strumenti. La casella Consenti modifiche cambia il funzionamento: invece di rispondere solo con gli estratti recuperati dalla ricerca per termini, il modello può cercare da solo — leggere un file, cercare note, elencare attività — e solo allora rispondere. All'attivazione, LightNote verifica subito se il modello scelto sa chiamare strumenti: molti fornitori accettano la richiesta e semplicemente li ignorano, il che senza questa verifica darebbe una risposta inventata dall'aria documentata. L'esito viene ricordato sette giorni per ogni coppia fornitore+modello. Richiede un fornitore via API (una CLI locale non può ricevere strumenti). Alla fine compare l'elenco di ciò che è stato davvero usato, così giudichi la risposta invece di fidartene. Se il verdetto è negativo — il fornitore potrebbe semplicemente essere stato irraggiungibile in quel momento —, accanto al messaggio compare il pulsante Verifica di nuovo, che ripete il test ignorando quanto memorizzato.

Lasciare che l'IA modifichi le tue cose. La seconda casella, Consenti modifiche, è un passo a parte ed è disattivata. Con essa l'IA può anche creare note e attività, cambiare proprietà e annotare nella nota di oggi — ma nulla accade senza la tua conferma: la modifica compare nella conversazione in parole chiare («creare l'attività Comprare il pane»), con Consenti e Rifiuta. Rifiutare non chiude la conversazione; il modello viene avvisato e prosegue, spiegando o proponendo altro. Leggere non chiede mai — solo modificare. Sovrascrivere file qualsiasi e accedere alla rete restano volutamente esclusi: finché l'IA si limita a leggere, un testo ostile arrivato in una nota sincronizzata da fuori non può diventare una modifica sul tuo disco. Quando la modifica è un’annotazione sulla nota del giorno, la richiesta indica anche in quale cartella finirà: è l’unica scrittura il cui file di destinazione non compare in ciò che l’IA ha chiesto.

Le note o il file aperto. Il menu Contesto: in alto nella finestra sceglie di cosa parla la conversazione: Note del vault (predefinito, descritto sotto) o Editor corrente — che risponde sul file aperto nell’editor anziché sul vault, usando la selezione e le righe circostanti (o l’intero file, con la casella Intero file). Così la stessa finestra serve a parlare delle tue note e del codice che stai modificando, in più turni. L’ambito Editor corrente compare solo quando un editor di testo è attivo. E nell’assistente rapido (Ctrl+K), il risultato ha un pulsante Continua nella chat → che riapre questa finestra già nell’ambito Editor corrente, con la domanda e la risposta di quel turno — per approfondire senza ricominciare.

Quali note? La finestra è unica e risponde su una cartella per volta — il menu Note da:, accanto al selettore dell'IA nella barra in alto, mostra e sceglie quale. Si apre già puntata alla cartella della finestra da cui hai aperto la chat ed elenca le cartelle aperte ora, seguite dalle recenti; Scegli cartella… punta a qualsiasi altra. Cambiare cartella vale per le domande successive — anche per interrogare le note di un progetto mentre lavori in un altro. Scelta a mano, la cartella resta finché non la cambi di nuovo (riaprire la finestra non riporta indietro l'ambito). Mentre una domanda è in corso — anche se ferma in attesa della tua conferma —, i selettori di IA, contesto e cartella restano bloccati: la risposta in arrivo appartiene al modello e alla cartella di quando hai chiesto.

Come chiedere. Il recupero è per argomento, non per istruzione: LightNote prende le parole della tua domanda e cerca le note che le contengono. Cita un tema che compaia nelle note ("cosa ho annotato su Postgres?") anziché una richiesta generica ("fai un riassunto") — quest'ultima non ha alcuna parola di contenuto da cercare, quindi non viene recuperato nulla e la chat avvisa che la risposta non ha usato le tue note. Vengono lette solo note .md/.markdown; in una cartella che non ne ha, la chat lo segnala e non consuma una chiamata all'IA.

Ricerca, riassunto e riscrittura migliori. Il recupero usa un indice locale con ranking BM25 che ignora gli accenti ("configuração" trova "configuracao") e funziona anche nelle lingue senza spazi tra le parole (giapponese, cinese, coreano) — ripgrep è il ripiego mentre l’indice viene costruito. Il pulsante Riassumi questa cartella produce una panoramica di tutte le note quando non hai una domanda specifica. E in Impostazioni → Generale → Funzioni, l’opzione Riscrivere la domanda con l’IA espande la domanda in parole chiave prima di cercare (costa una chiamata API per domanda).

Basta una chiave. Al primo avvio, LightNote registra già OpenAI, Google Gemini e Anthropic (Claude) in Impostazioni → Assistenti IA: basta incollare la tua chiave API nel provider che usi. Se nessun provider ha una chiave, la finestra mostra un pulsante Configura ora che apre direttamente quella schermata.

Le conversazioni vengono conservate. Il pulsante con l'orologio in alto apre l'elenco delle conversazioni precedenti di quella cartella: fai clic su una per tornarci. Nuova conversazione archivia quella corrente invece di cancellarla, e il tasto destro nell'elenco ne elimina una definitivamente (con conferma). Le conversazioni sono conservate per cartella: cambiare la cartella delle note cambia l'elenco.

Cosa fare con una risposta. Sotto ogni risposta ci sono Copia (mette il testo in Markdown negli appunti, con la formattazione intatta) e Cattura nella nota (invia la risposta alla nota del giorno, insieme ai collegamenti alle note citate). Nel menu Azioni della conversazione trovi Copia conversazione, Salva conversazione come nota… (scrive un .md nella cartella consultata), Rigenera l'ultima risposta e Modifica l'ultima domanda.

Allegare un file. Quando la ricerca non trova quello che avevi in mente, usa il pulsante + per allegare un file: entra sempre nella domanda, fuori dalla classifica della ricerca. Vanno bene nota, codice, testo e PDF (il testo del PDF viene estratto); un binario viene rifiutato subito invece di diventare rumore nel contesto. L'allegato compare come una pillola (fai clic per staccarlo) e sparisce quando inizi una nuova conversazione. Con i fornitori che lo supportano, la risposta compare anche gradualmente, mentre il modello scrive.

Test di API HTTP (.lnh)

Strumenti → Nuovo test API (.lnh)… apre un client HTTP salvato in un file .lnh. Un file rappresenta un endpoint (metodo, URL, intestazioni e corpo) e conserva diversi test nell'elenco a sinistra — ogni test con i propri valori per le variabili {name} usate nell'URL, nelle intestazioni e nel corpo, oltre al risultato dell'ultima esecuzione (stato, tempo, data, intestazioni e corpo della risposta). Mostra anche il comando curl equivalente. La stessa operazione one-off è disponibile tramite CLI (http) e MCP (http_request).

Ctrl+Enter invia la richiesta.

Importare ed esportare OpenAPI. Il pulsante con le frecce in cima all'elenco dei test apre Importa OpenAPI… ed Esporta OpenAPI…. L'importazione legge una specifica in YAML o JSON nelle tre generazioni in uso — Swagger 2.0, OpenAPI 3.0 e 3.1 — e costruisce il test da sola: i {parametri} del percorso usano già la stessa sintassi delle variabili {nome} del file .lnh, gli esempi dichiarati diventano i valori del test, lo schema di sicurezza diventa l'intestazione Authorization e ogni server dichiarato diventa un test a sé (collaudo e produzione affiancati). Poiché un .lnh contiene un endpoint, una specifica con più operazioni chiede quale importare — oppure scrive tutte insieme, un file .lnh per operazione.

L'esportazione fa il percorso inverso e genera una specifica OpenAPI 3.0.3 a partire dal file: server, parametri e corpo derivano dal modello, e le risposte di esempio dalle esecuzioni registrate. È uno scheletro, non un contratto completo — il .lnh descrive chiamate, quindi tipi, descrizioni e schemi non vengono ricostruiti. I tuoi test viaggiano nel campo x-lightnote-tests, e per questo tornano intatti quando reimporti il file.

Importare un comando curl. Nello stesso pulsante, Importa comando curl… apre una casella per incollare — è da lì che arriva il comando, non dal disco, e il campo è già compilato quando negli appunti c'è un curl. Capisce i tre dialetti in cui circola lo stesso comando: Copia come cURL di Chrome/Firefox (apici singoli), Copy as cURL (cmd) su Windows (con ^) e l'esempio della documentazione spezzato con \. Il metodo viene da -X — oppure è dedotto: POST quando c'è un corpo, GET quando non c'è.

L'importazione è letterale: nessun valore diventa da solo una variabile {nome}, perché indovinare quale token sia un segreto sbaglierebbe. Alcuni casi avvisano invece di mentire — un corpo che proviene da un file (-d @file) non può essere letto, e l'invio multipart (-F) non viene riprodotto fedelmente, quindi i campi finiscono nel corpo come testo perché tu li sistemi.

Database (.lnc)

Una connessione è un file .lnc (LightNote Connection) all'interno dello stesso spazio di lavoro — versionabile in Git e portabile tra macchine. Creane una tramite Nuovo → Nuova connessione (oppure apri un .lnc esistente): si apre la vista Database, con la barra di stato della connessione (Connetti / Disconnetti / Riconnetti / Modifica), l'albero Schema (schemi → tabelle → colonne, caricati su richiesta) e le schede interne .sql. I file .sql aperti e quelli recenti sono memorizzati dentro il .lnc, così la vista riapre nel suo stato precedente. Se non c'era nulla di aperto, inizia con una query vuota (senza titolo) dove puoi digitare SQL subito; al salvataggio (Ctrl+S) LightNote chiede solo un nome e scrive il file dentro la cartella del progetto (nessuna finestra di dialogo "salva ovunque"). Il pulsante + Scheda apre una nuova query vuota, permette di aprire un file (il selettore si apre nella cartella del progetto) oppure scegliere un recente / qualsiasi .sql dalla cartella del progetto.

Un .sql aperto direttamente dall'albero è solo codice (evidenziazione SQL, nessuna connessione).

Driver: SQLite e DuckDB (file) nativi; PostgreSQL, MySQL/MariaDB, SQL Server e generico tramite ODBC; Oracle nativo (senza ODBC). SQL Server usa il driver msodbcsql di Microsoft (installalo sulla macchina) e offre l'autenticazione di Windows o utente/password, oltre alle opzioni di cifratura del canale (Encrypt / fidati del certificato). Per Oracle, imposta la cartella Oracle Instant Client in Impostazioni generali → Database — viene caricato a runtime, senza nulla da installare. La connessione Oracle ha quattro modalità: Nome servizio (host/porta/servizio), SID (host/porta/SID), Nome TNS (alias dal tnsnames.ora nella cartella del client) e Descrittore TNS completo (incollato in un campo di testo).

Password: spunta Salva password per cifrarla dentro il .lnc stesso (crittografia portabile, si apre su un'altra macchina); se deselezionata, la password non viene salvata e viene richiesta a ogni connessione. La cifratura usa una Passphrase per spazio di lavoro, impostata in Aiuto → Configura Passphrase; conservala al sicuro: senza di essa la password non può essere aperta da nessun'altra parte. La Passphrase è memorizzata nella cache solo sulla macchina locale (non va mai su Git).

Spunta Connetti all'apertura per far aprire automaticamente la connessione quando apri il .lnc. La connessione automatica è silenziosa: se la password deve essere digitata (modalità "chiedi", oppure cifrata senza la Passphrase in cache sulla macchina), il file si apre disconnesso, senza interruzioni.

Esecuzione: Ctrl+Invio esegue l'istruzione sotto il cursore e Alt+X esegue l'intero script; i risultati appaiono paginati, ciascuno in una scheda Risultato con una barra di azioni in basso: Recupera il blocco successivo o tutte le righe, Conteggio totale, cambia il Limite di righe, Aggiorna (riesegue), Visualizza/Copia SQL, Esporta... e Genera SQL dalla riga selezionata.

Griglia dei risultati: un NULL è mostrato in corsivo attenuato, distinto da un testo vuoto, e i numeri sono allineati a destra; selezionando più celle, il piè di pagina mostra il conteggio della selezione e, quando sono numeriche, la loro somma e media. Il pulsante Pannello valore nella barra inferiore (o Mostra valore nel pannello dal menu contestuale) apre un pannello laterale con il valore completo della cella selezionata, senza tagli, con un pulsante Formatta che abbellisce JSON/XML solo nella visualizzazione. Nel menu contestuale di una cella, Filtra per questo valore / Escludi questo valore rieseguono la query con un WHERE sulla cella, e Vai al record referenziato segue la chiave esterna della colonna e interroga la tabella padre in base al valore della cella.

Piano di esecuzione: il pulsante Piano di esecuzione della barra degli strumenti mostra l'EXPLAIN dell'istruzione sotto il cursore (SQLite, DuckDB, PostgreSQL e MySQL); sui database che non espongono il piano in una singola istruzione (SQL Server, Oracle) il pulsante è disabilitato, con il motivo nel suggerimento.

Proprietà dell'oggetto: fai doppio clic su una tabella nell'albero dello schema (o premi F4, o scegli Proprietà dal menu contestuale) per aprire una scheda con la struttura dell'oggetto, in quattro sotto-schede: Colonne (n., nome, tipo, nullabilità, valore predefinito e un'icona di chiave sulle colonne della chiave primaria), Chiavi (vincoli di chiave primaria, esterna, unica e check; un doppio clic su una chiave esterna apre la tabella referenziata), Indici e DDL — il CREATE TABLE dell'oggetto, pronto per copiarlo, salvarlo come .sql o aprirlo in una scheda modificabile. Quando il database non fornisce il DDL già pronto (PostgreSQL e SQL Server non hanno questo comando), LightNote lo ricostruisce dai metadati — lo stesso accade quando il comando di DDL viene negato per mancanza di permessi — e lo indica chiaramente nella scheda. Se non è leggibile nemmeno il catalogo delle colonne (nessun permesso o catalogo non disponibile), non c'è nulla da cui ricostruire: la scheda lo segnala invece di restare silenziosamente vuota. Il menu contestuale della tabella offre anche Copia DDL senza aprire la scheda.

Albero dello schema: l'albero Schema separa le Tabelle dalle Viste (ciascuna con la propria icona) e contrassegna con un'icona di chiave le colonne della chiave primaria. La casella di filtro setaccia solo gli oggetti già caricati (il caricamento a richiesta non viene forzato solo per filtrare).

Esplorare lo schema: Clic destro su una tabella per Inserisci SELECT nell'editor, Anteprima dati, Conta righe, Copia nome qualificato oppure apri il sottomenu Genera SQL → INSERT/UPDATE/MERGE: una schermata elenca le colonne della tabella così puoi spuntare Includi e Chiave, mostra un'anteprima dal vivo e inserisce il comando nell'editor (il MERGE esce in ANSI; se il driver non lo supporta, appare un avviso). Direttamente sulla griglia dei risultati, il pulsante Genera SQL nella barra inferiore costruisce un INSERT/UPDATE/DELETE precompilato con i valori della riga selezionata (disponibile quando la query è un SELECT su una singola tabella). I nomi di tabelle e colonne che esplori nell'albero iniziano anche a comparire nell'autocompletamento (Ctrl+Spazio) degli editor .sql della connessione, senza query aggiuntive al database.

Esporta risultati: clic destro sulla griglia dei risultati e scegli Esporta risultati... per scrivere CSV (delimitatore, carattere di quotatura, sempre tra virgolette, riga di intestazione, testo per NULL), JSON Lines o SQL (istruzioni INSERT con un nome di tabella), con un limite di righe opzionale. L'esportazione percorre l'intera query in modalità streaming (ri-recupero paginato), non solo ciò che è visibile a schermo.

Variabili di script: usa @set nome = valore su una riga dello script per definire una variabile — il prefisso @ la tiene lontana dal database (non entra in collisione con il vero SET di Postgres/DuckDB/SQL Server). I riferimenti come :nome vengono sostituiti prima dell'esecuzione (fuori da stringhe e commenti; il cast ::tipo e i bind come :1 restano intatti); un :nome senza valore apre un prompt prima di eseguire. Il pulsante Variabili sulla barra degli strumenti apre la schermata con le variabili definite (modifica/aggiungi/rimuovi).

Cronologia delle query: il pulsante Cronologia apre una finestra con le ultime istruzioni eseguite con successo su questa connessione, nelle colonne SQL / Quando / Durata / Righe. Selezionane una per Riesegui, Inserisci nell'editor o Copia (il doppio clic inserisce), oppure usa Cancella cronologia. Viene memorizzata solo sulla macchina locale (non va né su Git né nel .lnc).

Transazioni: il pulsante Autocommit (attivo per impostazione predefinita) e i pulsanti Commit/Rollback si trovano sulla barra degli strumenti. Con l'autocommit disattivato, le modifiche restano in sospeso finché non confermi (Commit) o le scarti (Rollback); disconnettersi con una transazione aperta chiede cosa fare.

Connessione SSH (.lns)

Una connessione SSH è un file .lns nello spazio di lavoro — versionabile e portabile, come il .lnc. Creane uno tramite Nuovo → Nuova connessione SSH: la scheda apre un terminale SSH integrato (tramite ssh.exe di Windows) e una mini-barra file remoti (SFTP).

Il browser dei file mostra una cartella alla volta (stile MobaXterm/WinSCP): la prima riga è sempre .. per risalire di un livello, e il doppio clic su una cartella vi entra. La barra del percorso in alto permette di digitare un percorso remoto e premere Invio per saltarci. Il pulsante Sincronizza con il terminale fa sì che la cartella mostrata segua la directory corrente della sessione SSH (ovunque tu abbia fatto cd nel terminale). Il menu del clic destro offre Apri nell'editor (scarica il file, lo apre in una scheda e ricarica al salvataggio), Scarica, Carica, Nuova cartella, Rinomina, Elimina e Permessi (chmod). Puoi anche trascinare file da Esplora risorse sul pannello per caricarli nella cartella corrente.

La password può essere cifrata dentro il .lns con la Passphrase dello spazio di lavoro oppure richiesta a ogni connessione. Le chiavi SSH dell'agente/profilo di Windows funzionano normalmente, dato che la connessione usa il client OpenSSH di sistema.

L'opzione Connetti all'apertura (nella finestra di dialogo della connessione) avvia automaticamente la sessione SSH quando apri il .lns. Se la password non è memorizzata, il terminale stesso la chiede alla connessione.

Sicurezza: Passphrase, PIN e Markdown Sicuro

La Passphrase è impostata per ogni spazio di lavoro in Aiuto → Configura Passphrase… ed è la chiave di tutto ciò che LightNote cifra: le password delle connessioni (.lnc/.lns), le celle password della Tabella personalizzata e i file .lne. La cifratura è forte e portabile (Argon2id + XChaCha20-Poly1305): un file cifrato si apre su un'altra macchina una volta reinserita lì la stessa Passphrase. Conservala al sicuro: senza di essa, i dati cifrati non possono essere recuperati. La Passphrase è memorizzata in cache solo sulla macchina locale (non va mai su Git).

Per cambiare la Passphrase, apri la stessa schermata e modifica il campo Passphrase (viene precompilato con quella attuale). Alla conferma, LightNote ricifra automaticamente tutti i dati sicuri dello spazio di lavoro — password in .lnc/.lns, il contenuto dei file .lne e le celle password delle Tabelle personalizzate (.lnd) — dalla vecchia Passphrase alla nuova. La decifratura è tutto o niente: se un solo elemento non viene decifrato, non viene cambiato nulla e LightNote indica quale. Durante la scrittura, ogni file viene copiato in un backup prima di essere riscritto; se uno non riesce a essere scritto, LightNote chiede se annullare tutto (ripristinare i backup) o saltare quel file e continuare (mantiene la vecchia Frase, con un avviso alla fine). (Le password in modalità "chiedi" non hanno nulla da ricifrare.)

Il PIN (4–8 cifre) è un blocco locale opzionale: protegge azioni sensibili dell'interfaccia (rivelare password, aprire note sicure) senza digitare la Passphrase ogni volta. Non cifra nulla e vale solo per questa macchina.

Il file Markdown Sicuro (.lne, sotto Nuovo → File Markdown Sicuro) è una nota cifrata su disco: all'apertura, LightNote chiede il PIN (se impostato) e la Passphrase, decifra solo in memoria e ricifra al salvataggio (Ctrl+S). Per sicurezza, non si riapre mai da sola quando la sessione viene ripristinata.

Note giornaliere, cattura rapida e tray

La nota di oggi è un file .md al giorno nella cartella Note giornaliere — una sola cartella, valida per tutto LightNote, impostata in Impostazioni → Note e scrittura. Dal menu del tray: Nota di oggi apre la nota del giorno; Cattura rapida… (Ctrl+Alt+N, una scorciatoia globale di Windows — oppure clic centrale sull'icona del tray) apre una piccola finestra dove digiti e premi Ctrl+Invio: il testo diventa un punto elenco con marca temporale nella nota di oggi, scritto direttamente su disco, senza aprire una finestra dell'editor.

Il menu del tray elenca anche le finestre aperte e gli spazi di lavoro recenti, e porta gli interruttori dell'alimentazione: Mantieni il computer sveglio e Mantieni lo schermo acceso (comodo per attività lunghe; LightNote già mantiene l'alimentazione da solo mentre esegue IA one-shot, celle di Blocchi o script SQL). Il launcher (finestra di avvio) ha la ricerca, il doppio clic per aprire e un menu contestuale per fissare in cima, aprire in Esplora risorse o rimuovere dall'elenco.

Le azioni che valgono per tutto LightNote — e non solo per la finestra in cui ti trovi — vivono nel menu Generale (☰ Generale, o il pulsante con l'icona dell'app nella barra delle attività), che ha esattamente la stessa forma del menu della barra delle applicazioni: nella radice Nota di oggi, Cattura rapida e Calendario; poi i sottomenu Cattura (attività rapida, registra audio, ritrovare note vecchie, note adesive), Apri (launcher, apri spazio di lavoro, apri file singolo, file singoli) ed Energia; alla fine, Impostazioni generali. La regola è semplice: ciò che è nel menu della barra delle applicazioni è nel menu Generale — e solo lì. Passando il mouse su una voce compare l'avviso “funzione generale: vale per tutto LightNote, in qualsiasi finestra”.

Dove finisce una cattura. Le note giornaliere e le attività rapide hanno una destinazione unica e prevedibile: la cartella impostata in Impostazioni → Note e scrittura e la lavagna impostata in Impostazioni → Generale, valide in qualsiasi finestra. Alla prima cattura, se non è impostato nulla, LightNote chiede dove conservarla e registra la scelta — invece di mandarti a cercare l'impostazione. Un progetto che abbia bisogno del proprio diario (un cliente sotto riservatezza, un registro che deve stare nel repository) può rivendicare le catture fatte in quella finestra in Configurazione dello spazio di lavoro → Catture; il tray e le scorciatoie globali continuano a scrivere nella destinazione generale. La conferma dice sempre dove è finito il testo.

Il menu della barra delle applicazioni è volutamente corto: nella radice restano le finestre aperte e le tre azioni quotidiane — Nota di oggi, Cattura rapida e Calendario. Tutto il resto vive negli stessi sottomenu del menu Generale: Cattura, Apri (che nella barra porta anche l'elenco degli spazi recenti), IA (sessioni di IA e chiedi alle note — nella finestra è il menu IA completo) ed Energia. Alla fine, impostazioni ed esci.

Ritrova le note vecchie

Ciò che più fa fallire un «secondo cervello» non è una funzione mancante, ma la nota che non viene mai riletta. Dal menu della barra delle applicazioni (sezione Cattura), LightNote riporta a galla le note vecchie: Nota casuale apre una nota .md a caso dello spazio di lavoro (evitando quelle apparse nelle ultime due settimane), e In questo giorno elenca le note il cui anniversario di creazione è oggi (stesso giorno e mese, in anni precedenti). Entrambe le azioni sono anche nel menu Generale → Cattura della finestra.

La data di creazione viene dal campo created/date del frontmatter, se presente; altrimenti dalla data del file. La funzione non scrive mai nelle tue note: le apre soltanto. Si può disattivare in Impostazioni → Funzionalità («Ritrova le note vecchie»).

Le tue note sul telefono

Il tuo spazio di lavoro è Markdown puro in una cartella — formati aperti, senza database proprietario né cloud obbligatorio. Per questo qualsiasi app per telefono legge e modifica le tue note, senza che LightNote abbia bisogno di un'applicazione propria per il telefono: basta sincronizzare la cartella con un servizio di file e aprirla in un editor Markdown sul telefono.

Passo dopo passo: sincronizza la cartella dello spazio di lavoro con OneDrive, Google Drive, Dropbox o Syncthing e, sul telefono, apri quella cartella in un editor Markdown (ad esempio Obsidian Mobile, iA Writer, GitJournal o Markor). Poiché tutto è .md in testo, entrambi i lati vedono e scrivono le stesse note.

Raccomandazioni: sul telefono, modifica solo i file .md — i tipi propri di LightNote (.lne sicuro, .lnc, .lnt, .lnb, .lnd…) non si aprono fuori dall'applicazione, e il .lne in particolare è cifrato. Se entrambi i lati modificano offline e si verifica un conflitto, risolvilo tramite la cartella Inbox: metti lì la cattura (testo, audio o foto) e lascia che LightNote la integri nella nota del giorno, invece di sovrascrivere. Il posizionamento è deliberato — la sincronizzazione avviene per file/Git, non tramite plugin: sei proprietario dei tuoi dati e scegli il trasporto. Per scrivere direttamente nella nota di oggi, modifica il file Note giornaliere/yyyy-mm-dd.md — il nome della cartella cambia in base alla lingua.

Registrare audio (voce, riunione) con trascrizione IA

Dal menu della barra delle applicazioni, Registra audio… apre una finestra mobile e trascinabile (trascinala dalla barra del titolo) per registrare dal microfono, dall'audio di sistema (ciò che viene riprodotto sul computer) o da entrambi insieme — la fonte scelta viene ricordata per la prossima volta. Usa ● Registra, ‖ Pausa e ■ Ferma; il file finisce nella cartella Registrazioni dell'area di lavoro, compresso in .m4a quando fermi.

Due modi di trascrivere. In Impostazioni → Assistenti IA → Trascrizione audio, il selettore Come trascrivere sceglie tra il modello di trascrizione dedicato (stile Whisper: OpenAI whisper-1, Groq whisper-large-v3 — gratis — o un Whisper locale) e il modello generale con audio nella chat — l'audio va dentro la conversazione di un modello multimodale; è così che trascrive Google Gemini (gemini-2.0-flash, buon piano gratuito). Cambiare provider preseleziona la modalità giusta e suggerisce il modello; gli audio lunghi vengono suddivisi automaticamente in entrambe le modalità. Il modello suggerito può essere cambiato a mano — LightNote rispetta l'id che digiti, anche per un provider che non riconosce ancora.

Appena inizia la registrazione, la finestra si riduce da sola in una pillola compatta (un pallino rosso lampeggiante, un cronometro, Pausa/Ferma) — facile da trascinare in un angolo e tenere quasi nascosta durante una riunione lunga; il pulsante riduci/espandi nel titolo alterna manualmente, e fermare la registrazione la riespande. Ctrl+Alt+R (scorciatoia globale) è la nota vocale rapida: premi per iniziare subito a registrare dal microfono, premi di nuovo per fermare, senza aprire la finestra con il mouse.

Se è configurato un provider IA via API (in Impostazioni → Assistenti IA → Trascrizione audio), compaiono i pulsanti Trascrivi e Trascrivi + Riepiloga quando fermi (disabilitati finché l'audio è ancora in fase di compressione); il menu Alla fine può avviare la trascrizione da solo appena finisce la registrazione. LightNote invia l'audio per la trascrizione (modello in stile Whisper) e scrive una nota .md accanto all'audio con il testo e, se vuoi, un riepilogo. Attiva/disattiva la funzione in Impostazioni → Generale → Funzionalità.

La stessa finestra è un mini-player: sotto i controlli, un elenco delle registrazioni della cartella mostra ogni file con i pulsanti T (apri la trascrizione) e R (apri il riepilogo) quando esistono, oltre a un ▶ per riprodurre sul posto (barra di avanzamento con ricerca); il menu ⋮ di ogni riga riproduce, (ri)trascrive o apre la nota. Rigenerare una trascrizione non sovrascrive la precedente — crea una nuova versione a fianco (nota.md, nota (2).md…), preservando la cronologia. La sorgente di acquisizione è un pulsante a menu (Microfono / Audio di sistema / Entrambi), con Entrambi come predefinito. Il collegamento Apri cartella registrazioni apre la cartella nella finestra principale.

Note adesive

Le note adesive sono piccoli riquadri colorati di solo testo che fluttuano sul desktop, in stile dell'app Sticky Notes di Windows. Dal menu del tray: Nuova nota adesiva (Ctrl+Alt+S, una scorciatoia globale) crea un riquadro; Mostra note adesive (Ctrl+Alt+H) le mostra o nasconde tutte insieme. Ogni nota ha un + per crearne un'altra e un menu ☰ per cambiare il colore, Invia alla nota di oggi (scrive il testo come punto elenco nella nota di oggi e scarta il riquadro) oppure Elimina. Trascina l'intestazione per spostarla e l'angolo per ridimensionarla. Le note vengono salvate automaticamente e riappaiono quando riapri LightNote.

Calendario

Generale → Calendario… apre una singola finestra con un calendario che segna i giorni con attività da ogni bacheca .lnt registrata. Accanto, l'elenco Del giorno (attività del giorno selezionato) e l'elenco In sospeso; il pulsante Nota del giorno apre la nota giornaliera di quella data. Cliccare un'attività apre la bacheca corrispondente.

Nella griglia, ogni giorno con attività riceve punti colorati con il colore dello stato Kanban (fino a tre), il giorno di oggi è segnato da un anello e il giorno selezionato da un cerchio pieno; Oggi torna al mese corrente e il nome del mese apre un menu per spostarsi di mese o di anno. Le attività In sospeso sono raggruppate per situazione — In ritardo, Oggi, Prossimi 7 giorni, Più avanti e Senza data —, con la scadenza in un contrassegno relativo («ieri», «oggi», «3 giorni fa»). Un doppio clic su un giorno apre l’attività rapida già con quella data.

Tavolozza comandi

Ctrl+Shift+P apre la tavolozza dei comandi (ogni azione con la sua scorciatoia, filtrabile digitando). Ctrl+P apre il selettore rapido dei file e Ctrl+Shift+K apre il selettore delle attività.

Server MCP (agenti IA)

LightNote include un server MCP (Model Context Protocol) headless che trasforma il tuo spazio di lavoro in uno strumento per agenti IA (Claude Desktop, Claude Code, Cursor e qualsiasi client che parli MCP). L'agente può leggere e scrivere file, cercare, interrogare dati tabellari e database, lavorare con le attività, usare Git e lanciare richieste HTTP — tutto confinato alla cartella (directory jail: i percorsi con .. o fuori dalla radice vengono rifiutati). Il trasporto è JSON-RPC 2.0 su stdin/stdout; ogni sessione avvia un processo leggero lnote.exe, separato dalla finestra dell'editor.

Scorciatoia con un clic: da IA → Attiva l'IA in questa cartella, LightNote abilita l'MCP e scrive il .mcp.json in una volta (il clic è il consenso). Se l'IA è già attiva nella cartella, la voce diventa Configura l'IA di questa cartella… e apre le Impostazioni dello spazio di lavoro.

Due livelli di sicurezza: (1) il server si avvia solo se hai fatto opt-in per quella cartella; (2) ogni strumento è vincolato alla radice dello spazio di lavoro. In più, ogni strumento è annunciato con annotazioni (sola lettura, distruttivo, idempotente, "tocca il mondo esterno") così il client IA può valutare il rischio prima di chiamarlo.

Configurazione passo dopo passo

  1. Abilita l'MCP per la cartella. In Strumenti → Impostazioni dello spazio di lavoro, spunta Abilita MCP per questo spazio di lavoro. Senza questo opt-in il server si rifiuta di avviarsi (è la porta principale). In alternativa, dalla riga di comando: lnote --mcp-enable "C:\Percorso\allo\spazio-di-lavoro" (e --mcp-disable per disattivarlo).
  2. Trova il percorso di lnote.exe. Si trova nella stessa cartella di lightnote.exe (la cartella di installazione dell'app). È l'eseguibile console "snello", senza interfaccia grafica — è quello che esegue l'agente.
  3. Registra il server nel tuo client IA, puntando il comando a lnote.exe e passando --mcp seguito dalla cartella dello spazio di lavoro. Nel formato usato da Claude Desktop / Cursor e simili:
{
  "mcpServers": {
    "lightnote": {
      "command": "C:\\Percorso\\a\\lnote.exe",
      "args": ["--mcp", "C:\\Percorso\\allo\\spazio-di-lavoro"]
    }
  }
}

Suggerimenti per la configurazione:

  • Le barre rovesciate nel JSON vanno raddoppiate (C:\\Users\\...\\lnote.exe), come nell'esempio.
  • Per esporre più spazi di lavoro, aggiungi una voce per ogni cartella, con nomi distinti ("lightnote-progettoA", "lightnote-progettoB"), ciascuna che punta alla propria radice.
  • Dopo aver salvato la configurazione, riavvia il client IA così avvia il server. Una volta connesso, l'agente dovrebbe elencare gli strumenti lightnote_*; chiedigli di "elencare i file dello spazio di lavoro" per confermare che funziona.
  • Per Claude Code (CLI), lo stesso server può essere registrato con claude mcp add lightnote -- "C:\Percorso\a\lnote.exe" --mcp "C:\Percorso\allo\spazio-di-lavoro".

Password del database (opzionale). Lo strumento db_query apre una connessione .lnc. Se la password è cifrata con la Passphrase, passala tramite la variabile d'ambiente LNOTE_PASSPHRASE nel blocco del server (mai come argomento sulla riga di comando) — le connessioni con password in modalità "chiedi" non possono essere usate in modo automatizzato.

Le query dell'IA sono opt-in per connessione. Abilitare l'MCP nella cartella non espone le connessioni: ogni .lnc risponde a db_query solo quando l'opzione «Consenti query dell'IA (MCP)» è selezionata nella finestra della connessione. L'accesso è di sola lettura (SELECT).

Esportare dal database tramite l'agente. Oltre a interrogare, l'agente può materializzare una SELECT in un file con db_export (Parquet, CSV, JSON o .xlsx) — utile per risultati troppo grandi per stare in una risposta. Valgono le stesse tre cautele, in quest'ordine: la query deve essere di sola lettura, la connessione richiede l'opzione «Consenti query IA (MCP)» (verificata prima di decifrare la password) e la destinazione deve restare dentro lo spazio di lavoro. Le esportazioni grandi usano la cartella temporanea di sistema come area di appoggio, all'incirca quanto il risultato — lasciare spazio libero su disco.

Strumenti disponibili

L'agente vede gli strumenti sotto il prefisso del client (es. lightnote_read_file). Per categoria:

  • File: read_file (con intervallo di righe opzionale), write_file, edit_file (sostituisce un frammento esatto, senza riscrivere l'intero file), append_file, list_files, move_file, make_dir e delete_file (va nel Cestino, non un'eliminazione definitiva).
  • Ricerca e navigazione: search_files (ripgrep, con filtro per sottocartella/glob e limite), list_symbols (struttura delle funzioni/classi di un file) e open_in_editor (apre/mette a fuoco un file nella finestra di LightNote, se è aperta).
  • Dati e SQL: query (SQL DuckDB su Parquet/CSV/JSON, output tsv/json/markdown), describe_table (schema + statistiche, senza scaricare le righe), export_query (materializza una SELECT in un file tramite COPY), sqlite_query (SQL su un .sqlite/.db), db_list_connections (elenca i file .lnc dello spazio di lavoro) e db_query (SQL di sola lettura su una connessione .lnc). Per portare il risultato in un file invece che nella risposta, db_export (Parquet/CSV/JSON/.xlsx).
  • Inoltre: search_notes (recupera i frammenti di note più pertinenti per una domanda — lo stesso motore di Chat IA), list_links (i link in uscita di una nota, risolti o interrotti), audit_vault_links (link interrotti e note orfane di tutto il vault), list_note_templates e il parametro template di create_note, list_due_tasks (attività in scadenza oggi o in ritardo in tutti i progetti), xlsx_read (legge un foglio .xlsx come TSV), data_diff (confronta due file tabellari) e il catalogo del database db_list_objects/db_describe (tabelle/viste e le colonne, chiavi e DDL di una tabella — stessi requisiti di db_query).
  • Archivi: zip_list (elenca i membri di un .zip/.isx) e zip_read (legge un membro come testo) — senza estrarre l'archivio su disco.
  • Attività: list_task_projects (elenca i progetti di attività .lnt dello spazio di lavoro), list_tasks, list_task_statuses (colonne della bacheca), create_task, update_task, update_task_status (sposta tra colonne), delete_task e task_note (legge/scrive la nota .md dell'attività). Uno spazio di lavoro può contenere diversi progetti .lnt: scegline uno con il parametro project (il name restituito da list_task_projects; opzionale quando ce n'è solo uno). Gli id/status_id sono identificatori di sessione — non leggere i file .lnt interni per ottenerli; usa gli strumenti delle attività.
  • Note (PKM): create_note (crea una nota .md), append_daily_note (aggiunge una cattura alla nota di oggi), list_backlinks (note che puntano a una nota), list_note_tags e search_by_tag (gli #hashtag del vault e le note che li usano) e add_task (crea un'attività con data di scadenza/tag, accetta linguaggio naturale nel titolo).
  • Git: git_status, git_log, git_diff e git_restore.
  • Web e avvisi: http_request (lancia una richiesta HTTP e restituisce stato/intestazioni/corpo) e notify (mostra una notifica nel tray sulla finestra aperta — comodo perché l'agente segnali di aver finito).
  • Proxy IA: list_ai_models e ask_ai (di seguito).

Il server espone anche i file dello spazio di lavoro come risorse MCP (resources/list e resources/read), per i client che preferiscono "allegare" i file invece di chiamare read_file.

La tua Libreria di prompt (la cartella Prompts/ dello spazio) è esposta come prompt MCP (prompts/list e prompts/get). In Claude Code ogni prompt diventa un comando slash — /mcp__lightnote__<nome> — pronto all'uso nella CLI di IA.

Rete di sicurezza delle scritture. Prima di sovrascrivere (write_file/edit_file) o rimuovere (delete_file) un file, il server salva la versione precedente nella Cronologia locale — la rete di sicurezza dell'editor —, così puoi annullare una modifica fatta da un agente anche fuori da un repository Git.

Ogni strumento dichiara se legge o scrive: oltre alle annotazioni MCP (readOnlyHint/destructiveHint), la descrizione inizia con un badge [read-only], [writes] o [destructive] — comodo per costruire allowlist in modo sicuro.

Proxy IA (delega a un altro modello)

I provider API che hai registrato con la colonna MCP spuntata sono esposti all'agente tramite due strumenti: list_ai_models (elenca i modelli consentiti, con id, nome e modello) e ask_ai ({model, prompt}). Questo permette all'agente principale di delegare un sotto-compito a un modello più economico o specializzato. La chiamata è intermediata dal LightNote in esecuzione (l'lnote.exe dell'MCP inoltra la richiesta alla finestra dell'app tramite il ponte interno): la chiave API non lascia mai la tua macchina e non raggiunge mai l'agente. Se LightNote non è aperto, lo strumento restituisce un errore chiedendo di aprirlo.

Riga di comando (lnote)

Le stesse operazioni MCP risiedono in un eseguibile console, lnote, per script e automazione (raggiungibile anche come lightnote cli <comando>). Ogni azione è confinata alla cartella radice, impostata da --root (predefinito: la cartella corrente).

Esempi:

lnote list --recursive
lnote read --path src/main.cpp --start-line 1 --end-line 40
lnote write --path note.md --content "Hello"
echo content | lnote write --path note.md --content -
lnote search --query TODO --regex
lnote query --sql "SELECT * FROM read_parquet('data.parquet') LIMIT 10"
lnote describe --path data.parquet
lnote search-notes --query "dove ho scritto del budget"
lnote audit-links
lnote xlsx-read --path foglio.xlsx --sheet 0
lnote data-diff --a prima.parquet --b dopo.parquet --mode changed --keys id
lnote db-describe --connection dati.lnc --table clienti
lnote db-export --connection dados.lnc --sql "SELECT * FROM clientes" --out clientes.parquet
lnote due-tasks
lnote export --sql "SELECT * FROM read_csv_auto('e.csv') WHERE state='NY'" --out ny.parquet
lnote zip-list --path export.isx
lnote zip-read --path export.isx --entry job/definition.xml
lnote task-projects
lnote tasks --project Backlog
lnote create-task --project Backlog --title "Review the text" --effort 2
lnote move-task --project Backlog --task-id 5 --status-id 2
lnote git-status
lnote http --url https://api.example.com --method GET
lnote notify --message "Processing finished"

Opzioni globali: --root <cartella>, --json (output strutturato {ok,data,error}), --help (o lnote <comando> --help) e --version. I comandi sconosciuti ricevono un suggerimento ("forse intendevi…?").

Aggiornare dati vecchi in blocco: lnote upgrade <cartella> ammoderna in un colpo solo i file scritti da versioni precedenti di LightNote: oggi le estensioni legacy .lnsh e .lnsm, diventate .lns e .lne. L'applicazione lo fa già da sola quando apri ciascun file; il comando serve a chi ne ha decine e non vuole aprirli uno per uno. Usa --dry-run per vedere cosa cambierebbe senza toccare nulla. È una comodità, non un obbligo: i file vecchi continuano ad aprirsi anche senza.

Impostazioni e temi

In Strumenti → Impostazioni generali regoli, in sezioni: le opzioni Generale (lingua, salvataggio automatico, rilascio schede inattive, tavolozza colori delle schede, titolo della finestra, note giornaliere, correzione ortografica), il Tema dell'applicazione, il carattere e i colori dell'Editor, lo stile Markdown, l'Esecuzione (interpreti), il Terminale (shell), gli Assistenti IA (CLI e l'IA predefinita), il Versionamento e il Database (paginazione, Oracle Instant Client).

In cima all'elenco delle sezioni c'è un campo di ricerca che filtra in base alle opzioni di ogni pagina; e la sezione Funzionalità raccoglie gli interruttori delle funzioni opzionali — grafo delle connessioni, note adesive, sessioni IA, Chat IA, registrazione audio, ritrovare le note vecchie, mantieni il computer sveglio e l'integrazione nel menu di Esplora file di Windows. Disattivare una funzionalità la rimuove dall'interfaccia, dal tray e dalle scorciatoie, e smette di consumare risorse — ma conserva i dati già creati; la modifica ha effetto al riavvio.

Il tema dell'applicazione cambia l'aspetto del programma (menu, schede, pannelli, barra di stato). Ci sono diversi temi già pronti — chiari (Light, Solarized Light, Catppuccin Latte, Gruvbox Light, One Light, Rosé Pine Dawn) e scuri (Dark, Tokyo Night, Dracula, Ayu Mirage, Nord, Gruvbox Dark) — oltre alla modalità Personalizzato con un colore d'accento. I nuovi temi arrivano tramite il catalogo online, senza dover aggiornare l'applicazione.

I colori dell'Editor di codice e del Markdown si scelgono separatamente, nelle rispettive sezioni, indipendentemente dal tema dell'applicazione. Ognuno ha un menu a tendina Tema: con schemi di colore già pronti (Default, Dracula, One, Nord, Gruvbox e Tokyo Night, in varianti chiara e scura), un'anteprima dal vivo e un pulsante Salva come… per memorizzare i tuoi colori come preset riutilizzabile.

Tema per finestra. Ogni cartella (spazio di lavoro) può avere un proprio tema, così puoi tenere due finestre aperte con aspetti diversi contemporaneamente. In Impostazioni dello spazio di lavoro → Aspetto di questa cartella ci sono menu a tendina per il tema di questa finestra (l'aspetto dell'applicazione), il tema del codice e il tema del Markdown — ognuno con un'opzione Segui tema generale/ Mantieni predefinito per lasciarlo invariato. Sovrascrivere i temi del codice e del Markdown è comodo per far combaciare i colori dell'editor con un tema scuro solo in quella cartella, senza toccare le Impostazioni generali. Queste scelte restano sulla tua macchina (non vengono inviate a Git).

Guida all'installazione. Quando scegli uno strumento del catalogo (assistente IA, interprete, formattatore, linter o driver di database) che non è ancora sul computer — o provi a eseguire/formattare/verificare un file il cui interprete manca — LightNote apre una guida all'installazione. Quando esiste un comando sicuro (tramite winget), la guida mostra il comando esatto e lo esegue in una console integrata, con un clic; se lo strumento dipende da un altro (ad esempio, una CLI che richiede Node.js), offre di installare prima il prerequisito. Senza un programma di installazione automatico, la guida apre la pagina di download ufficiale con istruzioni passo passo. Al termine, verifica l'installazione e rende lo strumento pronto all'uso, senza riavviare il programma.

La Formattazione e i Linter hanno sezioni proprie (formattatore/linter esterno per linguaggio, con Aggiungi da un catalogo). Per portare le tue preferenze su un'altra macchina, il gruppo Migrazione impostazioni (sezione Generale) ha Esporta/ Importa impostazioni (un file .lnconf): le opzioni generali e i temi dei contenuti vengono trasferiti, ma non le chiavi API o i percorsi locali (da reinserire sulla destinazione).

Il titolo della finestra è un template libero: il nome dell'app compare sempre alla fine e componi il resto con le variabili {workspace} (cartella radice dello spazio di lavoro), {file} (nome del file aperto) e {path} (percorso completo). Le decorazioni attorno a una variabile vuota (es. le parentesi in [ {workspace} ]) scompaiono da sole; lascia il campo vuoto per il valore predefinito [ {workspace} ] {file} — .

Layout della finestra. In Visualizza → Layout della finestra (o in Impostazioni generali → Generale → Layout della finestra) puoi scegliere fra tre preset — Moderno (predefinito), Classico e Confortevole — oppure regolare ogni opzione singolarmente: mostrare la barra dei menu in alto (quando è attiva il pulsante ☰ scompare, perché entrambi aprono gli stessi menu), mostrare le etichette accanto alle icone, mettere la barra degli strumenti e la barra laterale a sinistra o a destra, e la dimensione delle icone. Scegliere un preset si limita a compilare le opzioni: modificarne una in seguito non annulla nulla, l’elenco passa semplicemente a mostrare «(personalizzato)». La modifica ha effetto subito, in tutte le finestre aperte.

Scorciatoie da tastiera

  • F1 — questa guida (alla sezione della schermata corrente)
  • Ctrl+N / Ctrl+O — nuovo file / apri file
  • Ctrl+S / Ctrl+W — salva / chiudi scheda
  • Ctrl+Alt+Shift+S — salva tutto (ogni scheda modificata)
  • Ctrl+F / Ctrl+H — trova / sostituisci nel file
  • Ctrl+Shift+F — ricerca globale (ripgrep)
  • Ctrl+Shift+G — pannello di versionamento (Git)
  • Ctrl+Shift+E / Ctrl+Shift+M — pannello Esplora / pannello Elementi in sospeso
  • Ctrl+B — mostra/nascondi la barra laterale
  • Ctrl+' — terminale (sul layout US, anche Ctrl+`)
  • Ctrl+/ — commenta/decommenta; Ctrl+Shift+D — duplica riga
  • F5 — esegui file; Ctrl+Shift+Invio — invia la selezione al terminale
  • Ctrl+K / Ctrl+I — chiedi all'IA / modifica con l'IA
  • Ctrl+B / Ctrl+I / Ctrl+E — nella nota Markdown: grassetto / corsivo / cambiare la modalità di visualizzazione
  • Ctrl+Enter — “esegui qui”: istruzione SQL, cella di Blocchi, richiesta API
  • Ctrl+Shift+R / F4 — macro: registra / riproduci
  • Ctrl+P — vai al file; Ctrl+Shift+P — tavolozza comandi
  • Ctrl+Shift+K — vai all'attività; Ctrl+Shift+T — riapri scheda chiusa
  • Ctrl+Alt+G — grafo delle connessioni
  • Ctrl+Alt+N — cattura rapida (globale, anche fuori da LightNote)
  • Ctrl+Alt+D / Ctrl+Alt+T — nota di oggi / attività rapida
  • Ctrl+Alt+R — registra/ferma audio (globale, nota vocale rapida)
  • F11 — modalità Zen (la scheda occupa tutta la finestra)
  • Ctrl++ / Ctrl+- / Ctrl+0 — zoom

L'elenco completo e filtrabile si trova in Aiuto → Scorciatoie da tastiera.

Licenza, edizioni e comunità

LightNote viene distribuito in edizioni con le stesse funzionalità, che differiscono solo per licenza e distribuzione:

  • LightNote (gratuito, dal sito web): per uso personale, non commerciale.
  • LightNote Core (Microsoft Store): acquisito come contributo al progetto; concede una licenza per uso commerciale e riceve aggiornamenti automatici tramite lo Store.
  • LightNote Business (futuro): licenza per volumi/aziendale, riservata per una disponibilità futura.

L'edizione della tua copia — e quindi quali clausole si applicano — è mostrata in Aiuto → Informazioni. I termini completi sono in Aiuto → Informazioni → Termini di licenza…

Partecipa e contribuisci:

  • Suggerimenti e domande: GitHub Discussions — github.com/nglczr/LightNote-Community/discussions
  • Hai trovato un bug? Segnalalo su GitHub Issues — github.com/nglczr/LightNote-Community/issues
  • Sostieni lo sviluppo su Ko-fi — ko-fi.com/lightnote (oppure ottieni LightNote Core sullo Store)
  • Contatto: contato@lightnote.com.br · Sito web: lightnote.com.br