Usage Guide

La tua prima guida all'uso

Dall'installazione alla cattura e al ripristino,
spieghiamo le operazioni di base di ThreadKeeper
con una guida dettagliata di ogni schermata.

Indice
  1. Installazione e primo avvio
  2. Panoramica della schermata principale
  3. Catturare una sessione
  4. Verifica del riepilogo IA e note
  5. Panoramica dell'elenco sessioni
  6. Ripristinare una sessione
  7. Cosa puoi fare nelle impostazioni
  8. Elenco scorciatoie
  9. Suggerimenti utili

1Installazione e primo avvio

Disponibile per Windows e macOS.
Basta scaricare e installare. Non servono conoscenze particolari.

Per Windows

  1. Scarica ThreadKeeper.Setup.0.1.0.exe dalla pagina principale
  2. Fai doppio clic sul file exe scaricato per eseguirlo
  3. Segui le istruzioni sullo schermo per completare l'installazione
  4. Avvia ThreadKeeper dal desktop o dal menu Start

Se appare l'avviso SmartScreen:
Clicca su "Ulteriori informazioni" → "Esegui comunque".
L'avviso appare perché non è stato ottenuto un certificato di firma del codice,
ma puoi utilizzarlo in sicurezza.

Per macOS

  1. Scarica ThreadKeeper-0.1.0.dmg dalla pagina principale
  2. Apri il file dmg scaricato e trascina ThreadKeeper nella cartella Applicazioni
  3. Avvia ThreadKeeper dalla cartella Applicazioni o dal Launchpad

Se appare l'avviso "sviluppatore non identificato":
Vai su Impostazioni di Sistema → Privacy e Sicurezza → clicca su "Apri comunque".
L'avviso appare perché l'app non è firmata con un certificato Apple,
ma puoi utilizzarla in sicurezza.

Cosa fare al primo avvio

Quando avvii ThreadKeeper per la prima volta,
ti verrà chiesto di configurare un provider IA.
Per utilizzare la funzione di riepilogo IA è necessario registrare una chiave API.

Se non hai ancora una chiave API:
Google Gemini offre un piano gratuito
e puoi iniziare subito.
→ Vedi la guida alla configurazione IA

Anche saltando la configurazione della chiave API
puoi utilizzare la cattura e il ripristino manuale.
Solo la funzione di riepilogo IA verrà disattivata.

2Panoramica della schermata principale

All'avvio viene visualizzata la finestra principale.
Da qui puoi eseguire tutte le operazioni.

ThreadKeeper
Elenco sessioni
Cattura
Impostazioni
Ricerca sulla progettazione API e conversazioni su Slack
2026/02/21 14:32 · Finestre x4 · Tab x8
Ripristina →
Refactoring dei componenti React
2026/02/21 10:15 · Finestre x6 · Tab x15
Ripristina →
Visione di video tutorial AWS su YouTube
2026/02/20 18:40 · Finestre x2 · Tab x5
Ripristina →

Elenco sessioni

Le sessioni catturate in passato
sono ordinate dalla più recente.
Il titolo riepilogato dall'IA, la data/ora
e il numero di finestre/tab registrati
sono visibili a colpo d'occhio.

Pulsante Cattura

Un clic registra immediatamente
lo stato attuale del PC.
Puoi farlo anche con la scorciatoia da tastiera.

Ripristina →

Pulsante all'estremità destra di ogni sessione.
Basta un clic per ripristinare
le app e i tab di quel momento.

Pulsante Impostazioni

Permette di cambiare il provider IA,
modificare le scorciatoie da tastiera
e gestire altre impostazioni.

3Catturare una sessione

Quando vuoi registrare lo stato attuale,
basta premere la scorciatoia.

Metodo di cattura

Puoi catturare con uno dei seguenti metodi.

Cattura completata
Contenuto scansionato
Finestre x5
Tab x12
Appunti
File recenti x3

Cosa viene registrato nella cattura

Suggerimento: puoi eseguire la cattura quante volte vuoi.
Registrando ad ogni interruzione del lavoro,
sarà più facile scegliere il punto a cui tornare.

4Verifica del riepilogo IA e note

Subito dopo la cattura, l'IA analizza il contenuto del lavoro.
Riassume automaticamente "cosa stavi facendo".

Verifica riepilogo IA
Riepilogo automatico dell'IA
"Sembra che stessi facendo ricerche sulla progettazione API con Gemini,
comunicando con i membri del team su Slack.
Avevi anche del codice di autenticazione aperto su VSCode."
Questo riepilogo è corretto?
Sì
Correggi
✎ Nota: la gestione degli errori di autenticazione non è completata. Continuare domani.

Cosa puoi fare in questa schermata

Se l'IA non è configurata:
non verrà generato alcun riepilogo e il titolo sarà
automaticamente nel formato "data/ora + numero finestre".
È comunque possibile inserire manualmente titolo e note.

5Panoramica dell'elenco sessioni

Spieghiamo il significato di ogni elemento
nell'elenco sessioni della schermata principale.

Dettagli sessione
Ricerca sulla progettazione API e conversazioni su Slack
2026/02/21 14:32
App aperte
VSCode
auth-handler.ts — ThreadKeeper
Slack
#dev-team — Slack
Chrome
8 tabs
Tab del browser
Gemini — API Design Best Practices
MDN — Fetch API
… altri 6
Note
La gestione degli errori di autenticazione non è completata. Continuare domani.
Ripristina →

Informazioni visualizzate nella scheda sessione

Cliccando sulla scheda sessione si espandono i dettagli
e puoi visualizzare l'elenco delle app e dei tab aperti.

6Ripristinare una sessione

Basta premere il pulsante di ripristino.
L'ambiente di lavoro di quel momento viene ripristinato esattamente com'era.

Procedura di ripristino

  1. Trova la sessione da ripristinare nell'elenco sessioni della schermata principale
  2. Clicca sul pulsante "Ripristina →"
  3. L'apertura delle app e la riapertura dei tab del browser vengono eseguite automaticamente

Cosa viene ripristinato

Limitazioni della versione attuale:
Il ripristino della posizione di scorrimento e delle dimensioni delle finestre non è supportato.
Il ripristino dei contenuti dei moduli del browser non è supportato.
Le applicazioni devono essere già installate.

Suggerimento: puoi ripetere il ripristino quante volte vuoi.
Non c'è problema a ripristinare la stessa sessione più volte.
Puoi anche usarlo come template
"voglio iniziare ogni mattina con questo ambiente".

7Cosa puoi fare nelle impostazioni

Dal pulsante "Impostazioni" nella schermata principale
puoi modificare le varie impostazioni.

Provider IA

Configura il provider IA
e la chiave API da utilizzare.
Compatibile con Gemini / OpenAI /
Anthropic / Ollama.

Modello IA

Puoi selezionare il modello da utilizzare
per ogni provider.
I modelli più leggeri rispondono più velocemente.

Scorciatoia da tastiera

Puoi modificare la scorciatoia di cattura
secondo le tue preferenze.
L'impostazione predefinita è Ctrl+Shift+S.

Posizione di salvataggio

Puoi verificare la posizione di salvataggio dei dati di sessione.
La posizione predefinita è
Windows: %APPDATA%\ThreadKeeper\
macOS: ~/Library/Application Support/ThreadKeeper/

Lingua

Cambia la lingua dell'app.
日本語 · English · Français · Italiano · 中文 (5 lingue).

Cambio di provider:
anche cambiando provider,
i dati delle sessioni precedenti vengono mantenuti.
Puoi cambiare liberamente in qualsiasi momento.

8Elenco scorciatoie

Scorciatoie da tastiera utili da ricordare.

Tasto Azione
Ctrl + Shift + S (Windows)
Cmd + Shift + S (macOS)		 Cattura sessione

Suggerimento: le scorciatoie possono essere modificate dalle impostazioni.
Se entrano in conflitto con altre app, personalizzale.

9Suggerimenti utili

Ecco alcuni suggerimenti
per sfruttare al meglio ThreadKeeper.

Cattura prima di uscire dall'ufficio

Se catturi alla fine della giornata,
la mattina dopo non dovrai più chiederti "cosa stavo facendo ieri?".
Il riepilogo dell'IA diventa un "appunto di passaggio di consegne da te stesso".

Cattura quando cambi attività

Quando arriva un'interruzione, cattura il lavoro attuale prima di occupartene.
Finita l'interruzione, con "Ripristina →"
torni all'ambiente di lavoro originale in un istante.

Usa le note

Lasciando una breve nota alla cattura come "prossimo passo: XX" o "YY in attesa di conferma",
al momento del ripristino potrai ricominciare subito.
Usale come promemoria per il te del futuro.

Funziona anche senza IA

Anche senza configurare una chiave API,
le funzioni base di cattura e ripristino funzionano.
Prova prima senza IA e,
se lo trovi utile, aggiungi il riepilogo IA in seguito.

Uso offline con Ollama

Se non vuoi inviare alcun dato all'esterno,
con Ollama puoi funzionare completamente offline.
Per i dettagli consulta la guida alla configurazione IA.