Interfaccia di Kora

Usa questa pagina per individuare le parti principali della finestra di Kora e capire dove compaiono progetti, cartelle e sessioni.

Progetti, cartelle e sessioni

• Directoryprogetto/ Il contesto di lavoro

  • Directorycartelle/ Fino a 10; path locali o mount SSH remoti

    • …
  • Directorysessioni/ Conversazioni indipendenti, ciascuna con il proprio contesto

    • …

Un progetto raggruppa le cartelle su cui Kora può operare e le sessioni che usano quelle cartelle. Seleziona un progetto o una sessione dalla barra laterale sinistra.

Progetto

Un progetto ha un nome, contiene fino a 10 cartelle e possiede le sue sessioni. I progetti possono essere open, closed o archived.

Vedi Primo lancio per crearne uno, e Gestore sessioni per il ciclo di vita del progetto.

Cartella

Una cartella è una posizione del file system che Kora può leggere, modificare e usare come directory di lavoro.

Tipo	Cos’è	Caso d’uso
Locale	Un percorso assoluto sul Mac	Lavorare sui file conservati sul Mac
Remota (SSH)	Un percorso montato da un server SSH	Lavorare sui file conservati su un’altra macchina

Un progetto può mescolare cartelle locali e remote. Le chiamate ai tool (readFile, writeFile, executeCommand) puntano alla cartella del file attualmente in contesto — locale o remoto.

Vedi Workspace remoti SSH per configurare i mount SSH.

Sessione

Una sessione è una conversazione all’interno di un progetto. Selezionando una sessione vengono ripristinati messaggi, lista delle attività, messaggi in coda, modello selezionato e stato di esecuzione.

Una sessione porta con sé:

• Messaggi — l’intera cronologia della conversazione
• Contesto — ciò che il modello può vedere in questo momento (prompt di sistema, tool, messaggi recenti)
• Todo list — ciò su cui l’agente sta lavorando (vedi Pannello operativo)
• Coda — i messaggi che hai inviato mentre l’agente era occupato
• Modalità — la modalità di esecuzione (Ask / Plan / Debug / Build)

Le sessioni hanno anche un ciclo di vita: active, closed, archived, o deleted (con una finestra di recupero di 30 giorni). Vedi Sessioni per le azioni quotidiane, e Gestore sessioni per esplorare, esportare, fare il fork e ripristinare.

Struttura della finestra

La finestra di Kora è divisa in cinque regioni.

Regione	Cosa contiene
Barra superiore	Controlli dei pannelli, tema, stato della sincronizzazione e Impostazioni
Sidebar sinistra	Albero di navigazione — progetti aperti con le relative cartelle e sessioni; stato live nel footer
Area principale	Pannelli di chat, editor, terminale, confronto modifiche, log e file generati
Sidebar destra	Accordion con 7 sezioni (File Explorer, Remote, MCP Servers, Skills, Projects, Sessions, Git)
Compositore	Input del messaggio, modalità, modello, effort, temperatura, allegati e controlli di invio/arresto

Sidebar sinistra

L’albero di navigazione. Elenca i progetti aperti con le relative cartelle e sessioni. Usa la casella di ricerca per filtrare i progetti, trascina gli elementi per riordinarli e clicca una sessione per passarle. Il footer mostra lo stato live (streaming, ready, error) e la modalità di ottimizzazione corrente.

Può essere collassata in una barra slim dall’header o con Cmd + \.

Area principale

Apri, chiudi, ridimensiona e riordina i pannelli nell’area principale. Il layout viene conservato tra i riavvii.

I pannelli disponibili includono chat, editor, diff editor, terminale, log, file generati e File Explorer.

Sidebar destra

Un accordion con sette sezioni, solo una aperta alla volta:

Sezione	Cosa mostra
File Explorer	L’albero delle directory della cartella attiva
Remote: cartella	Una sezione per ogni cartella remota connessa
MCP Servers	I server MCP connessi e i relativi tool
Skills	Le skill caricate (globali + progetto)
Projects	Progetti chiusi e archiviati (con Reopen / Archive / Delete)
Sessions	Il Gestore sessioni completo (esplora, filtra, esporta, importa, fork, elimina)
Git	Il branch corrente e le operazioni Git

Top bar

Toggle rapidi per i pannelli (log, editor, terminale, file explorer), il selettore tema, l’indicatore di sync e il pulsante Impostazioni. I selettori modalità / modello / effort / temperature vivono nel composer, non qui.

Composer

L’area di input in fondo al pannello chat. Qui scrivi i messaggi, alleghi file e immagini, cambi modalità di esecuzione, scegli il modello, imposti effort e temperatura, e invii o fermi lo stream. La striscia del Pannello operativo sta subito sopra.

Modalità di esecuzione

La modalità cambia il modo in cui Kora gestisce la richiesta successiva. Usa il controllo della modalità in basso a sinistra nel compositore, oppure premi Cmd + Shift + M / Shift + Tab.

Modalità	Comportamento
Ask	Conferma le azioni distruttive prima di eseguirle
Plan	Scrive un piano e chiede approvazione, poi passa a Build per eseguire
Debug	Autonoma, con ragionamento e recupero contesto visibili
Build	Autonoma e silenziosa; applica le modifiche senza chiedere

Vedi Task multi-step per come le modalità interagiscono con i workflow multi-step.

Dove andare dopo

Primo lancio

Crea il primo progetto e avvia una sessione.

Sessioni

Azioni quotidiane sulle sessioni.

Scorciatoie da tastiera

Tutte le scorciatoie e le voci di menu.