fix(docs): locale translations
This commit is contained in:
@@ -142,7 +142,7 @@ Se devi passare variabili d'ambiente (come `OPENCODE_API_KEY`), vedi [Configurin
|
||||
|
||||
## Support
|
||||
|
||||
OpenCode funziona via ACP come nel terminale. Tutte le funzionalita sono supportate:
|
||||
OpenCode funziona via ACP come nel terminal. Tutte le funzionalita sono supportate:
|
||||
|
||||
:::note
|
||||
Alcuni comandi slash integrati come `/undo` e `/redo` non sono attualmente supportati.
|
||||
|
||||
@@ -60,7 +60,7 @@ opencode agent [command]
|
||||
|
||||
### attach
|
||||
|
||||
Collega un terminale a un backend server di OpenCode gia' in esecuzione avviato tramite i comandi `serve` o `web`.
|
||||
Collega un terminal a un backend server di OpenCode gia' in esecuzione avviato tramite i comandi `serve` o `web`.
|
||||
|
||||
```bash
|
||||
opencode attach [url]
|
||||
@@ -562,7 +562,7 @@ OpenCode puo' essere configurato tramite variabili d'ambiente.
|
||||
| `OPENCODE_CONFIG_CONTENT` | string | Contenuto JSON di config inline |
|
||||
| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Disabilita i controlli automatici di aggiornamento |
|
||||
| `OPENCODE_DISABLE_PRUNE` | boolean | Disabilita la potatura dei dati vecchi |
|
||||
| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Disabilita aggiornamenti automatici del titolo terminale |
|
||||
| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Disabilita aggiornamenti automatici del titolo terminal |
|
||||
| `OPENCODE_PERMISSION` | string | Config permessi JSON inline |
|
||||
| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | Disabilita i plugin di default |
|
||||
| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | Disabilita download automatico dei server LSP |
|
||||
|
||||
@@ -169,7 +169,7 @@ Opzioni disponibili:
|
||||
|
||||
- `scroll_acceleration.enabled` - Abilita l'accelerazione di scorrimento in stile macOS. **Ha precedenza su `scroll_speed`.**
|
||||
- `scroll_speed` - Moltiplicatore personalizzato della velocita di scorrimento (predefinito: `3`, minimo: `1`). Ignorato se `scroll_acceleration.enabled` e `true`.
|
||||
- `diff_style` - Controlla la resa delle diff. `"auto"` si adatta alla larghezza del terminale, `"stacked"` mostra sempre una singola colonna.
|
||||
- `diff_style` - Controlla la resa delle diff. `"auto"` si adatta alla larghezza del terminal, `"stacked"` mostra sempre una singola colonna.
|
||||
|
||||
[Scopri di piu sull'uso della TUI](/docs/tui).
|
||||
|
||||
|
||||
@@ -7,13 +7,13 @@ Gli strumenti personalizzati sono funzioni che crei e che l'LLM puo chiamare dur
|
||||
|
||||
---
|
||||
|
||||
## Creating a tool
|
||||
## Crea uno strumento
|
||||
|
||||
Gli strumenti sono definiti come file **TypeScript** o **JavaScript**. Tuttavia, la definizione dello strumento puo invocare script scritti in **qualsiasi linguaggio**: TypeScript o JavaScript vengono usati solo per la definizione in se.
|
||||
|
||||
---
|
||||
|
||||
### Location
|
||||
### Posizione
|
||||
|
||||
Possono essere definiti:
|
||||
|
||||
@@ -22,7 +22,7 @@ Possono essere definiti:
|
||||
|
||||
---
|
||||
|
||||
### Structure
|
||||
### Struttura
|
||||
|
||||
Il modo piu semplice per creare strumenti e usare l'helper `tool()` che fornisce type-safety e validazione.
|
||||
|
||||
@@ -79,7 +79,7 @@ Questo crea due strumenti: `math_add` e `math_multiply`.
|
||||
|
||||
---
|
||||
|
||||
### Arguments
|
||||
### Argomenti
|
||||
|
||||
Puoi usare `tool.schema`, che e semplicemente [Zod](https://zod.dev), per definire i tipi degli argomenti.
|
||||
|
||||
@@ -108,7 +108,7 @@ export default {
|
||||
|
||||
---
|
||||
|
||||
### Context
|
||||
### Contesto
|
||||
|
||||
Gli strumenti ricevono un contesto sulla sessione corrente:
|
||||
|
||||
@@ -131,7 +131,7 @@ Usa `context.worktree` per la root del worktree git.
|
||||
|
||||
---
|
||||
|
||||
## Examples
|
||||
## Esempi
|
||||
|
||||
### Scrivi uno strumento in Python
|
||||
|
||||
|
||||
@@ -13,7 +13,7 @@ Puoi anche dare un'occhiata a [awesome-opencode](https://github.com/awesome-open
|
||||
|
||||
---
|
||||
|
||||
## Plugins
|
||||
## Plugin
|
||||
|
||||
| Nome | Descrizione |
|
||||
| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
|
||||
@@ -50,7 +50,7 @@ Puoi anche dare un'occhiata a [awesome-opencode](https://github.com/awesome-open
|
||||
|
||||
---
|
||||
|
||||
## Projects
|
||||
## Progetti
|
||||
|
||||
| Nome | Descrizione |
|
||||
| ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
|
||||
@@ -58,7 +58,7 @@ Puoi anche dare un'occhiata a [awesome-opencode](https://github.com/awesome-open
|
||||
| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Plugin Neovim per prompt consapevoli dell'editor, costruito sull'API |
|
||||
| [portal](https://github.com/hosenur/portal) | Web UI mobile-first per OpenCode su Tailscale/VPN |
|
||||
| [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/) | Template per costruire plugin OpenCode |
|
||||
| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Frontend Neovim per opencode: un agente di coding AI da terminale |
|
||||
| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Frontend Neovim per opencode: un agente di coding AI per terminal |
|
||||
| [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | Provider Vercel AI SDK per usare OpenCode tramite @opencode-ai/sdk |
|
||||
| [OpenChamber](https://github.com/btriapitsyn/openchamber) | App Web/Desktop ed estensione VS Code per OpenCode |
|
||||
| [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian) | Plugin Obsidian che integra OpenCode nella UI di Obsidian |
|
||||
@@ -68,7 +68,7 @@ Puoi anche dare un'occhiata a [awesome-opencode](https://github.com/awesome-open
|
||||
|
||||
---
|
||||
|
||||
## Agents
|
||||
## Agenti
|
||||
|
||||
| Nome | Descrizione |
|
||||
| ----------------------------------------------------------------- | --------------------------------------------------------- |
|
||||
|
||||
@@ -3,13 +3,13 @@ title: IDE
|
||||
description: L'estensione OpenCode per VS Code, Cursor e altri IDE
|
||||
---
|
||||
|
||||
OpenCode si integra con VS Code, Cursor o qualunque IDE che supporti un terminale. Basta eseguire `opencode` nel terminale per iniziare.
|
||||
OpenCode si integra con VS Code, Cursor o qualunque IDE che supporti un terminal. Basta eseguire `opencode` nel terminal per iniziare.
|
||||
|
||||
---
|
||||
|
||||
## Utilizzo
|
||||
|
||||
- **Avvio rapido**: usa `Cmd+Esc` (Mac) o `Ctrl+Esc` (Windows/Linux) per aprire OpenCode in una vista terminale divisa, oppure per mettere a fuoco una sessione esistente se e gia in esecuzione.
|
||||
- **Avvio rapido**: usa `Cmd+Esc` (Mac) o `Ctrl+Esc` (Windows/Linux) per aprire OpenCode in una vista terminal divisa, oppure per mettere a fuoco una sessione esistente se e gia in esecuzione.
|
||||
- **Nuova sessione**: usa `Cmd+Shift+Esc` (Mac) o `Ctrl+Shift+Esc` (Windows/Linux) per avviare una nuova sessione di OpenCode, anche se ne esiste gia una aperta. Puoi anche cliccare il pulsante OpenCode nell'interfaccia.
|
||||
- **Consapevolezza del contesto**: condividi automaticamente con OpenCode la selezione corrente o la scheda attiva.
|
||||
- **Scorciatoie per riferimenti file**: usa `Cmd+Option+K` (Mac) o `Alt+Ctrl+K` (Linux/Windows) per inserire riferimenti a file. Per esempio, `@File#L37-42`.
|
||||
@@ -21,7 +21,7 @@ OpenCode si integra con VS Code, Cursor o qualunque IDE che supporti un terminal
|
||||
Per installare OpenCode su VS Code e fork popolari come Cursor, Windsurf, VSCodium:
|
||||
|
||||
1. Apri VS Code
|
||||
2. Apri il terminale integrato
|
||||
2. Apri il terminal integrato
|
||||
3. Esegui `opencode` - l'estensione si installa automaticamente
|
||||
|
||||
Se invece vuoi usare il tuo IDE quando esegui `/editor` o `/export` dalla TUI, devi impostare `export EDITOR="code --wait"`. [Scopri di piu](/docs/tui/#editor-setup).
|
||||
@@ -38,7 +38,7 @@ Cerca **OpenCode** nel Marketplace delle estensioni e clicca **Install**.
|
||||
|
||||
Se l'estensione non si installa automaticamente:
|
||||
|
||||
- Assicurati di eseguire `opencode` nel terminale integrato.
|
||||
- Assicurati di eseguire `opencode` nel terminal integrato.
|
||||
- Verifica che la CLI del tuo IDE sia installata:
|
||||
- Per VS Code: comando `code`
|
||||
- Per Cursor: comando `cursor`
|
||||
|
||||
@@ -7,7 +7,7 @@ import { Tabs, TabItem } from "@astrojs/starlight/components"
|
||||
import config from "../../../../config.mjs"
|
||||
export const console = config.console
|
||||
|
||||
[**OpenCode**](/) e un agente di programmazione AI open source. E disponibile come interfaccia da terminale, app desktop o estensione per IDE.
|
||||
[**OpenCode**](/) e un agente di programmazione AI open source. E disponibile come interfaccia per terminal, app desktop o estensione per IDE.
|
||||
|
||||

|
||||
|
||||
@@ -17,9 +17,9 @@ Iniziamo.
|
||||
|
||||
#### Prerequisiti
|
||||
|
||||
Per usare OpenCode nel terminale, ti serve:
|
||||
Per usare OpenCode nel terminal, ti serve:
|
||||
|
||||
1. Un emulatore di terminale moderno, come:
|
||||
1. Un emulatore di terminal moderno, come:
|
||||
- [WezTerm](https://wezterm.org), cross-platform
|
||||
- [Alacritty](https://alacritty.org), cross-platform
|
||||
- [Ghostty](https://ghostty.org), Linux and macOS
|
||||
@@ -187,7 +187,7 @@ Questo aiuta OpenCode a capire la struttura del progetto e gli stili di codice u
|
||||
|
||||
---
|
||||
|
||||
## Usage
|
||||
## Utilizzo
|
||||
|
||||
Ora sei pronto a usare OpenCode sul tuo progetto. Sentiti libero di chiedergli qualsiasi cosa!
|
||||
|
||||
@@ -215,7 +215,7 @@ Questo e utile se c'e una parte della codebase su cui non hai lavorato.
|
||||
|
||||
Puoi chiedere a OpenCode di aggiungere nuove funzionalita al progetto. Pero ti consigliamo prima di chiedergli di creare un piano.
|
||||
|
||||
1. **Create a plan**
|
||||
1. **Crea un piano**
|
||||
|
||||
OpenCode ha una _Plan mode_ che disabilita la possibilita di fare modifiche e si limita a suggerire _come_ implementera la funzionalita.
|
||||
|
||||
@@ -239,7 +239,7 @@ Puoi chiedere a OpenCode di aggiungere nuove funzionalita al progetto. Pero ti c
|
||||
Dai a OpenCode molto contesto ed esempi per aiutarlo a capire cosa vuoi.
|
||||
:::
|
||||
|
||||
2. **Iterate on the plan**
|
||||
2. **Itera sul piano**
|
||||
|
||||
Una volta che ti da un piano, puoi dargli feedback o aggiungere piu dettagli.
|
||||
|
||||
@@ -249,12 +249,12 @@ Puoi chiedere a OpenCode di aggiungere nuove funzionalita al progetto. Pero ti c
|
||||
```
|
||||
|
||||
:::tip
|
||||
Trascina e rilascia le immagini nel terminale per aggiungerle al prompt.
|
||||
Trascina e rilascia le immagini nel terminal per aggiungerle al prompt.
|
||||
:::
|
||||
|
||||
OpenCode puo analizzare le immagini che gli dai e aggiungerle al prompt. Puoi farlo trascinando e rilasciando un'immagine nel terminale.
|
||||
OpenCode puo analizzare le immagini che gli dai e aggiungerle al prompt. Puoi farlo trascinando e rilasciando un'immagine nel terminal.
|
||||
|
||||
3. **Build the feature**
|
||||
3. **Implementa la funzionalita**
|
||||
|
||||
Quando ti senti a tuo agio con il piano, torna in _Build mode_ premendo di nuovo il tasto **Tab**.
|
||||
|
||||
|
||||
@@ -107,7 +107,7 @@ OpenCode ha una lista di scorciatoie che puoi personalizzare tramite la configur
|
||||
|
||||
## Tasto leader
|
||||
|
||||
OpenCode usa un tasto `leader` per la maggior parte delle scorciatoie. Questo evita conflitti nel terminale.
|
||||
OpenCode usa un tasto `leader` per la maggior parte delle scorciatoie. Questo evita conflitti nel terminal.
|
||||
|
||||
Per impostazione predefinita, `ctrl+x` e il tasto leader e la maggior parte delle azioni richiede di premere prima il leader e poi la scorciatoia. Per esempio, per avviare una nuova sessione premi `ctrl+x` e poi `n`.
|
||||
|
||||
@@ -154,7 +154,7 @@ Il campo di input del prompt nell'app desktop di OpenCode supporta scorciatoie c
|
||||
|
||||
## Shift+Enter
|
||||
|
||||
Alcuni terminali non inviano di default i tasti modificatori insieme a Invio. Potrebbe essere necessario configurare il terminale per inviare `Shift+Enter` come sequenza di escape.
|
||||
Alcuni terminal non inviano di default i tasti modificatori insieme a Invio. Potrebbe essere necessario configurare il terminal per inviare `Shift+Enter` come sequenza di escape.
|
||||
|
||||
### Windows Terminal
|
||||
|
||||
|
||||
@@ -259,7 +259,7 @@ export const EnvProtection = async ({ project, client, $, directory, worktree })
|
||||
|
||||
### Inietta variabili d'ambiente
|
||||
|
||||
Inietta variabili d'ambiente in tutte le esecuzioni di shell (strumenti AI e terminali utente):
|
||||
Inietta variabili d'ambiente in tutte le esecuzioni di shell (strumenti AI e terminal utente):
|
||||
|
||||
```javascript title=".opencode/plugins/inject-env.js"
|
||||
export const InjectEnvPlugin = async () => {
|
||||
|
||||
@@ -7,7 +7,7 @@ Puoi fornire istruzioni personalizzate a opencode creando un file `AGENTS.md`. E
|
||||
|
||||
---
|
||||
|
||||
## Initialize
|
||||
## Inizializza
|
||||
|
||||
Per creare un nuovo file `AGENTS.md`, puoi eseguire il comando `/init` in opencode.
|
||||
|
||||
@@ -21,7 +21,7 @@ Se hai gia' un file `AGENTS.md` esistente, cerchera' di aggiungervi contenuti.
|
||||
|
||||
---
|
||||
|
||||
## Example
|
||||
## Esempio
|
||||
|
||||
Puoi anche creare questo file manualmente. Ecco un esempio di alcune cose che puoi inserire in un file `AGENTS.md`.
|
||||
|
||||
@@ -52,27 +52,27 @@ Qui stiamo aggiungendo istruzioni specifiche del progetto e saranno condivise co
|
||||
|
||||
---
|
||||
|
||||
## Types
|
||||
## Tipi
|
||||
|
||||
opencode supporta anche la lettura del file `AGENTS.md` da piu' posizioni, e questo serve a scopi diversi.
|
||||
|
||||
### Project
|
||||
### Progetto
|
||||
|
||||
Metti un `AGENTS.md` nella root del progetto per regole specifiche del progetto. Si applicano solo quando stai lavorando in questa directory o nelle sue sottodirectory.
|
||||
|
||||
### Global
|
||||
### Globale
|
||||
|
||||
Puoi anche avere regole globali in un file `~/.config/opencode/AGENTS.md`. Queste si applicano a tutte le sessioni di opencode.
|
||||
|
||||
Dato che questo non viene committato in Git o condiviso con il team, consigliamo di usarlo per specificare regole personali che l'LLM deve seguire.
|
||||
|
||||
### Claude Code Compatibility
|
||||
### Compatibilita Claude Code
|
||||
|
||||
Per gli utenti che migrano da Claude Code, OpenCode supporta come fallback le convenzioni di file di Claude Code:
|
||||
|
||||
- **Project rules**: `CLAUDE.md` in your project directory (used if no `AGENTS.md` exists)
|
||||
- **Global rules**: `~/.claude/CLAUDE.md` (used if no `~/.config/opencode/AGENTS.md` exists)
|
||||
- **Skills**: `~/.claude/skills/` — see [Agent Skills](/docs/skills/) for details
|
||||
- **Regole di progetto**: `CLAUDE.md` nella directory del progetto (usato se non esiste `AGENTS.md`)
|
||||
- **Regole globali**: `~/.claude/CLAUDE.md` (usato se non esiste `~/.config/opencode/AGENTS.md`)
|
||||
- **Skill**: `~/.claude/skills/` — vedi [Skill agente](/docs/skills/) per i dettagli
|
||||
|
||||
Per disabilitare la compatibilita' con Claude Code, imposta una di queste variabili d'ambiente:
|
||||
|
||||
@@ -84,23 +84,23 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
|
||||
|
||||
---
|
||||
|
||||
## Precedence
|
||||
## Priorita
|
||||
|
||||
Quando opencode si avvia, cerca i file di regole in questo ordine:
|
||||
|
||||
1. **Local files** by traversing up from the current directory (`AGENTS.md`, `CLAUDE.md`)
|
||||
2. **Global file** at `~/.config/opencode/AGENTS.md`
|
||||
3. **Claude Code file** at `~/.claude/CLAUDE.md` (unless disabled)
|
||||
1. **File locali** risalendo dalla directory corrente (`AGENTS.md`, `CLAUDE.md`)
|
||||
2. **File globale** in `~/.config/opencode/AGENTS.md`
|
||||
3. **File Claude Code** in `~/.claude/CLAUDE.md` (se non disabilitato)
|
||||
|
||||
In ogni categoria vince il primo file corrispondente. Per esempio, se hai sia `AGENTS.md` sia `CLAUDE.md`, viene usato solo `AGENTS.md`. Allo stesso modo, `~/.config/opencode/AGENTS.md` ha priorita' su `~/.claude/CLAUDE.md`.
|
||||
|
||||
---
|
||||
|
||||
## Custom Instructions
|
||||
## Istruzioni personalizzate
|
||||
|
||||
Puoi specificare file di istruzioni personalizzati nel tuo `opencode.json` o nel globale `~/.config/opencode/opencode.json`. Questo permette a te e al tuo team di riusare regole esistenti invece di doverle duplicare in AGENTS.md.
|
||||
|
||||
Example:
|
||||
Esempio:
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -109,7 +109,7 @@ Example:
|
||||
}
|
||||
```
|
||||
|
||||
You can also use remote URLs to load instructions from the web.
|
||||
Puoi anche usare URL remoti per caricare istruzioni dal web.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -124,11 +124,11 @@ Tutti i file di istruzioni vengono combinati con i tuoi file `AGENTS.md`.
|
||||
|
||||
---
|
||||
|
||||
## Referencing External Files
|
||||
## Riferisci file esterni
|
||||
|
||||
Anche se opencode non interpreta automaticamente i riferimenti a file in `AGENTS.md`, puoi ottenere una funzionalita' simile in due modi:
|
||||
|
||||
### Using opencode.json
|
||||
### Usa opencode.json
|
||||
|
||||
L'approccio consigliato e' usare il campo `instructions` in `opencode.json`:
|
||||
|
||||
@@ -139,7 +139,7 @@ L'approccio consigliato e' usare il campo `instructions` in `opencode.json`:
|
||||
}
|
||||
```
|
||||
|
||||
### Manual Instructions in AGENTS.md
|
||||
### Istruzioni manuali in AGENTS.md
|
||||
|
||||
Puoi insegnare a opencode a leggere file esterni fornendo istruzioni esplicite nel tuo `AGENTS.md`. Ecco un esempio pratico:
|
||||
|
||||
@@ -170,10 +170,10 @@ Read the following file immediately as it's relevant to all workflows: @rules/ge
|
||||
|
||||
Questo approccio ti permette di:
|
||||
|
||||
- Create modular, reusable rule files
|
||||
- Share rules across projects via symlinks or git submodules
|
||||
- Keep AGENTS.md concise while referencing detailed guidelines
|
||||
- Ensure opencode loads files only when needed for the specific task
|
||||
- Crea file di regole modulari e riutilizzabili
|
||||
- Condividi regole tra progetti con symlink o submodule Git
|
||||
- Mantieni AGENTS.md conciso riferendoti a linee guida dettagliate
|
||||
- Assicurati che opencode carichi file solo quando servono per il task specifico
|
||||
|
||||
:::tip
|
||||
Per monorepo o progetti con standard condivisi, usare `opencode.json` con pattern glob (come `packages/*/AGENTS.md`) e' piu' manutenibile rispetto alle istruzioni manuali.
|
||||
|
||||
@@ -123,7 +123,7 @@ L'SDK espone tutte le API del server tramite un client type-safe.
|
||||
|
||||
---
|
||||
|
||||
### Global
|
||||
### Globale
|
||||
|
||||
| Metodo | Descrizione | Response |
|
||||
| ----------------- | --------------------------------- | ------------------------------------ |
|
||||
@@ -167,7 +167,7 @@ const agents = await client.app.agents()
|
||||
|
||||
---
|
||||
|
||||
### Project
|
||||
### Progetto
|
||||
|
||||
| Metodo | Descrizione | Response |
|
||||
| ------------------- | ----------------- | --------------------------------------------- |
|
||||
@@ -224,7 +224,7 @@ const { providers, default: defaults } = await client.config.providers()
|
||||
|
||||
---
|
||||
|
||||
### Sessions
|
||||
### Sessioni
|
||||
|
||||
| Metodo | Descrizione | Note |
|
||||
| ---------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
@@ -353,7 +353,7 @@ await client.tui.showToast({
|
||||
|
||||
---
|
||||
|
||||
### Auth
|
||||
### Autenticazione
|
||||
|
||||
| Metodo | Descrizione | Response |
|
||||
| ------------------- | ------------------------ | --------- |
|
||||
|
||||
@@ -84,7 +84,7 @@ Il server opencode espone le seguenti API.
|
||||
|
||||
---
|
||||
|
||||
### Global
|
||||
### Globale
|
||||
|
||||
| Metodo | Path | Descrizione | Response |
|
||||
| ------ | ---------------- | --------------------------- | ------------------------------------ |
|
||||
@@ -93,7 +93,7 @@ Il server opencode espone le seguenti API.
|
||||
|
||||
---
|
||||
|
||||
### Project
|
||||
### Progetto
|
||||
|
||||
| Metodo | Path | Descrizione | Response |
|
||||
| ------ | ------------------ | ----------------------- | --------------------------------------------- |
|
||||
@@ -111,7 +111,7 @@ Il server opencode espone le seguenti API.
|
||||
|
||||
---
|
||||
|
||||
### Instance
|
||||
### Istanza
|
||||
|
||||
| Metodo | Path | Descrizione | Response |
|
||||
| ------ | ------------------- | --------------------------- | --------- |
|
||||
|
||||
@@ -21,7 +21,7 @@ Quando condividi una conversazione, OpenCode:
|
||||
|
||||
---
|
||||
|
||||
## Sharing
|
||||
## Condivisione
|
||||
|
||||
OpenCode supporta tre modalita di condivisione che controllano come vengono condivise le conversazioni:
|
||||
|
||||
@@ -48,7 +48,7 @@ Per impostare esplicitamente la modalita manuale nel tuo [file di config](/docs/
|
||||
|
||||
---
|
||||
|
||||
### Auto-share
|
||||
### Automatico
|
||||
|
||||
Puoi abilitare la condivisione automatica per tutte le nuove conversazioni impostando l'opzione `share` su `"auto"` nel tuo [file di config](/docs/config):
|
||||
|
||||
@@ -63,7 +63,7 @@ Con la condivisione automatica attiva, ogni nuova conversazione verra condivisa
|
||||
|
||||
---
|
||||
|
||||
### Disabled
|
||||
### Disabilitato
|
||||
|
||||
Puoi disabilitare completamente la condivisione impostando l'opzione `share` su `"disabled"` nel tuo [file di config](/docs/config):
|
||||
|
||||
@@ -96,7 +96,7 @@ Ci sono alcune cose da tenere a mente quando condividi una conversazione.
|
||||
|
||||
---
|
||||
|
||||
### Data retention
|
||||
### Conservazione dati
|
||||
|
||||
Le conversazioni condivise restano accessibili finche non le annulli esplicitamente. Questo include:
|
||||
|
||||
@@ -106,7 +106,7 @@ Le conversazioni condivise restano accessibili finche non le annulli esplicitame
|
||||
|
||||
---
|
||||
|
||||
### Recommendations
|
||||
### Raccomandazioni
|
||||
|
||||
- Condividi solo conversazioni che non contengono informazioni sensibili.
|
||||
- Rivedi il contenuto della conversazione prima di condividerla.
|
||||
|
||||
@@ -3,19 +3,19 @@ title: Temi
|
||||
description: Seleziona un tema integrato o definiscine uno tuo.
|
||||
---
|
||||
|
||||
Con OpenCode puoi scegliere tra diversi temi integrati, usare un tema che si adatta al tema del tuo terminale oppure definire un tema personalizzato.
|
||||
Con OpenCode puoi scegliere tra diversi temi integrati, usare un tema che si adatta al tema del tuo terminal oppure definire un tema personalizzato.
|
||||
|
||||
Per impostazione predefinita, OpenCode usa il tema `opencode`.
|
||||
|
||||
---
|
||||
|
||||
## Requisiti del terminale
|
||||
## Requisiti del terminal
|
||||
|
||||
Per visualizzare correttamente i temi con l'intera palette, il terminale deve supportare **truecolor** (colore a 24 bit). La maggior parte dei terminali moderni lo supporta di default, ma potrebbe essere necessario abilitarlo:
|
||||
Per visualizzare correttamente i temi con l'intera palette, il terminal deve supportare **truecolor** (colore a 24 bit). La maggior parte dei terminal moderni lo supporta di default, ma potrebbe essere necessario abilitarlo:
|
||||
|
||||
- **Verifica supporto**: esegui `echo $COLORTERM` - dovrebbe stampare `truecolor` o `24bit`
|
||||
- **Abilita truecolor**: imposta la variabile d'ambiente `COLORTERM=truecolor` nel profilo della shell
|
||||
- **Compatibilita del terminale**: assicurati che l'emulatore supporti il colore a 24 bit (la maggior parte dei terminali moderni come iTerm2, Alacritty, Kitty, Windows Terminal e le versioni recenti di GNOME Terminal)
|
||||
- **Compatibilita del terminal**: assicurati che l'emulatore supporti il colore a 24 bit (la maggior parte dei terminal moderni come iTerm2, Alacritty, Kitty, Windows Terminal e le versioni recenti di GNOME Terminal)
|
||||
|
||||
Senza truecolor, i temi potrebbero apparire con colori meno accurati oppure fare fallback alla migliore approssimazione a 256 colori.
|
||||
|
||||
@@ -27,7 +27,7 @@ OpenCode include diversi temi integrati.
|
||||
|
||||
| Nome | Descrizione |
|
||||
| ---------------------- | ------------------------------------------------------------------------- |
|
||||
| `system` | Si adatta al colore di sfondo del terminale |
|
||||
| `system` | Si adatta al colore di sfondo del terminal |
|
||||
| `tokyonight` | Basato sul tema [Tokyonight](https://github.com/folke/tokyonight.nvim) |
|
||||
| `everforest` | Basato sul tema [Everforest](https://github.com/sainnhe/everforest) |
|
||||
| `ayu` | Basato sul tema scuro [Ayu](https://github.com/ayu-theme) |
|
||||
@@ -45,17 +45,17 @@ E altri ancora: aggiungiamo costantemente nuovi temi.
|
||||
|
||||
## Tema di sistema
|
||||
|
||||
Il tema `system` e progettato per adattarsi automaticamente allo schema colori del tuo terminale. A differenza dei temi tradizionali con colori fissi, il tema _system_:
|
||||
Il tema `system` e progettato per adattarsi automaticamente allo schema colori del tuo terminal. A differenza dei temi tradizionali con colori fissi, il tema _system_:
|
||||
|
||||
- **Genera una scala di grigi**: crea una scala di grigi personalizzata in base al colore di sfondo del terminale, garantendo un contrasto ottimale.
|
||||
- **Usa colori ANSI**: sfrutta i colori ANSI standard (0-15) per evidenziazione della sintassi ed elementi UI, rispettando la palette del terminale.
|
||||
- **Preserva i default del terminale**: usa `none` per testo e sfondo per mantenere l'aspetto nativo del terminale.
|
||||
- **Genera una scala di grigi**: crea una scala di grigi personalizzata in base al colore di sfondo del terminal, garantendo un contrasto ottimale.
|
||||
- **Usa colori ANSI**: sfrutta i colori ANSI standard (0-15) per evidenziazione della sintassi ed elementi UI, rispettando la palette del terminal.
|
||||
- **Preserva i default del terminal**: usa `none` per testo e sfondo per mantenere l'aspetto nativo del terminal.
|
||||
|
||||
Il tema di sistema e pensato per chi:
|
||||
|
||||
- Vuole che OpenCode corrisponda all'aspetto del terminale
|
||||
- Usa schemi colori personalizzati del terminale
|
||||
- Preferisce un aspetto coerente tra tutte le applicazioni da terminale
|
||||
- Vuole che OpenCode corrisponda all'aspetto del terminal
|
||||
- Usa schemi colori personalizzati del terminal
|
||||
- Preferisce un aspetto coerente tra tutte le applicazioni da terminal
|
||||
|
||||
---
|
||||
|
||||
@@ -119,7 +119,7 @@ I temi usano un formato JSON flessibile che supporta:
|
||||
- **Colori ANSI**: `3` (0-255)
|
||||
- **Riferimenti colore**: `"primary"` o definizioni personalizzate
|
||||
- **Varianti scuro/chiaro**: `{"dark": "#000", "light": "#fff"}`
|
||||
- **Nessun colore**: `"none"` - usa il colore predefinito del terminale o trasparente
|
||||
- **Nessun colore**: `"none"` - usa il colore predefinito del terminal o trasparente
|
||||
|
||||
---
|
||||
|
||||
@@ -129,12 +129,12 @@ La sezione `defs` e opzionale e ti permette di definire colori riutilizzabili ch
|
||||
|
||||
---
|
||||
|
||||
### Valori predefiniti del terminale
|
||||
### Valori predefiniti del terminal
|
||||
|
||||
Il valore speciale `"none"` puo essere usato per qualunque colore per ereditare il colore predefinito del terminale. E particolarmente utile per creare temi che si fondono con lo schema colori del terminale:
|
||||
Il valore speciale `"none"` puo essere usato per qualunque colore per ereditare il colore predefinito del terminal. E particolarmente utile per creare temi che si fondono con lo schema colori del terminal:
|
||||
|
||||
- `"text": "none"` - usa il colore del testo predefinito del terminale
|
||||
- `"background": "none"` - usa il colore di sfondo predefinito del terminale
|
||||
- `"text": "none"` - usa il colore del testo predefinito del terminal
|
||||
- `"background": "none"` - usa il colore di sfondo predefinito del terminal
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -58,7 +58,7 @@ Esegui comandi di shell nel tuo ambiente di progetto.
|
||||
}
|
||||
```
|
||||
|
||||
Questo strumento permette all'LLM di eseguire comandi da terminale come `npm install`, `git status` o qualunque altro comando di shell.
|
||||
Questo strumento permette all'LLM di eseguire comandi da terminal come `npm install`, `git status` o qualunque altro comando di shell.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -138,7 +138,7 @@ Su Windows, OpenCode Desktop richiede **WebView2 Runtime** di Microsoft Edge. Se
|
||||
|
||||
### Windows: problemi generali di prestazioni
|
||||
|
||||
Se riscontri prestazioni lente, problemi di accesso ai file o problemi del terminale su Windows, prova a usare [WSL (Windows Subsystem for Linux)](/docs/windows-wsl). WSL fornisce un ambiente Linux che funziona in modo piu fluido con le funzionalita di OpenCode.
|
||||
Se riscontri prestazioni lente, problemi di accesso ai file o problemi del terminal su Windows, prova a usare [WSL (Windows Subsystem for Linux)](/docs/windows-wsl). WSL fornisce un ambiente Linux che funziona in modo piu fluido con le funzionalita di OpenCode.
|
||||
|
||||
---
|
||||
|
||||
@@ -198,7 +198,7 @@ Ecco alcuni problemi comuni e come risolverli.
|
||||
### OpenCode non si avvia
|
||||
|
||||
1. Controlla i log per eventuali messaggi di errore
|
||||
2. Prova a eseguire con `--print-logs` per vedere l'output nel terminale
|
||||
2. Prova a eseguire con `--print-logs` per vedere l'output nel terminal
|
||||
3. Assicurati di avere l'ultima versione con `opencode upgrade`
|
||||
|
||||
---
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
---
|
||||
title: TUI
|
||||
description: Usa l'interfaccia utente da terminale (TUI) di OpenCode.
|
||||
description: Usa l'interfaccia utente da terminal (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.
|
||||
OpenCode fornisce un'interfaccia interattiva da terminal (TUI) per lavorare sui tuoi progetti con un LLM.
|
||||
|
||||
Eseguire OpenCode avvia la TUI per la directory corrente.
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ 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 puo funzionare come applicazione web nel browser, offrendo la stessa potente esperienza di coding AI senza bisogno di un terminal.
|
||||
|
||||

|
||||
|
||||
@@ -22,7 +22,7 @@ Se `OPENCODE_SERVER_PASSWORD` non e impostata, il server non sara protetto. Va b
|
||||
:::
|
||||
|
||||
:::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.
|
||||
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 terminal.
|
||||
:::
|
||||
|
||||
---
|
||||
@@ -108,9 +108,9 @@ Fai clic su "See Servers" per vedere i server connessi e il loro stato.
|
||||
|
||||
---
|
||||
|
||||
## Collegare un terminale
|
||||
## Collegare un terminal
|
||||
|
||||
Puoi collegare una TUI da terminale a un server web gia in esecuzione:
|
||||
Puoi collegare una TUI da terminal a un server web gia in esecuzione:
|
||||
|
||||
```bash
|
||||
# Start the web server
|
||||
@@ -120,7 +120,7 @@ opencode web --port 4096
|
||||
opencode attach http://localhost:4096
|
||||
```
|
||||
|
||||
Questo ti permette di usare contemporaneamente interfaccia web e terminale, condividendo le stesse sessioni e lo stesso stato.
|
||||
Questo ti permette di usare contemporaneamente interfaccia web e terminal, condividendo le stesse sessioni e lo stesso stato.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -8,7 +8,7 @@ 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.
|
||||
WSL offre prestazioni migliori del file system, supporto completo del terminal e compatibilita con gli strumenti di sviluppo su cui OpenCode fa affidamento.
|
||||
:::
|
||||
|
||||
---
|
||||
@@ -23,7 +23,7 @@ WSL offre prestazioni migliori del file system, supporto completo del terminale
|
||||
|
||||
2. **Installa OpenCode in WSL**
|
||||
|
||||
Dopo aver configurato WSL, apri il terminale WSL e installa OpenCode usando uno dei [metodi di installazione](/docs/).
|
||||
Dopo aver configurato WSL, apri il terminal WSL e installa OpenCode usando uno dei [metodi di installazione](/docs/).
|
||||
|
||||
```bash
|
||||
curl -fsSL https://opencode.ai/install | bash
|
||||
@@ -73,7 +73,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
|
||||
|
||||
Per la migliore esperienza web su Windows:
|
||||
|
||||
1. **Esegui `opencode web` nel terminale WSL** invece che in PowerShell:
|
||||
1. **Esegui `opencode web` nel terminal WSL** invece che in PowerShell:
|
||||
|
||||
```bash
|
||||
opencode web --hostname 0.0.0.0
|
||||
@@ -81,7 +81,7 @@ Per la migliore esperienza web su Windows:
|
||||
|
||||
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.
|
||||
Eseguire `opencode web` da WSL garantisce accesso corretto al file system e integrazione del terminal, restando comunque accessibile dal browser Windows.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user