@neurocode-ai/web 1.18.8

package/src/content/docs/it/tui.mdx

@@ -0,0 +1,426 @@
+---
+title: TUI
+description: Usa l'interfaccia utente da terminale (TUI) di OpenCode.
+---
+
+import { Tabs, TabItem } from "@astrojs/starlight/components"
+
+OpenCode fornisce un'interfaccia interattiva da terminale (TUI) per lavorare sui tuoi progetti con un LLM.
+
+Eseguire OpenCode avvia la TUI per la directory corrente.
+
+```bash
+opencode
+```
+
+Oppure puoi avviarla per una specifica working directory.
+
+```bash
+opencode /path/to/project
+```
+
+Una volta nella TUI, puoi inviare un messaggio come prompt.
+
+```text
+Give me a quick summary of the codebase.
+```
+
+---
+
+## Riferimenti ai file
+
+Puoi riferirti ai file nei messaggi usando `@`. Questo esegue una ricerca fuzzy dei file nella working directory corrente.
+
+:::tip
+Puoi anche usare `@` per riferirti ai file nei messaggi.
+:::
+
+```text "@packages/functions/src/api/index.ts"
+How is auth handled in @packages/functions/src/api/index.ts?
+```
+
+Il contenuto del file viene aggiunto automaticamente alla conversazione.
+
+---
+
+## Comandi bash
+
+Inizia un messaggio con `!` per eseguire un comando shell.
+
+```bash frame="none"
+!ls -la
+```
+
+L'output del comando viene aggiunto alla conversazione come risultato di uno strumento.
+
+---
+
+## Comandi
+
+Quando usi la TUI di OpenCode, puoi digitare `/` seguito dal nome di un comando per eseguire rapidamente azioni. Per esempio:
+
+```bash frame="none"
+/help
+```
+
+Molti comandi hanno anche una scorciatoia da tastiera che usa `ctrl+x` come tasto leader (predefinito). [Scopri di più](/docs/keybinds).
+
+Ecco tutti i comandi slash disponibili:
+
+---
+
+### connetti
+
+Aggiunge un provider a OpenCode. Ti permette di selezionare tra i provider disponibili e aggiungere le relative chiavi API.
+
+```bash frame="none"
+/connect
+```
+
+---
+
+### compatta
+
+Compatta la sessione corrente. _Alias_: `/summarize`
+
+```bash frame="none"
+/compact
+```
+
+**Scorciatoia:** `ctrl+x c`
+
+---
+
+### dettagli
+
+Attiva/disattiva i dettagli di esecuzione degli strumenti.
+
+```bash frame="none"
+/details
+```
+
+**Scorciatoia:** `ctrl+x d`
+
+---
+
+### editor
+
+Apre un editor esterno per comporre messaggi. Usa l'editor impostato nella variabile d'ambiente `EDITOR`. [Scopri di più](#editor-setup).
+
+```bash frame="none"
+/editor
+```
+
+**Scorciatoia:** `ctrl+x e`
+
+---
+
+### esci
+
+Esce da OpenCode. _Alias_: `/quit`, `/q`
+
+```bash frame="none"
+/exit
+```
+
+**Scorciatoia:** `ctrl+x q`
+
+---
+
+### esporta
+
+Esporta la conversazione corrente in Markdown e la apre nell'editor predefinito. Usa l'editor impostato nella variabile d'ambiente `EDITOR`. [Scopri di più](#editor-setup).
+
+```bash frame="none"
+/export
+```
+
+**Scorciatoia:** `ctrl+x x`
+
+---
+
+### aiuto
+
+Mostra la finestra di aiuto.
+
+```bash frame="none"
+/help
+```
+
+**Scorciatoia:** `ctrl+x h`
+
+---
+
+### inizializza
+
+Crea o aggiorna il file `AGENTS.md`. [Scopri di più](/docs/rules).
+
+```bash frame="none"
+/init
+```
+
+**Scorciatoia:** `ctrl+x i`
+
+---
+
+### modelli
+
+Elenca i modelli disponibili.
+
+```bash frame="none"
+/models
+```
+
+**Scorciatoia:** `ctrl+x m`
+
+---
+
+### nuovo
+
+Avvia una nuova sessione. _Alias_: `/clear`
+
+```bash frame="none"
+/new
+```
+
+**Scorciatoia:** `ctrl+x n`
+
+---
+
+### rifai
+
+Rifai un messaggio precedentemente annullato. Disponibile solo dopo aver usato `/undo`.
+
+:::tip
+Vengono ripristinate anche eventuali modifiche ai file.
+:::
+
+Internamente usa Git per gestire le modifiche ai file. Quindi il progetto **deve essere un repository Git**.
+
+```bash frame="none"
+/redo
+```
+
+**Scorciatoia:** `ctrl+x r`
+
+---
+
+### sessioni
+
+Elenca e passa tra le sessioni. _Alias_: `/resume`, `/continue`
+
+```bash frame="none"
+/sessions
+```
+
+**Scorciatoia:** `ctrl+x l`
+
+---
+
+### condividi
+
+Condivide la sessione corrente. [Scopri di più](/docs/share).
+
+```bash frame="none"
+/share
+```
+
+**Scorciatoia:** `ctrl+x s`
+
+---
+
+### temi
+
+Elenca i temi disponibili.
+
+```bash frame="none"
+/themes
+```
+
+**Scorciatoia:** `ctrl+x t`
+
+---
+
+### ragionamento
+
+Attiva/disattiva la visibilità dei blocchi thinking/reasoning nella conversazione. Quando abilitato, puoi vedere il ragionamento del modello per i modelli che supportano extended thinking.
+
+:::note
+Questo comando controlla solo se i blocchi di thinking vengono **mostrati**: non abilita o disabilita le capacità di ragionamento del modello. Per cambiare le capacità di ragionamento effettive, usa `ctrl+t` per ciclare tra le varianti del modello.
+:::
+
+```bash frame="none"
+/thinking
+```
+
+---
+
+### annulla
+
+Annulla l'ultimo messaggio nella conversazione. Rimuove l'ultimo messaggio utente, tutte le risposte successive e qualsiasi modifica ai file.
+
+:::tip
+Vengono annullate anche eventuali modifiche ai file.
+:::
+
+Internamente usa Git per gestire le modifiche ai file. Quindi il progetto **deve essere un repository Git**.
+
+```bash frame="none"
+/undo
+```
+
+**Scorciatoia:** `ctrl+x u`
+
+---
+
+### annulla condivisione
+
+Annulla la condivisione della sessione corrente. [Scopri di più](/docs/share#un-sharing).
+
+```bash frame="none"
+/unshare
+```
+
+---
+
+## Configurazione dell'editor
+
+Sia `/editor` sia `/export` usano l'editor specificato nella variabile d'ambiente `EDITOR`.
+
+<Tabs>
+  <TabItem label="Linux/macOS">
+    ```bash
+    # Example for nano or vim
+    export EDITOR=nano
+    export EDITOR=vim
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    export EDITOR="code --wait"
+    ```
+
+    Per renderlo permanente, aggiungilo al profilo della shell;
+    `~/.bashrc`, `~/.zshrc`, ecc.
+
+  </TabItem>
+
+  <TabItem label="Windows (CMD)">
+    ```bash
+    set EDITOR=notepad
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    set EDITOR=code --wait
+    ```
+
+    Per renderlo permanente, usa **System Properties** > **Environment Variables**.
+
+  </TabItem>
+
+  <TabItem label="Windows (PowerShell)">
+    ```powershell
+    $env:EDITOR = "notepad"
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    $env:EDITOR = "code --wait"
+    ```
+
+    Per renderlo permanente, aggiungilo al profilo PowerShell.
+
+  </TabItem>
+</Tabs>
+
+Opzioni comuni per l'editor includono:
+
+- `code` - Visual Studio Code
+- `cursor` - Cursor
+- `windsurf` - Windsurf
+- `nvim` - Neovim editor
+- `vim` - Vim editor
+- `nano` - Nano editor
+- `notepad` - Windows Notepad
+- `subl` - Sublime Text
+
+:::note
+Alcuni editor come VS Code devono essere avviati con il flag `--wait`.
+:::
+
+Alcuni editor richiedono argomenti da riga di comando per funzionare in modalità bloccante. Il flag `--wait` fa sì che il processo dell'editor resti in attesa finché non viene chiuso.
+
+---
+
+## Configurazione
+
+Puoi personalizzare il comportamento della TUI tramite `tui.json` (o `tui.jsonc`).
+
+```json title="tui.json"
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "theme": "opencode",
+  "leader_timeout": 2000,
+  "keybinds": {
+    "leader": "ctrl+x",
+    "command_list": "ctrl+p"
+  },
+  "scroll_speed": 3,
+  "scroll_acceleration": {
+    "enabled": false
+  },
+  "diff_style": "auto",
+  "mouse": true,
+  "attention": {
+    "enabled": true,
+    "notifications": true,
+    "sound": true,
+    "volume": 0.4,
+    "sound_pack": "opencode.default",
+    "sounds": {
+      "error": "./sounds/error.mp3"
+    }
+  }
+}
+```
+
+Questo è separato da `opencode.json`, che configura il comportamento di server/runtime.
+
+`keybinds` viene unito ai valori predefiniti integrati, quindi devi configurare solo le scorciatoie che vuoi modificare.
+
+### Opzioni
+
+- `theme` - Imposta il tema della UI. [Scopri di più](/docs/themes).
+- `keybinds` - Personalizza le scorciatoie da tastiera. [Scopri di più](/docs/keybinds).
+- `leader_timeout` - Controlla per quanto tempo OpenCode attende dopo il leader key. Default: `2000`.
+- `scroll_acceleration.enabled` - Abilita l'accelerazione di scroll in stile macOS per uno scorrimento fluido e naturale. Quando abilitata, la velocità aumenta con gesture rapide e resta precisa con movimenti lenti. **Questa impostazione ha precedenza su `scroll_speed` e lo sovrascrive quando attiva.**
+- `scroll_speed` - Controlla la velocità di scorrimento della TUI quando usi i comandi di scroll (minimo: `0.001`, supporta valori decimali). Default: `3`. **Nota: viene ignorata se `scroll_acceleration.enabled` è impostato a `true`.**
+- `diff_style` - Controlla il rendering delle diff. `"auto"` si adatta alla larghezza del terminale, `"stacked"` mostra sempre un layout a colonna singola.
+- `mouse` - Abilita o disabilita la cattura del mouse nella TUI (default: `true`). Quando è disabilitata, il comportamento nativo del terminale per selezione e scorrimento con il mouse viene preservato.
+- `attention` - Configura notifiche desktop e suoni della TUI. Disabilitato per impostazione predefinita.
+
+Usa `OPENCODE_TUI_CONFIG` per caricare un path di configurazione TUI personalizzato.
+
+### Attention
+
+Attention permette alla TUI di avvisarti quando OpenCode aspetta una risposta, richiede l'approvazione di un permesso, incontra un errore di sessione o completa una sessione. Abilitala con `attention.enabled`; gli eventi integrati riproducono un suono quando si verificano. Le notifiche desktop vengono inviate solo quando la finestra del terminale non è in primo piano e non vengono usate per gli eventi subagent.
+
+- `enabled` - Abilita tutte le notifiche e i suoni di Attention. Default: `false`.
+- `notifications` - Quando Attention è abilitato, consente alla TUI di inviare notifiche desktop tramite il terminale. Default: `true`.
+- `sound` - Quando Attention è abilitato, consente di riprodurre suoni di avviso. Default: `true`.
+- `volume` - Volume predefinito dei suoni, da `0` a `1`. Default: `0.4`.
+- `sound_pack` - ID del sound pack da usare. Default: `opencode.default`.
+- `sounds` - Imposta file audio personalizzati per `default`, `question`, `permission`, `error`, `done` o `subagent_done`. I percorsi possono essere assoluti, URL `file://` o relativi a `tui.json`.
+
+---
+
+## Personalizzazione
+
+Puoi personalizzare vari aspetti della vista TUI usando la palette dei comandi (`ctrl+x h` o `/help`). Queste impostazioni persistono tra i riavvii.
+
+---
+
+#### Visualizzazione nome utente
+
+Attiva/disattiva se lo username appare nei messaggi della chat. Puoi farlo da:
+
+- Palette comandi: cerca "username" o "hide username"
+- L'impostazione viene salvata automaticamente e ricordata tra le sessioni TUI

package/src/content/docs/it/web.mdx

@@ -0,0 +1,142 @@
+---
+title: Web
+description: Usa OpenCode nel browser.
+---
+
+OpenCode puo funzionare come applicazione web nel browser, offrendo la stessa potente esperienza di coding AI senza bisogno di un terminale.
+
+![OpenCode Web - Nuova sessione](../../../assets/web/web-homepage-new-session.png)
+
+## Per iniziare
+
+Avvia l'interfaccia web eseguendo:
+
+```bash
+opencode web
+```
+
+Questo avvia un server locale su `127.0.0.1` con una porta disponibile scelta a caso e apre automaticamente OpenCode nel browser predefinito.
+
+:::caution
+Se `OPENCODE_SERVER_PASSWORD` non e impostata, il server non sara protetto. Va bene per l'uso locale, ma va impostata per l'accesso in rete.
+:::
+
+:::tip[Utenti Windows]
+Per la migliore esperienza, esegui `opencode web` da [WSL](/docs/windows-wsl) invece che da PowerShell. Questo garantisce accesso corretto al file system e integrazione col terminale.
+:::
+
+---
+
+## Configurazione
+
+Puoi configurare il server web con i flag della riga di comando o nel tuo [file di config](/docs/config).
+
+### Porta
+
+Per impostazione predefinita, OpenCode sceglie una porta disponibile. Puoi specificare una porta:
+
+```bash
+opencode web --port 4096
+```
+
+### Nome host
+
+Per impostazione predefinita, il server si lega a `127.0.0.1` (solo localhost). Per rendere OpenCode accessibile sulla rete:
+
+```bash
+opencode web --hostname 0.0.0.0
+```
+
+Usando `0.0.0.0`, OpenCode mostrera sia l'indirizzo locale sia quello di rete:
+
+```
+  Local access:       http://localhost:4096
+  Network access:     http://192.168.1.100:4096
+```
+
+### Scoperta mDNS
+
+Abilita mDNS per rendere il server individuabile sulla rete locale:
+
+```bash
+opencode web --mdns
+```
+
+Questo imposta automaticamente l'hostname a `0.0.0.0` e pubblicizza il server come `opencode.local`.
+
+Puoi personalizzare il nome di dominio mDNS per eseguire piu istanze sulla stessa rete:
+
+```bash
+opencode web --mdns --mdns-domain myproject.local
+```
+
+### CORS
+
+Per consentire domini aggiuntivi per CORS (utile per frontend personalizzati):
+
+```bash
+opencode web --cors https://example.com
+```
+
+### Autenticazione
+
+Per proteggere l'accesso, imposta una password usando la variabile d'ambiente `OPENCODE_SERVER_PASSWORD`:
+
+```bash
+OPENCODE_SERVER_PASSWORD=secret opencode web
+```
+
+Lo username predefinito e `opencode`, ma puo essere cambiato con `OPENCODE_SERVER_USERNAME`.
+
+---
+
+## Usa l'interfaccia web
+
+Una volta avviata, l'interfaccia web ti da accesso alle tue sessioni OpenCode.
+
+### Sessioni
+
+Visualizza e gestisci le sessioni dalla homepage. Puoi vedere le sessioni attive e avviarne di nuove.
+
+![OpenCode Web - Sessione attiva](../../../assets/web/web-homepage-active-session.png)
+
+### Stato del server
+
+Fai clic su "See Servers" per vedere i server connessi e il loro stato.
+
+![OpenCode Web - See Servers](../../../assets/web/web-homepage-see-servers.png)
+
+---
+
+## Collegare un terminale
+
+Puoi collegare una TUI da terminale a un server web gia in esecuzione:
+
+```bash
+# Avvia il web server
+opencode web --port 4096
+
+# In un altro terminale, collega la TUI
+opencode attach http://localhost:4096
+```
+
+Questo ti permette di usare contemporaneamente interfaccia web e terminale, condividendo le stesse sessioni e lo stesso stato.
+
+---
+
+## File di configurazione
+
+Puoi anche configurare le impostazioni del server nel file di config `opencode.json`:
+
+```json
+{
+  "server": {
+    "port": 4096,
+    "hostname": "0.0.0.0",
+    "mdns": true,
+    "cors": ["https://example.com"]
+  }
+}
+```
+
+I flag della riga di comando hanno precedenza sulle impostazioni del file di config.

package/src/content/docs/it/windows-wsl.mdx

@@ -0,0 +1,113 @@
+---
+title: Windows (WSL)
+description: Esegui OpenCode su Windows con WSL per la migliore esperienza.
+---
+
+import { Steps } from "@astrojs/starlight/components"
+
+Anche se OpenCode puo essere eseguito direttamente su Windows, consigliamo di usare [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) per la migliore esperienza. WSL fornisce un ambiente Linux che funziona in modo ottimale con le funzionalita di OpenCode.
+
+:::tip[Perche WSL?]
+WSL offre prestazioni migliori del file system, supporto completo del terminale e compatibilita con gli strumenti di sviluppo su cui OpenCode fa affidamento.
+:::
+
+---
+
+## Configurazione
+
+<Steps>
+
+1. **Installa WSL**
+
+   Se non l'hai ancora fatto, [installa WSL](https://learn.microsoft.com/en-us/windows/wsl/install) seguendo la guida ufficiale Microsoft.
+
+2. **Installa OpenCode in WSL**
+
+   Dopo aver configurato WSL, apri il terminale WSL e installa OpenCode usando uno dei [metodi di installazione](/docs/).
+
+   ```bash
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+
+3. **Usa OpenCode da WSL**
+
+   Vai nella directory del progetto (accedi ai file Windows tramite `/mnt/c/`, `/mnt/d/`, ecc.) ed esegui OpenCode.
+
+   ```bash
+   cd /mnt/c/Users/YourName/project
+   opencode
+   ```
+
+</Steps>
+
+---
+
+## App desktop + server WSL
+
+Se preferisci usare l'app desktop di OpenCode ma vuoi eseguire il server in WSL:
+
+1. **Avvia il server in WSL** con `--hostname 0.0.0.0` per consentire connessioni esterne:
+
+   ```bash
+   opencode serve --hostname 0.0.0.0 --port 4096
+   ```
+
+2. **Collega l'app desktop** a `http://localhost:4096`
+
+:::note
+Se `localhost` non funziona nella tua configurazione, usa l'indirizzo IP di WSL (da WSL: `hostname -I`) e collega `http://<wsl-ip>:4096`.
+:::
+
+:::caution
+Quando usi `--hostname 0.0.0.0`, imposta `OPENCODE_SERVER_PASSWORD` per proteggere il server.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
+```
+
+:::
+
+---
+
+## Client web + WSL
+
+Per la migliore esperienza web su Windows:
+
+1. **Esegui `opencode web` nel terminale WSL** invece che in PowerShell:
+
+   ```bash
+   opencode web --hostname 0.0.0.0
+   ```
+
+2. **Accedi dal browser Windows** su `http://localhost:<port>` (OpenCode stampa l'URL)
+
+Eseguire `opencode web` da WSL garantisce accesso corretto al file system e integrazione del terminale, restando comunque accessibile dal browser Windows.
+
+---
+
+## Accesso ai file Windows
+
+WSL puo accedere a tutti i file Windows tramite la directory `/mnt/`:
+
+- Unita `C:` → `/mnt/c/`
+- Unita `D:` → `/mnt/d/`
+- E cosi via...
+
+Esempio:
+
+```bash
+cd /mnt/c/Users/YourName/Documents/project
+opencode
+```
+
+:::tip
+Per un'esperienza piu fluida, valuta di clonare o copiare il repository nel file system di WSL (per esempio in `~/code/`) ed eseguire OpenCode li.
+:::
+
+---
+
+## Suggerimenti
+
+- Tieni OpenCode in esecuzione su WSL per i progetti salvati su unita Windows: l'accesso ai file e immediato
+- Usa l'[estensione WSL di VS Code](https://code.visualstudio.com/docs/remote/wsl) insieme a OpenCode per un flusso di lavoro integrato
+- Configurazione e sessioni di OpenCode sono salvate nell'ambiente WSL in `~/.local/share/opencode/`