Kalka
Documentazione

Risoluzione dei problemi

Soluzioni per gli avvisi del primo avvio su macOS e Windows, Linux, gli aggiornamenti, la porta MCP, il salvataggio automatico nel browser, e come segnalare un bug.

docs / troubleshooting

macOS non apre Kalka

Le versioni beta non sono ancora firmate con un certificato Apple Developer, quindi macOS blocca il primo avvio.

  1. Apri Kalka una volta e lascia che macOS lo blocchi.
  2. Apri Impostazioni di Sistema › Privacy e sicurezza.
  3. Scorri fino al messaggio su Kalka e fai clic su Apri comunque.
  4. Conferma con la password o con Touch ID. Kalka si apre, e macOS non lo chiederà più per questa versione.

Togli l’attributo di quarantena nel Terminale, poi aprilo di nuovo:

xattr -dr com.apple.quarantine /Applications/Kalka.app

Windows SmartScreen blocca il programma di installazione

SmartScreen avvisa per i programmi di installazione che ha visto poche volte, e le versioni beta non sono ancora firmate. Nella finestra blu «Windows ha protetto il PC», fai clic su Ulteriori informazioni, poi su Esegui comunque.

Linux

Kalka viene distribuito come AppImage. Se non parte con un doppio clic, rendilo prima eseguibile:

chmod +x Kalka-*.AppImage

Su Windows e Linux, il menu di Kalka si trova dentro la finestra invece che in una barra dei menu di sistema.

Gli aggiornamenti non si installano su macOS

Un Kalka non firmato non può sostituirsi da solo su macOS. La finestra Aggiornamento software lo spiega e propone Scarica: installa il nuovo .dmg sopra il vecchio Kalka in Applicazioni. I tuoi documenti e le tue impostazioni restano.

Gli agenti non raggiungono Kalka

Il server MCP gira dentro l’app desktop, sulla porta 7600. Kalka deve essere aperto perché gli agenti lo raggiungano.

  • «La porta 7600 è usata da un altro programma» in Impostazioni › MCP: un altro programma occupa la porta, spesso un server di sviluppo di Kalka rimasto acceso o una seconda copia di Kalka. Chiudilo, poi avvia di nuovo il server dalle Impostazioni.
  • «Il server MCP non ha risposto in tempo» o «non è raggiungibile»: controlla che Kalka sia aperto, poi riavvia il tuo agente così si ricollega.
  • «ha rifiutato la connessione locale»: riavvia Kalka; genera un nuovo token locale.

Vedi MCP e ACP per collegare ogni agente.

Il salvataggio automatico chiede un permesso nel browser

In Chrome ed Edge, una pagina web può scrivere un file sul tuo disco solo con il tuo permesso. Quando attivi il salvataggio automatico per un file aperto dal disco, il browser lo chiede una volta. Se rifiuti, Kalka non può salvare automaticamente e te lo dice. I browser senza accesso ai file, come Safari e Firefox, scaricano una copia a ogni salvataggio.

Le versioni non funzionano

Il pannello Cronologia richiede l’app desktop, un documento salvato sul tuo computer e Git installato. Su macOS installa Git con xcode-select --install; su Windows, da git-scm.com. Per pubblicare le versioni online, il tuo computer deve già poter fare push su quel repository con Git.

Troppe animazioni

In Impostazioni › Generali, sotto Aspetto, Animazioni può seguire l’impostazione di riduzione del movimento del sistema o disattivare le animazioni. Riduci le animazioni degli agenti mostra subito i nuovi livelli di un agente invece di farli comparire blocco per blocco.

Impostazioni, scheda Generali: lingua, tema, animazioni, Riduci le animazioni degli agenti, il tuo nome e il recupero dopo un crash
Impostazioni › Generali, con Animazioni, Riduci le animazioni degli agenti e il recupero dopo un crash.

Recuperare il lavoro perso

Se Kalka si è chiuso prima che tu salvassi, riaprilo: ti propone di ripristinare i documenti non salvati. Vedi File e versioni.

Segnalare un bug

Apri una issue su github.com/leyscore/kalka/issues. Se Kalka non si avvia, la sua schermata di errore ha un link Report a problem che apre la issue con la tua versione e il tuo sistema già compilati. Racconta cosa hai fatto, cosa ti aspettavi e cosa è successo; un file o uno screenshot aiutano molto.