cc-viewer 1.2.1 → 1.2.2

package/concepts/it/Tool-Read.md

@@ -0,0 +1,41 @@
+# Read
+
+## Definizione
+
+Legge il contenuto di un file dal file system locale. Supporta file di testo, immagini, PDF e Jupyter notebook.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `file_path` | string | Sì | Percorso assoluto del file |
+| `offset` | number | No | Numero di riga iniziale (per la lettura segmentata di file grandi) |
+| `limit` | number | No | Numero di righe da leggere (per la lettura segmentata di file grandi) |
+| `pages` | string | No | Intervallo di pagine PDF (es. "1-5", "3", "10-20"), applicabile solo ai PDF |
+
+## Scenari d'uso
+
+**Adatto per:**
+- Leggere file di codice, file di configurazione e altri file di testo
+- Visualizzare file immagine (Claude è un modello multimodale)
+- Leggere documenti PDF
+- Leggere Jupyter notebook (restituisce tutte le celle con i relativi output)
+- Leggere più file in parallelo per ottenere contesto
+
+**Non adatto per:**
+- Leggere directory — usare il comando `ls` di Bash
+- Esplorazione aperta del codebase — usare Task (tipo Explore)
+
+## Note
+
+- Il percorso deve essere assoluto, non relativo
+- Per impostazione predefinita legge le prime 2000 righe del file
+- Le righe che superano i 2000 caratteri vengono troncate
+- L'output usa il formato `cat -n`, con numeri di riga a partire da 1
+- Per PDF grandi (oltre 10 pagine) è necessario specificare il parametro `pages`, massimo 20 pagine per volta
+- La lettura di un file inesistente restituisce un errore (non causa un crash)
+- È possibile chiamare più Read in parallelo in un singolo messaggio
+
+## Significato in cc-viewer
+
+Le chiamate Read appaiono nei log delle richieste come coppie di content block `tool_use` (chiamata) e `tool_result` (contenuto restituito). Il `tool_result` contiene il contenuto effettivo del file, utile per analizzare quali file il modello ha letto.

package/concepts/it/Tool-Skill.md

@@ -0,0 +1,35 @@
+# Skill
+
+## Definizione
+
+Esegue una skill (abilità) nella conversazione principale. Le skill sono capacità specializzate che l'utente può invocare tramite slash command (es. `/commit`, `/review-pr`).
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `skill` | string | Sì | Nome della skill (es. "commit", "review-pr", "pdf") |
+| `args` | string | No | Argomenti della skill |
+
+## Scenari d'uso
+
+**Adatto per:**
+- L'utente ha inserito uno slash command nel formato `/<skill-name>`
+- La richiesta dell'utente corrisponde alla funzionalità di una skill registrata
+
+**Non adatto per:**
+- Comandi CLI integrati (es. `/help`, `/clear`)
+- Una skill già in esecuzione
+- Nomi di skill non presenti nella lista delle skill disponibili
+
+## Note
+
+- Dopo l'invocazione, la skill viene espansa in un prompt completo
+- Supporta nomi completamente qualificati (es. `ms-office-suite:pdf`)
+- La lista delle skill disponibili è fornita nei messaggi system-reminder
+- Quando si vede un tag `<command-name>`, significa che la skill è stata caricata e va eseguita direttamente senza richiamare nuovamente questo strumento
+- Non menzionare una skill senza aver effettivamente invocato lo strumento
+
+## Significato in cc-viewer
+
+Le chiamate Skill appaiono nei log delle richieste come content block `tool_use`. Il prompt espanso dalla skill influenza il system prompt o il contenuto dei messaggi delle richieste successive.

package/concepts/it/Tool-Task.md

@@ -0,0 +1,53 @@
+# Task
+
+## Definizione
+
+Avvia un sub agent (SubAgent) per gestire autonomamente task complessi multi-step. I sub agent sono sottoprocessi indipendenti, ciascuno con il proprio set di strumenti e contesto dedicati.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `prompt` | string | Sì | Descrizione del task da eseguire per il sub agent |
+| `description` | string | Sì | Breve riepilogo di 3-5 parole |
+| `subagent_type` | string | Sì | Tipo di sub agent, determina il set di strumenti disponibili |
+| `model` | enum | No | Specifica il modello (sonnet / opus / haiku), predefinito ereditato dal padre |
+| `max_turns` | integer | No | Numero massimo di turni agentici |
+| `run_in_background` | boolean | No | Se eseguire in background; i task in background restituiscono il percorso output_file |
+| `resume` | string | No | ID dell'agent da riprendere, continua dall'ultima esecuzione |
+| `isolation` | enum | No | Modalità di isolamento, `worktree` crea un git worktree temporaneo |
+
+## Tipi di sub agent
+
+| Tipo | Scopo | Strumenti disponibili |
+|------|------|----------|
+| `Bash` | Esecuzione comandi, operazioni git | Bash |
+| `general-purpose` | Task multi-step generici | Tutti gli strumenti |
+| `Explore` | Esplorazione rapida del codebase | Tutti gli strumenti tranne Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `Plan` | Progettazione del piano di implementazione | Tutti gli strumenti tranne Task/Edit/Write/NotebookEdit/ExitPlanMode |
+| `claude-code-guide` | Q&A sulla guida all'uso di Claude Code | Glob, Grep, Read, WebFetch, WebSearch |
+| `statusline-setup` | Configurazione della barra di stato | Read, Edit |
+
+## Scenari d'uso
+
+**Adatto per:**
+- Task complessi che richiedono il completamento autonomo in più step
+- Esplorazione del codebase e ricerca approfondita (usando il tipo Explore)
+- Lavoro parallelo che richiede ambienti isolati
+- Task a lunga esecuzione che devono essere eseguiti in background
+
+**Non adatto per:**
+- Leggere un percorso file specifico — usare direttamente Read o Glob
+- Cercare in 2-3 file noti — usare direttamente Read
+- Cercare una definizione di classe specifica — usare direttamente Glob
+
+## Note
+
+- Al completamento, il sub agent restituisce un singolo messaggio; il suo risultato non è visibile all'utente e deve essere riportato dall'agent principale
+- È possibile lanciare più chiamate Task in parallelo in un singolo messaggio per migliorare l'efficienza
+- I task in background vengono monitorati tramite lo strumento TaskOutput
+- Il tipo Explore è più lento delle chiamate dirette a Glob/Grep, usarlo solo quando la ricerca semplice non è sufficiente
+
+## Significato in cc-viewer
+
+Le chiamate Task generano catene di richieste SubAgent, visibili nella lista delle richieste come sequenze di sotto-richieste indipendenti dal MainAgent. Le richieste SubAgent hanno tipicamente un system prompt semplificato e meno definizioni di strumenti, in netto contrasto con il MainAgent.

package/concepts/it/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## Definizione
+
+Crea una voce strutturata nella lista dei task, per tracciare i progressi, organizzare task complessi e mostrare all'utente l'avanzamento del lavoro.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `subject` | string | Sì | Breve titolo del task, in forma imperativa (es. "Fix authentication bug") |
+| `description` | string | Sì | Descrizione dettagliata, inclusi contesto e criteri di accettazione |
+| `activeForm` | string | No | Testo al presente progressivo mostrato durante l'esecuzione (es. "Fixing authentication bug") |
+| `metadata` | object | No | Metadati arbitrari allegati al task |
+
+## Scenari d'uso
+
+**Adatto per:**
+- Task complessi multi-step (più di 3 step)
+- L'utente ha fornito più elementi da fare
+- Tracciamento del lavoro in modalità pianificazione
+- L'utente richiede esplicitamente l'uso di una lista todo
+
+**Non adatto per:**
+- Un singolo task semplice
+- Operazioni semplici con meno di 3 step
+- Conversazioni pure o richieste informative
+
+## Note
+
+- Tutti i task appena creati hanno stato iniziale `pending`
+- `subject` usa la forma imperativa ("Run tests"), `activeForm` usa il presente progressivo ("Running tests")
+- Dopo la creazione, è possibile impostare le dipendenze (blocks/blockedBy) tramite TaskUpdate
+- Prima di creare, verificare con TaskList se esistono task duplicati
+
+## Significato in cc-viewer
+
+TaskCreate è un'operazione interna di gestione dei task di Claude Code, non genera richieste API indipendenti. Tuttavia, nella Chat Mode è possibile vedere il content block tool_use in cui il modello invoca questo strumento.

package/concepts/it/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## Definizione
+
+Ottiene i dettagli completi di un task tramite il suo ID.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `taskId` | string | Sì | ID del task da ottenere |
+
+## Contenuto restituito
+
+- `subject` — Titolo del task
+- `description` — Requisiti dettagliati e contesto
+- `status` — Stato: `pending`, `in_progress` o `completed`
+- `blocks` — Lista dei task bloccati da questo task
+- `blockedBy` — Lista dei task prerequisiti che bloccano questo task
+
+## Scenari d'uso
+
+**Adatto per:**
+- Ottenere la descrizione completa e il contesto di un task prima di iniziare il lavoro
+- Comprendere le dipendenze del task
+- Ottenere i requisiti completi dopo essere stati assegnati a un task
+
+## Note
+
+- Dopo aver ottenuto il task, verificare che la lista `blockedBy` sia vuota prima di iniziare il lavoro
+- Usare TaskList per visualizzare il riepilogo di tutti i task
+
+## Significato in cc-viewer
+
+TaskGet è un'operazione interna di gestione dei task, non genera richieste API indipendenti.

package/concepts/it/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## Definizione
+
+Elenca tutti i task nella lista dei task, per visualizzare i progressi complessivi e il lavoro disponibile.
+
+## Parametri
+
+Nessun parametro.
+
+## Contenuto restituito
+
+Informazioni di riepilogo per ogni task:
+- `id` — Identificatore del task
+- `subject` — Breve descrizione
+- `status` — Stato: `pending`, `in_progress` o `completed`
+- `owner` — Responsabile (agent ID), vuoto se non assegnato
+- `blockedBy` — Lista degli ID dei task non completati che bloccano questo task
+
+## Scenari d'uso
+
+**Adatto per:**
+- Vedere quali task sono disponibili (stato pending, senza owner, non bloccati)
+- Controllare i progressi complessivi del progetto
+- Trovare task bloccati
+- Trovare il prossimo task dopo averne completato uno
+
+## Note
+
+- Elaborare i task preferibilmente in ordine di ID (ID più basso per primo), poiché i task precedenti forniscono tipicamente contesto per quelli successivi
+- I task con `blockedBy` non possono essere presi in carico finché le dipendenze non sono risolte
+- Usare TaskGet per ottenere i dettagli completi di un task specifico
+
+## Significato in cc-viewer
+
+TaskList è un'operazione interna di gestione dei task, non genera richieste API indipendenti.

package/concepts/it/Tool-TaskOutput.md

@@ -0,0 +1,34 @@
+# TaskOutput
+
+## Definizione
+
+Ottiene l'output di un task in background in esecuzione o completato. Applicabile a shell in background, agent asincroni e sessioni remote.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `task_id` | string | Sì | ID del task |
+| `block` | boolean | Sì | Se attendere in modo bloccante il completamento del task, predefinito `true` |
+| `timeout` | number | Sì | Tempo massimo di attesa (millisecondi), predefinito 30000, massimo 600000 |
+
+## Scenari d'uso
+
+**Adatto per:**
+- Controllare i progressi di un agent in background avviato tramite Task (`run_in_background: true`)
+- Ottenere i risultati dell'esecuzione di comandi Bash in background
+- Attendere il completamento di un task asincrono e ottenerne l'output
+
+**Non adatto per:**
+- Task in primo piano — i task in primo piano restituiscono direttamente i risultati, questo strumento non è necessario
+
+## Note
+
+- `block: true` blocca fino al completamento del task o al timeout
+- `block: false` per un controllo non bloccante dello stato corrente
+- L'ID del task può essere trovato tramite il comando `/tasks`
+- Applicabile a tutti i tipi di task: shell in background, agent asincroni, sessioni remote
+
+## Significato in cc-viewer
+
+La chiamata TaskOutput non genera richieste API, è un'operazione interna di gestione dei task di Claude Code e non appare nei log delle richieste.

package/concepts/it/Tool-TaskStop.md

@@ -0,0 +1,27 @@
+# TaskStop
+
+## Definizione
+
+Ferma un task in background in esecuzione.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `task_id` | string | No | ID del task in background da fermare |
+| `shell_id` | string | No | Deprecato, usare `task_id` al suo posto |
+
+## Scenari d'uso
+
+**Adatto per:**
+- Terminare task a lunga esecuzione non più necessari
+- Annullare task in background avviati per errore
+
+## Note
+
+- Restituisce uno stato di successo o fallimento
+- Il parametro `shell_id` è deprecato, usare `task_id`
+
+## Significato in cc-viewer
+
+La chiamata TaskStop non genera richieste API, è un'operazione interna di gestione dei task di Claude Code.

package/concepts/it/Tool-TaskUpdate.md

@@ -0,0 +1,49 @@
+# TaskUpdate
+
+## Definizione
+
+Aggiorna lo stato, il contenuto o le dipendenze di un task nella lista dei task.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `taskId` | string | Sì | ID del task da aggiornare |
+| `status` | enum | No | Nuovo stato: `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | No | Nuovo titolo |
+| `description` | string | No | Nuova descrizione |
+| `activeForm` | string | No | Testo al presente progressivo mostrato durante l'esecuzione |
+| `owner` | string | No | Nuovo responsabile del task (nome dell'agent) |
+| `metadata` | object | No | Metadati da unire (impostare a null per eliminare una chiave) |
+| `addBlocks` | string[] | No | Lista degli ID dei task bloccati da questo task |
+| `addBlockedBy` | string[] | No | Lista degli ID dei task prerequisiti che bloccano questo task |
+
+## Flusso degli stati
+
+```
+pending → in_progress → completed
+```
+
+`deleted` può essere raggiunto da qualsiasi stato e rimuove permanentemente il task.
+
+## Scenari d'uso
+
+**Adatto per:**
+- Contrassegnare un task come `in_progress` quando si inizia il lavoro
+- Contrassegnare un task come `completed` quando il lavoro è terminato
+- Impostare le dipendenze tra i task
+- Aggiornare il contenuto del task quando i requisiti cambiano
+
+**Regole importanti:**
+- Contrassegnare come `completed` solo quando il task è completamente terminato
+- In caso di errori o blocchi, mantenere `in_progress`
+- Non contrassegnare come `completed` in caso di test falliti, implementazione incompleta o errori non risolti
+
+## Note
+
+- Prima dell'aggiornamento, ottenere lo stato più recente del task tramite TaskGet per evitare dati obsoleti
+- Dopo aver completato un task, chiamare TaskList per trovare il prossimo task disponibile
+
+## Significato in cc-viewer
+
+TaskUpdate è un'operazione interna di gestione dei task, non genera richieste API indipendenti.

package/concepts/it/Tool-WebFetch.md

@@ -0,0 +1,36 @@
+# WebFetch
+
+## Definizione
+
+Recupera il contenuto di una pagina web dall'URL specificato, converte l'HTML in markdown e lo elabora con un modello AI in base al prompt.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `url` | string (URI) | Sì | URL completo da recuperare |
+| `prompt` | string | Sì | Descrive quali informazioni estrarre dalla pagina |
+
+## Scenari d'uso
+
+**Adatto per:**
+- Ottenere il contenuto di pagine web pubbliche
+- Consultare documentazione online
+- Estrarre informazioni specifiche da una pagina web
+
+**Non adatto per:**
+- URL che richiedono autenticazione (Google Docs, Confluence, Jira, GitHub, ecc.) — cercare prima uno strumento MCP dedicato
+- URL di GitHub — preferire l'uso della CLI `gh`
+
+## Note
+
+- L'URL deve essere un URL valido e completo
+- HTTP viene automaticamente aggiornato a HTTPS
+- I risultati possono essere riassunti se il contenuto è troppo grande
+- Include una cache auto-pulente di 15 minuti
+- Quando l'URL reindirizza a un host diverso, lo strumento restituisce l'URL di reindirizzamento e occorre effettuare una nuova richiesta con il nuovo URL
+- Se è disponibile uno strumento web fetch fornito da MCP, preferire quello
+
+## Significato in cc-viewer
+
+Le chiamate WebFetch appaiono nei log delle richieste come coppie di content block `tool_use` / `tool_result`. Il `tool_result` contiene il riepilogo del contenuto web elaborato dall'AI.

package/concepts/it/Tool-WebSearch.md

@@ -0,0 +1,32 @@
+# WebSearch
+
+## Definizione
+
+Esegue una query su motore di ricerca, restituendo risultati di ricerca per ottenere informazioni aggiornate.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `query` | string | Sì | Query di ricerca (minimo 2 caratteri) |
+| `allowed_domains` | string[] | No | Includi solo risultati da questi domini |
+| `blocked_domains` | string[] | No | Escludi risultati da questi domini |
+
+## Scenari d'uso
+
+**Adatto per:**
+- Ottenere informazioni aggiornate oltre la data di cutoff della conoscenza del modello
+- Cercare eventi attuali e dati recenti
+- Cercare la documentazione tecnica più recente
+
+## Note
+
+- I risultati di ricerca vengono restituiti in formato hyperlink markdown
+- Dopo l'uso, è obbligatorio aggiungere una sezione "Sources:" alla fine della risposta, elencando gli URL pertinenti
+- Supporta il filtro per dominio (inclusione/esclusione)
+- Usare l'anno corrente nelle query di ricerca
+- Disponibile solo negli Stati Uniti
+
+## Significato in cc-viewer
+
+Le chiamate WebSearch appaiono nei log delle richieste come coppie di content block `tool_use` / `tool_result`. Il `tool_result` contiene la lista dei risultati di ricerca.

package/concepts/it/Tool-Write.md

@@ -0,0 +1,32 @@
+# Write
+
+## Definizione
+
+Scrive contenuto nel file system locale. Se il file esiste già, viene sovrascritto.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `file_path` | string | Sì | Percorso assoluto del file (deve essere assoluto) |
+| `content` | string | Sì | Contenuto da scrivere |
+
+## Scenari d'uso
+
+**Adatto per:**
+- Creare nuovi file
+- Quando è necessario riscrivere completamente il contenuto di un file
+
+**Non adatto per:**
+- Modificare contenuto parziale di un file — usare Edit
+- Non creare proattivamente file di documentazione (*.md) o README, a meno che l'utente non lo richieda esplicitamente
+
+## Note
+
+- Se il file di destinazione esiste già, è necessario prima leggerlo tramite Read, altrimenti l'operazione fallisce
+- Sovrascrive l'intero contenuto del file esistente
+- Preferire Edit per modificare file esistenti, Write è solo per creare nuovi file o riscritture complete
+
+## Significato in cc-viewer
+
+Le chiamate Write appaiono nei log delle richieste come content block `tool_use`, il cui `input.content` contiene il contenuto completo scritto.

package/concepts/it/Tool-executeCode.md

@@ -0,0 +1,33 @@
+# executeCode (mcp__ide__executeCode)
+
+## Definizione
+
+Esegue codice Python nel kernel Jupyter del file notebook corrente.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `code` | string | Sì | Codice Python da eseguire |
+
+## Scenari d'uso
+
+**Adatto per:**
+- Eseguire codice in un ambiente Jupyter notebook
+- Testare frammenti di codice
+- Analisi dati e calcoli
+
+**Non adatto per:**
+- Esecuzione di codice in ambienti non Jupyter — usare Bash
+- Modificare file — usare Edit o Write
+
+## Note
+
+- Questo è uno strumento MCP (Model Context Protocol), fornito dall'integrazione IDE
+- Il codice viene eseguito nel kernel Jupyter corrente, lo stato persiste tra le chiamate
+- A meno che l'utente non lo richieda esplicitamente, evitare di dichiarare variabili o modificare lo stato del kernel
+- Lo stato viene perso dopo il riavvio del kernel
+
+## Significato in cc-viewer
+
+executeCode è uno strumento MCP, che appare nell'array `tools` dei log delle richieste con il nome `mcp__ide__executeCode`. Le sue chiamate e i risultati seguono il pattern standard `tool_use` / `tool_result`. L'aggiunta/rimozione di strumenti MCP causa modifiche all'array tools, che possono attivare la ricostruzione della cache.

package/concepts/it/Tool-getDiagnostics.md

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## Definizione
+
+Ottiene informazioni diagnostiche del linguaggio da VS Code, inclusi errori di sintassi, errori di tipo, avvisi lint, ecc.
+
+## Parametri
+
+| Parametro | Tipo | Obbligatorio | Descrizione |
+|------|------|------|------|
+| `uri` | string | No | URI del file. Se non fornito, ottiene le informazioni diagnostiche di tutti i file |
+
+## Scenari d'uso
+
+**Adatto per:**
+- Controllare problemi semantici del codice come sintassi, tipi, lint
+- Verificare se sono stati introdotti nuovi errori dopo la modifica del codice
+- Sostituire i comandi Bash per controllare la qualità del codice
+
+**Non adatto per:**
+- Eseguire test — usare Bash
+- Controllare errori a runtime — usare Bash per eseguire il codice
+
+## Note
+
+- Questo è uno strumento MCP (Model Context Protocol), fornito dall'integrazione IDE
+- Disponibile solo in ambienti VS Code / IDE
+- Preferire questo strumento rispetto ai comandi Bash per controllare i problemi del codice
+
+## Significato in cc-viewer
+
+getDiagnostics è uno strumento MCP, che appare nell'array `tools` dei log delle richieste con il nome `mcp__ide__getDiagnostics`. Le sue chiamate e i risultati seguono il pattern standard `tool_use` / `tool_result`. L'aggiunta/rimozione di strumenti MCP causa modifiche all'array tools, che possono attivare la ricostruzione della cache.

package/concepts/it/Tools.md

@@ -0,0 +1,73 @@
+# Panoramica degli strumenti di Claude Code
+
+Claude Code fornisce al modello un set di strumenti integrati tramite il meccanismo tool_use dell'API Anthropic. L'array `tools` di ogni richiesta MainAgent contiene le definizioni JSON Schema complete di questi strumenti, e il modello li invoca tramite content block `tool_use` nella risposta.
+
+Di seguito l'indice categorizzato di tutti gli strumenti.
+
+## Sistema Agent
+
+| Strumento | Scopo |
+|------|------|
+| [Task](Tool-Task.md) | Avvia un sub agent (SubAgent) per gestire task complessi multi-step |
+| [TaskOutput](Tool-TaskOutput.md) | Ottieni l'output di un task in background |
+| [TaskStop](Tool-TaskStop.md) | Ferma un task in background in esecuzione |
+| [TaskCreate](Tool-TaskCreate.md) | Crea una voce nella lista dei task strutturata |
+| [TaskGet](Tool-TaskGet.md) | Ottieni i dettagli di un task |
+| [TaskUpdate](Tool-TaskUpdate.md) | Aggiorna lo stato, le dipendenze, ecc. di un task |
+| [TaskList](Tool-TaskList.md) | Elenca tutti i task |
+
+## Operazioni sui file
+
+| Strumento | Scopo |
+|------|------|
+| [Read](Tool-Read.md) | Leggi il contenuto di un file (supporta testo, immagini, PDF, Jupyter notebook) |
+| [Edit](Tool-Edit.md) | Modifica un file tramite sostituzione esatta di stringhe |
+| [Write](Tool-Write.md) | Scrivi o sovrascrivi un file |
+| [NotebookEdit](Tool-NotebookEdit.md) | Modifica celle di Jupyter notebook |
+
+## Ricerca
+
+| Strumento | Scopo |
+|------|------|
+| [Glob](Tool-Glob.md) | Cerca file per pattern di nome file |
+| [Grep](Tool-Grep.md) | Ricerca nel contenuto dei file basata su ripgrep |
+
+## Terminale
+
+| Strumento | Scopo |
+|------|------|
+| [Bash](Tool-Bash.md) | Esegui comandi shell |
+
+## Web
+
+| Strumento | Scopo |
+|------|------|
+| [WebFetch](Tool-WebFetch.md) | Recupera contenuto web ed elaboralo con AI |
+| [WebSearch](Tool-WebSearch.md) | Query su motore di ricerca |
+
+## Pianificazione e interazione
+
+| Strumento | Scopo |
+|------|------|
+| [EnterPlanMode](Tool-EnterPlanMode.md) | Entra in modalità pianificazione per progettare un piano di implementazione |
+| [ExitPlanMode](Tool-ExitPlanMode.md) | Esci dalla modalità pianificazione e invia il piano per l'approvazione dell'utente |
+| [AskUserQuestion](Tool-AskUserQuestion.md) | Poni domande all'utente per ottenere chiarimenti o decisioni |
+
+## Estensioni
+
+| Strumento | Scopo |
+|------|------|
+| [Skill](Tool-Skill.md) | Esegui una skill (slash command) |
+
+## Integrazione IDE
+
+| Strumento | Scopo |
+|------|------|
+| [getDiagnostics](Tool-getDiagnostics.md) | Ottieni informazioni diagnostiche del linguaggio da VS Code |
+| [executeCode](Tool-executeCode.md) | Esegui codice nel kernel Jupyter |
+
+## Significato in cc-viewer
+
+Le chiamate agli strumenti sono uno dei dati osservabili più importanti nei log delle richieste di Claude Code. L'array `tools` di ogni richiesta MainAgent definisce il set di strumenti disponibili per il modello, mentre i content block `tool_use` / `tool_result` nella risposta registrano le chiamate effettive e i risultati. cc-viewer analizza questi dati per ricostruire la catena completa delle chiamate agli strumenti nella Chat Mode.
+
+Le modifiche alle definizioni degli strumenti (come l'aggiunta/rimozione di strumenti causata dalla connessione/disconnessione di un MCP server) attivano la ricostruzione della cache, vedi [CacheRebuild](CacheRebuild.md).

package/concepts/it/TranslateContextPollution.md

@@ -0,0 +1,46 @@
+# Inquinamento del contesto dell'API di traduzione
+
+## Contesto
+
+CC-Viewer include una funzionalità di traduzione integrata (`POST /api/translate`) basata sull'API Messages di Anthropic. Nell'implementazione iniziale, le richieste di traduzione riutilizzavano le credenziali di autenticazione memorizzate nella cache della sessione di Claude Code — inclusi gli header `x-api-key` e `authorization`. Questo ha causato un problema sottile ma grave: i risultati delle traduzioni restituivano frequentemente contenuti irrilevanti.
+
+## Causa principale
+
+### Differenza fondamentale tra i due metodi di autenticazione
+
+L'API di Anthropic supporta due metodi di autenticazione:
+
+| Metodo | Header | Origine tipica | Caratteristiche |
+|--------|--------|----------------|-----------------|
+| Chiave API | `x-api-key: sk-ant-...` | Variabile d'ambiente / Console | Senza stato, ogni richiesta è indipendente |
+| Token OAuth | `authorization: Bearer sessionToken` | Login con abbonamento Claude Code | Legato alla sessione, il server mantiene l'associazione del contesto |
+
+La differenza chiave: **le chiavi API sono senza stato (stateless)** — ogni richiesta è completamente indipendente; mentre **i token di sessione OAuth sono con stato (stateful)** — il server di Anthropic associa le richieste che utilizzano lo stesso token allo stesso contesto di sessione.
+
+### Catena di inquinamento
+
+Quando Claude Code utilizza il login OAuth tramite abbonamento, il flusso di autenticazione si presenta così:
+
+```
+Conversazione principale Claude Code ──(authorization: Bearer sessionToken)──→ Anthropic API
+                                                                                 ↑
+Richiesta di traduzione CC-Viewer ──(authorization: Bearer sessionToken)──→ Anthropic API
+```
+
+Poiché le richieste di traduzione riutilizzavano lo stesso token di sessione, il server di Anthropic poteva associare le richieste di traduzione al contesto della conversazione principale di Claude Code. Questo causa:
+
+1. **I risultati della traduzione sono influenzati dal contesto della conversazione principale**: Il prompt di sistema della richiesta di traduzione è "sei un traduttore", ma il contesto del server contiene ancora la cronologia della conversazione di Claude Code, potenzialmente interferendo con il modello
+2. **La conversazione principale viene disturbata dalle richieste di traduzione**: Il contenuto delle richieste di traduzione (frammenti di testo dell'interfaccia) può essere iniettato nel contesto della conversazione principale, causando deviazioni nelle risposte di Claude Code
+3. **Comportamento imprevedibile**: Poiché l'inquinamento del contesto è un comportamento lato server, il client non può rilevarlo né controllarlo
+
+## Lezioni apprese
+
+- **I token di sessione OAuth non sono "semplicemente un'altra chiave API"** — portano con sé lo stato lato server, riutilizzarli significa condividere il contesto
+- **Le chiamate interne ai servizi dovrebbero utilizzare un'autenticazione indipendente e senza stato** per evitare l'associazione con le sessioni utente
+
+## Riferimenti
+
+- [Anthropic API Authentication Docs](https://docs.anthropic.com/en/api/getting-started)
+- [Claude Code Authentication](https://support.claude.com/en/articles/12304248-managing-api-key-environment-variables-in-claude-code)
+- [Anthropic Bans Subscription OAuth in Third-Party Apps](https://winbuzzer.com/2026/02/19/anthropic-bans-claude-subscription-oauth-in-third-party-apps-xcxwbn/)
+- [Claude Code Authentication: API Keys, Subscriptions, and SSO](https://developertoolkit.ai/en/claude-code/quick-start/authentication/)