BLUN Code CLI

Cosa è cambiato dalla 9.1.605

Le singole modifiche e i loro stati di pubblicazione li trovi nel changelog della CLI.

Prerequisiti

• Windows o macOS su x64 o ARM64; inoltre Linux
• Node.js 24.15.0 o successivo della serie LTS-24
• Node.js, npm e Git Bash su Windows
• Accesso a Internet per accesso, modelli di IA e strumenti gestiti
• una cartella di lavoro per il tuo progetto

Node.js, npm e Git Bash su Windows

Node.js esegue la console. npm installa e aggiorna il pacchetto. Il programma di installazione ufficiale di Node.js contiene npm. Git for Windows fornisce la shell Git Bash di cui King ha bisogno; con Node.js Git Bash non viene installato.

Prima della prima installazione

1. Installa Node.js 24 LTS (almeno 24.15.0) con il MSI di Windows da nodejs.org/en/download. Lascia attivi npm e la voce PATH.

2. Installa Git for Windows da gitforwindows.org.

3. Chiudi completamente il terminale e apri una nuova finestra di prompt dei comandi.

4. Controlla node --version, npm --version e git --version, prima di installare King.

   node --version
   npm --version
   git --version

Git for Windows contiene Git Bash. Può avviare King dal prompt dei comandi o da PowerShell; non serve una finestra Git Bash aggiuntiva.

Installazione di Node.js e npm: documentazione ufficiale di npm.

Se node o npm non viene trovato

Node.js/npm manca o non è raggiungibile tramite PATH. Apri prima di nuovo il terminale. Se l'errore persiste, ripara l'installazione di Node.js con npm e voce PATH attivi.

where.exe node e where.exe npm mostrano i percorsi raggiungibili; senza risultati il programma non è stato trovato tramite PATH.

where.exe node
where.exe npm

Se PowerShell blocca npm.ps1, usa npm.cmd invece di allentare i criteri di esecuzione.

npm.cmd --version
npm.cmd install -g blun-king-cli@latest

Se Git Bash non viene trovato

Installa Git for Windows e riapri il terminale. Con un'installazione in un'altra directory imposta BLUN_SHELL_PATH sul percorso assoluto del bash.exe installato.

L'esempio seguente vale solo per la finestra di prompt dei comandi e per questa sessione del terminale; adatta il percorso alla tua installazione. Controlla prima che il file esista.

dir "C:\Program Files\Git\bin\bash.exe"
set "BLUN_SHELL_PATH=C:\Program Files\Git\bin\bash.exe"

Controllare e tenere aggiornato Node.js

Controlla prima la versione installata:

node --version
npm --version

Per l'installazione npm una tantum devono già essere presenti Node e npm. Con una versione precedente di Node è possibile un avviso EBADENGINE. Dopo un'installazione riuscita basta il primo avvio con king o blun; BLUN configura quindi la propria runtime.

Percorso alternativo manuale

Se il download automatico o il controllo delle somme di controllo su Windows o macOS fallisce, installa manualmente Node.js 24 LTS:

1. Aprire la pagina di download ufficiale

   Apri nodejs.org/en/download e scegli Node.js 24 LTS.

2. Eseguire il programma di installazione adatto

   Su Windows usa il programma di installazione MSI. Su macOS usa il pacchetto PKG. Scegli x64 o ARM64 adatto al tuo computer.

3. Riaprire completamente il terminale

   I terminali già aperti usano spesso ancora il vecchio percorso del programma.

4. Controllare di nuovo la versione

   node --version
   npm --version

Installazione

1. Verificare i prerequisiti

   node --version
   npm --version

   Su Windows e macOS BLUN può sostituire al primo avvio una versione di Node già presente con il suo runtime privato. Per l'installazione npm, Node e npm devono essere già richiamabili. Su Linux ti serve Node.js 24.15.0 o più recente prima dell'avvio.

   Node.js, npm e Git Bash su Windows

2. Installare la versione stabile attuale

   npm install -g blun-king-cli@latest

3. Verificare l'installazione

   blun --version

4. Eseguire la diagnostica

   blun doctor

Avvio e accesso

Profilo, area di lavoro e sessione

Un profilo seleziona l'identità King separata e le sue impostazioni. Un'area di lavoro determina quali file di progetto sono aperti. Una sessione contiene la cronologia della conversazione e lo stato di lavoro. Una nuova sessione non è quindi né un nuovo account né automaticamente un worktree Git isolato.

king --profile mein-king

--profile appartiene al launcher king. Per un'area di lavoro Git isolata usi blun workspace create <nome>; per riprendere una conversazione usi la selezione della sessione. La referenza dei comandi spiega questi comandi e i loro prerequisiti.

Quale comando di avvio dovresti usare?

Accedere per la prima volta

1. Avviare l'accesso

   blun login

2. Completare l'accesso nel browser

   Accedi con il tuo account BLUN e torna poi alla console.

3. Aprire la cartella del progetto e avviare

   cd "C:\Pfad\zu\deinem\Projekt"
   king

In alternativa puoi digitare /login in una console in esecuzione. Non devi copiare alcuna chiave API in un file di configurazione.

Riprendere una sessione

Con /sessions apri la selezione delle sessioni. Puoi anche indicare un identificativo esatto, un titolo esatto o un inizio di identificativo univoco. In caso di più risultati scegli la sessione desiderata dall'elenco.

/sessions API-ristrutturazione

Per l'ultima sessione della cartella di lavoro corrente avvii King nel terminale normale con:

king --continue

Dalla 9.1.606 la visualizzazione carica prima le voci di cronologia più recenti. Di norma sono circa 200; i messaggi correlati e i passaggi con gli strumenti restano completi e possono superare questo numero. Con la navigazione della cronologia raggiungi le pagine più vecchie. La cronologia della conversazione salvata e il contesto del modello non vengono ridotti da questo limite di visualizzazione.

La dimensione obiettivo della visualizzazione puoi impostarla all'avvio interattivo tra 1 e 2000:

king --continue --history-limit 400

Aprire all'avvio l'ultima sessione selezionata

Se torni regolarmente allo stesso lavoro, puoi aggiungere questa impostazione nel tuo ~/.blun/tui.toml esistente. Su Windows il file si trova di norma in %USERPROFILE%\.blun\tui.toml.

resume_last_selected = true

Metti la riga nella parte alta del file, prima di una sezione come [editor]. Le altre impostazioni restano invariate. La selezione viene salvata in modo adatto ad account, agente, cartella di lavoro e runtime. Una sessione indicata esplicitamente ha la priorità. Se la selezione salvata non è più disponibile, inizia una nuova sessione. Con false disattivi di nuovo questa opzione di avvio.

Selezionare i profili

/profile o /profiles apre la selezione dei profili. Durante il lavoro in corso o con messaggi in attesa il profilo attuale resta attivo; scegli l'altro profilo appena la sessione è pronta.

System32 non è una cartella di progetto

Prima dell'avvio, nel prompt dei comandi vai nella tua cartella utente con cd /d "%USERPROFILE%". In alternativa vai in una tua cartella di progetto esistente. In PowerShell scegli la cartella utente con Set-Location $HOME. Avvia poi king.

cd /d "%USERPROFILE%"
king

Scegliere la cartella di lavoro (9.1.603)

Se su Windows scegli un'altra cartella di lavoro, si apre una finestra di dialogo per la cartella. Puoi comunque inserire il percorso a mano. Se annulli la finestra, torni alla selezione della cartella senza adottarne una.

Se non è disponibile alcuna finestra di dialogo per la cartella, la console chiede il percorso. Su altri sistemi operativi resta l'inserimento del percorso.

Se all'avvio viene adottata o salvata una cartella all'interno della directory di Windows, la selezione della cartella propone la tua cartella utente. I percorsi inseriti a mano continuano a essere controllati come prima.

Lavoro quotidiano

Impostare impegno di ragionamento e autorizzazioni

Ctrl+L apre dalla 9.1.609 la selezione per lo sforzo di riflessione direttamente dal campo di input. Il testo già inserito resta invariato. Mentre King lavora, un cambio viene rifiutato; riapri la selezione appena la sessione è pronta. I livelli disponibili dipendono dal modello attivo.

L'impegno di ragionamento controlla quanto a fondo il modello lavora prima di una risposta. Livelli più alti possono richiedere molto più tempo.

blun --effort high --permission-mode manual

Scegliere lo stile di output

Con /output-style apri la selezione. Sono disponibili Standard, Conciso, Proattivo, Esplicativo e In apprendimento. La scelta vale subito per la sessione in corso e viene salvata come standard per gli avvii successivi.

Comprimere il contesto attivo

BLUN Code controlla il contesto attivo per la prossima richiesta al modello, non semplicemente l'intera cronologia salvata. Il limite effettivo dipende dal modello, dall'account e dal budget di compressione. Le parti più vecchie vengono riassunte in fasi limitate; ogni fase riserva spazio per il proprio riassunto.

Durante l'operazione nella conversazione appare ad esempio Verdichte ~941,2k Tokens … · 2/~10 · 90 %. 2/~10 mostra la fase in corso e il numero totale stimato di fasi. 90 % è l'utilizzo misurato della finestra del modello per la chiamata di compressione attuale. Se una fase fallisce o non riduce il contesto, il contesto originale resta invariato.

Già al 75 percento del limite effettivo di compressione, una piccola compressione senza perdite alleggerisce i risultati di strumenti grandi e gli argomenti di strumenti completati. Con una finestra del modello di 1.048.576 token e una compressione completa a 256.000 token, questo punto si trova a 192.000 token. Gli ultimi 20 messaggi, i testi utente normali e la cronologia grezza salvata restano invariati.

Comprimere proattivamente a un limite di lavoro

Non serve alcun comando da parte dell'utente. Appena il contesto attivo raggiunge la metà del limite automatico di compressione completa, King può scegliere CompactConversation dopo una sezione di lavoro completata. Lo strumento pianifica il procedimento di compressione sicuro esistente per la fine dello step di strumento attuale. Non apre un ulteriore turno; se la compressione fallisce, la cronologia originale resta invariata.

Superare un breve sovraccarico del server

In caso di sovraccarico del server esplicitamente contrassegnato come ripetibile (HTTP 429 con x-should-retry: true), BLUN King attende secondo Retry-After e invia la stessa richiesta al massimo due volte. Gli errori di autenticazione, quota e altri non ripetibili continuano a interrompersi subito. Se il server resta sovraccarico dopo i tentativi limitati, l'utente riceve comunque il chiaro messaggio di errore.

Proseguire il lavoro delegato dopo un'interruzione del provider

Se un singolo agente delegato o un membro di uno sciame di agenti perde la connessione al provider, riceve una risposta vuota dal provider, interrompe il proprio stream per inattività o il server segnala HTTP 408/500/502/503/504, BLUN King prosegue lo stesso agente in base alla sua cronologia durevole. Per i singoli agenti e per le interruzioni dello sciame al di fuori di HTTP 429 la prima ripresa attende due secondi e la seconda cinque secondi; in seguito l'errore originale resta visibile. HTTP 429 mantiene nello sciame la sua regola di sovraccarico separata e più lunga. Gli errori di autenticazione, pagamento o quota, criteri, contesto, strumenti e codice nonché le interruzioni manuali non innescano una ripresa automatica. Ogni tentativo di ripresa usa l'ID dell'agente esistente, così il lavoro già completato non viene ripetuto.

Spostare i risultati grandi degli strumenti

Per i risultati di strumenti basati su testo con più di 12.000 caratteri, BLUN King salva il contenuto completo nella cartella privata di sessione tool-results. Nelle richieste successive al modello restano i primi 1.000 e gli ultimi 1.000 caratteri, il numero esatto dei caratteri omessi e l'output_path. I risultati multimediali misti e i risultati già troncati restano invariati. Una successiva microcompressione conserva il percorso.

La versione 9.1.104 lascia girare i comandi shell in primo piano fino alla fine regolare anche con output molto grandi. King scrive fino a 16 MiB in modo continuo nel log privato dell'incarico, scarta gli output oltre questo limite e segnala l'effettivo codice di uscita, invece di terminare il processo per la quantità dell'output. Gli output piccoli, le attività in background, i limiti di tempo e le interruzioni manuali restano invariati.

Read output_path

Esempio: un risultato di ricerca con 30.000 caratteri resta completamente disponibile nel file locale. Il modello vede subito l'inizio e il risultato finale o l'errore; l'agente legge tramite il percorso solo le sezioni necessarie, invece di inviare di nuovo tutti i 30.000 caratteri a ogni passo del modello.

Pila di risultati di strumenti paralleli

Dal momento che ogni singolo risultato è più piccolo, se il totale della pila supera 12.000 caratteri, King sposta tanti dei risultati più grandi a partire da 3.000 caratteri quanti servono per scendere sotto il limite. Nel contesto del modello restano riferimenti leggibili; la cronologia grezza di sessione e i media restano invariati. L'evento di telemetria tool_result_batch_offloaded segnala solo numero e dimensioni in caratteri, non contenuti o percorsi.

Spostare i messaggi utente grandi

Se un vero messaggio utente contiene più di 200.000 caratteri di testo, BLUN King salva il testo completo nella cartella privata conversation-history. Nel contesto del modello restano le prime cinque e le ultime cinque righe, le indicazioni sulle dimensioni e un output_path. Con Read e l'output_path l'agente legge solo le pagine necessarie. Immagini, audio e altre parti non testuali restano allegate. La trascrizione visibile e la cronologia grezza salvata contengono comunque il messaggio originale completo. I messaggi con esattamente 200.000 caratteri restano completamente nel contesto; in caso di errore di scrittura vale lo stesso.

Limitare le ricerche Grep grandi

In modalità di output content Grep termina ripgrep dopo offset più head_limit più una riga di anteprima completa. La riga aggiuntiva serve solo a riconoscere un'ulteriore pagina. Con head_limit=250 e offset=0 vengono lette al massimo 251 righe di risultato complete. Con head_limit=0, per count_matches e per i files_with_matches ordinati per tempo di modifica, King continua a leggere il risultato completo.

Continuare a leggere con precisione i file grandi

I file grandi continuano a essere letti a pagine. Se Read raggiunge il suo limite interno di 1.000 righe e il file contiene altre righe, il risultato indica l'esatto line_offset successivo. Esempio: una lettura dalla riga 2001 viene ripresa con line_offset=3001. Alla fine del file e con una sezione di lettura volutamente più piccola non appare alcuna indicazione. Così l'agente non trae conclusioni da una sezione incompleta e non rilegge il file dall'inizio.

Usare i thread di conversazione

Agenti in background

Gli agenti in background compaiono con incarico e stato nella vista agenti. Può aprire l'output, inviare una richiesta di chiarimento o fermare l'agente. Gli hook e la diagnosi integrata del language server controllano i file modificati dopo operazioni di scrittura e modifica.

La versione 9.1.105 aggiunge TaskUpdate per gli agenti in background in corso. King trasmette istruzioni aggiuntive al prossimo passo di modello sicuro allo stesso agente attivo, senza fermarlo o avviare un altro agente. Gli incarichi sconosciuti e già terminati, le attività shell e gli agenti che non accettano più aggiornamenti vengono rifiutati invariati.

La versione 9.1.106 permette ai profili agente di escludere strumenti per nome. King applica queste esclusioni solo dopo aver composto gli strumenti caricati in modo durevole, ricaricati dinamicamente e MCP. I profili standard coder, explore e plan non possono rispondere né reagire via Telegram, modificare messaggi o scaricare allegati; l'agente principale resta invariato. Così gli agenti delegati non inviano messaggi bypassando l'agente principale e le loro richieste al modello contengono meno schemi di strumenti. Gli strumenti non trovati indicati per nome vengono segnalati in modo visibile.

La versione 9.1.107 mostra gli errori del provider in un linguaggio comprensibile per i clienti; i codici di errore interni e le indicazioni di supporto non compaiono. /help offre un elenco di comandi navigabile con i tasti freccia e apre con la freccia destra o con Invio una descrizione dettagliata del comando selezionato.

La versione 9.1.108 rimuove dalla proiezione del modello gli avvisi di sistema identici e inseriti ripetutamente. Per ogni tipo di avviso resta visibile la copia esatta più recente. Gli avvisi modificati, i normali messaggi utente, le chiamate di strumento, i contenuti misti e la cronologia grezza di sessione salvata restano invariati. Così i dati inviati al provider in sessioni lunghe diventano più piccoli, senza ridurre cronologia salvata, esportazioni o riprese.

Caricare strumenti e skill in base alle necessità

Dal 9.1.595 King carica di nuovo gli schemi di strumenti opzionali in modo mirato tramite ToolSearch, invece di inviare il catalogo completo a ogni richiesta. La selezione conservata è limitata; gli strumenti restano reperibili anche se il loro schema non viene inviato in quel momento. I normali controlli delle autorizzazioni restano validi. I grandi cataloghi di skill vengono forniti in modo compatto e a pagine.

Per i saluti brevi King può usare una sezione limitata del dialogo più recente. Le istruzioni di sistema restano; per un incarico di lavoro viene nuovamente considerata la cronologia di lavoro conservata. Questo non elimina messaggi salvati. Un saluto non ha quindi un prezzo fisso in token: contesto di sistema, strumenti, ripetizioni e controllo delle risposte contribuiscono comunque al consumo.

/context mostra la dimensione stimata del contesto della prossima richiesta e il limite valido. /context-doctor rispettivamente /tokens integrano la visualizzazione con dati di diagnosi disponibili; /usage mostra la vista consumo e quote. Valori stimati, consumo di sessione sommato e token effettivamente fatturati sono grandezze diverse.

I grandi cataloghi di strumenti vengono esplorati se necessario tramite la ricerca degli strumenti. Dalla 9.1.615 il budget degli strumenti si orienta alla finestra di contesto dichiarata dal fornitore. Gli strumenti trovati restano disponibili nel passaggio successivo; le loro descrizioni complete non devono essere inviate a ogni incarico.

/context doctor: distingue cronologia salvata, numeri di token stimati e numero di byte della richiesta serializzata. Mostra i contributi rilevati delle regole AGENTS, dei file Mistake, di Memory, delle skill e delle definizioni degli strumenti. Dati di origine mancanti non significano zero byte.

Byte della richiesta, numeri di token stimati, consumo di sessione sommato e token fatturati sono grandezze diverse. La vista consumo considera anche il controllo delle risposte. /usage cost con costi giornalieri o mensili non appartiene a questa versione. Costi inferiori o risposte più rapide nell'esercizio live non sono dimostrati.

Ogni tentativo HTTP riceve una nuova x-request-id, se il chiamante non ne fornisce una. Gli ID forniti restano invariati e non vengono registrati come testo estraneo qualsiasi. L'ID serve ad associare le misurazioni di client e server; non è una chiave di fatturazione.

Controllo della sessione in 9.1.604

/queue: mostra o modifica il modo in cui questa sessione elabora i messaggi in arrivo. Le modalità si chiamano steer, followup, collect e interrupt; reset o default rimuove l'impostazione specifica della sessione.

Senza modifica specifica della sessione King usa steer con 500 millisecondi di attesa di raggruppamento e una dimensione massima del gruppo di 20 messaggi. /queue mostra i valori efficaci; /queue reset rimuove solo l'impostazione specifica della sessione.

steer trasmette i nuovi input al prossimo punto di passaggio adatto; se non è possibile, attendono il prossimo ciclo. followup attende la fine del ciclo in corso. collect raggruppa gli input; interrupt interrompe il ciclo in corso per i nuovi input.

/queue collect debounce:500ms batch:10

Sono consentiti debounce:0ms fino a debounce:60s e batch:1 fino a batch:100. batch limita la dimensione del raggruppamento senza eliminare messaggi in eccesso. Non esiste un'opzione cap: o drop:. La regola della coda e la vista consumo restano al proseguimento della stessa sessione. I normali nuovi messaggi di canale non innescano più automaticamente un'interruzione dopo 30 secondi.

/session [ID|Titolo]: apre la selezione della sessione oppure sceglie una sessione tramite il suo identificativo esatto, il suo titolo esatto o un prefisso di identificativo univoco. Con più risultati si apre la selezione.

/question: riapre le richieste di chiarimento in sospeso. Comprimere non risponde né scarta una richiesta di chiarimento.

/usage: mostra il consumo e le quote disponibili. off, tokens e full salvano la modalità di visualizzazione per questa sessione. reset rimuove questa impostazione; inherit, clear e default sono equivalenti.

/settings: apre le impostazioni incluse le opzioni di visualizzazione locali.

9.1.605

/context map mostra la ripartizione in byte disponibile della richiesta rilevata più di recente. /context list, /context detail e /context doctor aprono il rapporto dettagliato. Esso distingue file di istruzioni, Memory, skill, definizioni di strumenti e testi di cronologia assegnati. Valori di misura mancanti restano contrassegnati come non disponibili; non vengono contati come zero.

king --message "Controlla i test aperti" trasmette alla console interattiva un primo messaggio. Esso viene elaborato dopo il consenso all'avvio e la selezione della sessione tramite i normali controlli dei messaggi e la coda. Il suo contenuto non viene interpretato come comando slash o shell. Il consenso all'avvio e i controlli delle autorizzazioni non vengono saltati.

/abort interrompe il processo in corso senza scartare gli input in attesa. /stop scarta inoltre gli input in attesa. /exit continua a terminare la console. Sono comandi locali della console, non ulteriori comandi remoti di Telegram.

La riga aggiuntiva agente/sessione in basso viene meno. La selezione della sessione e la diagnosi restano disponibili tramite i comandi esistenti.

Distinguere contesto attuale e cronologia salvata

Una lunga cronologia salvata non deve stare per intero in una singola richiesta al modello. King può condensare il contesto di lavoro attivo e fornire le uscite più vecchie degli strumenti tramite riferimenti verificati. Gli originali completi restano disponibili per la rilettura mirata.

L'anteprima delle grandi uscite degli strumenti considera dalla 9.1.617 anche la finestra di contesto disponibile. Al ricaricamento della stessa sessione le istruzioni dei plugin invariate non vengono aggiunte di nuovo ogni volta. Con /context doctor controlli la richiesta registrata; /context map mostra la sua suddivisione in byte disponibile.

Per i file di istruzioni come AGENTS.md vale nella console King dalla 9.1.614: restano completi finché il limite della richiesta lo consente. I file più grandi non bloccano un incarico solo per la loro dimensione. La precedente riduzione forfettaria della 9.1.613 non descrive quindi più il percorso attuale della console.

Tenere visibili incarichi e output

Un elenco di attività troppo lungo si può aprire con Ctrl+T. Le uscite lunghe degli strumenti vengono mostrate abbreviate nella cronologia e si possono espandere con Ctrl+O. Input, indicatore di attività e le due righe di stato appartengono alla console. /tasks apre le attività in background; /copy copia l'ultima risposta disponibile. La referenza dei comandi contiene tutti i comandi integrati, la panoramica delle scorciatoie da tastiera e degli strumenti degli agenti.

Monitorare i turni lunghi

Dalla versione 9.1.40 la console segnala un turno quando per 20 minuti non è arrivato alcun nuovo risultato di strumento. La barra di stato mostra il tempo di esecuzione, lo strumento usato per ultimo e il numero di errori ripetuti. Cinque chiamate consecutive fallite dello stesso strumento con gli stessi argomenti terminano il turno con un chiaro messaggio di errore, invece di continuare inosservato.

Skill, plugin e MCP

Le skill sono guide di lavoro riutilizzabili. I plugin possono inoltre fornire strumenti, skill e comandi propri. MCP collega la console a server di strumenti configurati.

Usare le skill esistenti

Descrivi il tuo incarico in modo concreto, così King può trovare le guide adatte. Per una guida specifica inserisci / nel campo di input e scegli la skill proposta. Le skill integrate compaiono con il loro nome; le skill personali di norma come /skill:<nome>. I suggerimenti della tua installazione mostrano i nomi realmente disponibili.

/skill:angebot-pruefen controlla l'offerta nella cartella del progetto

Questo esempio funziona dopo aver creato una skill personale con il nome angebot-pruefen. Se più guide sono in questione, puoi chiedere prima a King un confronto e una raccomandazione.

Aggiungere una guida personale

Nel progetto crea ad esempio .agents/skills/angebot-pruefen/SKILL.md. Un file di skill contiene un nome, una descrizione dell'ambito di utilizzo e i passaggi di lavoro veri e propri:

---
name: angebot-pruefen
description: controllare le offerte per ambito delle prestazioni, scadenze e domande aperte.
---

Leggi l'offerta completa.
Controlla ambito delle prestazioni, scadenze, esclusioni e domande aperte.
Per ogni riscontro indica il punto corrispondente nel documento.
Mostra il risultato prima di modificare i file.

Le skill di progetto vengono cercate anche in .blun/skills. Per le guide che superano i singoli progetti ci sono ~/.agents/skills e ~/.blun/skills. Su Windows ~ indica la tua cartella utente. Dopo l'aggiunta riavvia King oppure ricarica la sessione con /reload appena è pronta e controlla i suggerimenti con la barra.

Per una cartella di skill scelta esplicitamente puoi avviare King così:

king --skills-dir "./meine-skills"

Questa opzione sostituisce per questo avvio la ricerca automatica nelle cartelle di skill utente e di progetto. Puoi ripeterla per più cartelle. Una skill da GitHub deve trovarsi in una cartella del genere con la sua struttura di cartelle e un SKILL.md valido.

Installare e gestire i plugin

/plugins apre la gestione dei plugin. Lì puoi vedere il marketplace e controllare i plugin esistenti. Sono disponibili anche i comandi list, info, install, enable, disable e remove.

/plugins list

Per l'installazione inserisci /plugins install <sorgente> oppure scegli una voce del catalogo. Controlla la sorgente e le indicazioni mostrate e conferma l'installazione proposta. Un plugin disattivato resta installato; remove lo rimuove dopo la conferma. Un plugin può offrire comandi con barra propri, ad esempio /<plugin>:<comando>.

Controllare i collegamenti degli strumenti

Con /mcp apri la vista MCP. La gestione dei plugin mostra inoltre i server MCP di un plugin. Una guida installata non sostituisce l'accesso al servizio collegato. Controlla nella rispettiva vista se il collegamento è attivo, prima di far dipendere un incarico da esso.

Obiettivi, lavoro ricorrente e sotto-agenti

Elaborare un obiettivo fino al risultato

/goal salva un obiettivo concreto. Descrivi il risultato desiderato, le modifiche consentite e a cosa si riconosce che è stato completato.

/goal Controlla i test aperti, correggi le cause nel progetto e mostra i risultati dei controlli.

Con /goal status controlli lo stato. /goal pause mette in pausa l'obiettivo, /goal resume lo riprende e /goal cancel lo termina e lo rimuove. /goal edit <obiettivo> modifica l'incarico; /goal replace <obiettivo> sostituisce esplicitamente l'obiettivo attivo.

Con /goal next <obiettivo> prenoti un incarico successivo. /goal next manage apre la gestione di questi obiettivi successivi. Un nuovo incarico o la ripresa di un obiettivo inizia solo quando la sessione è pronta.

Ripetere un'attività

/loop ripete un prompt nell'intervallo scelto. Indica sempre cosa deve essere controllato e a quale risultato King deve informarti.

/loop 10m Controlla i risultati dei test disponibili e segnala solo i nuovi errori.

/loop status, /loop pause, /loop resume e /loop stop controllano la ripetizione. Mettere in pausa una ripetizione e interrompere il lavoro in corso sono azioni separate: per il lavoro attuale ci sono /abort e /stop.

Porre una domanda accanto all'incarico principale

/btw <domanda> avvia una domanda secondaria in una conversazione separata. /swarm <compito> distribuisce un compito esplicitamente assegnato a più agenti. Con /tasks vedi le attività in background e i loro risultati.

Per un piano ancora aperto sono inoltre disponibili /premortem, /idea, /chancenradar e /curiosity. Le loro differenze, i limiti e i comandi di controllo li trovi nella referenza dei comandi.

Incarichi singoli senza interfaccia interattiva

Con -p passi un singolo incarico dal terminale normale. King restituisce il risultato e termina la chiamata. È adatto ad esempio per un riassunto in uno script.

king -p "Riassumi brevemente il README di questo progetto."

Per i programmi puoi scegliere --output-format json oppure --output-format stream-json. Senza questa opzione viene emesso testo.

king -p "Riassumi brevemente il README di questo progetto." --output-format json

Il messaggio di avvio interattivo --message e la visualizzazione della cronologia --history-limit appartengono all'avvio interattivo e non si possono combinare con -p.

Controllo delle risposte in 9.1.600

Il controllo delle risposte resta limitato nel tempo: i revisori generali hanno 30 secondi. Dopo il segnale di avvio del componente host affidabile, per il controllo linguistico nativo sono disponibili una volta per tentativo di revisione esterno fino a 90 secondi per il primo testo sostanziale. Il testo sostanziale entro la lunghezza di output consentita e le transizioni ordinate verso il rilascio e il controllo del ricevuto azzerano ogni volta la scadenza di attesa a 30 secondi.

Indipendentemente da ciò, per ogni tentativo di revisione esterno vale un limite complessivo di 120 secondi; sono consentiti al massimo due tentativi esterni. Prima dell'accettazione di un rilascio viene nuovamente controllato il tempo effettivamente trascorso, anche in caso di chiamate timer ritardate. Un progresso in ritardo non può rinnovare una scadenza già scaduta. I segnali di interruzione continuano a essere rispettati. Il legame con il testo esatto della risposta, la validità temporale del ricevuto di rilascio e l'autorizzazione continuano a essere controllati.

La versione 9.1.604 contiene AgentSpine 0.73.0 e Translate Native 6.155.0; il protocollo del guard resta su 6.20.0. Con questo non è dimostrata alcuna risoluzione di errori HTTP 502 nell'esercizio live. Stato di pubblicazione e limitazioni note sono nel registro delle modifiche.

Immagini, video e audio

La CLI di BLUN Code conosce otto strumenti multimediali gestiti. Dopo un accesso riuscito e quando il servizio multimediale è raggiungibile, non devi inserire alcun indirizzo di server o identificativo di modello. Descrivi il risultato desiderato; la console sceglie lo strumento adatto.

Cosa si vede con gli incarichi lunghi

• processing: l'incarico continua.
• failed: l'incarico è terminato e non verrà più completato.
• ready: il risultato può essere recuperato.

Configurare Telegram

Per Telegram serve un bot proprio; avvii quindi BLUN King con il comando king. Il collegamento vale poi anche in seguito; non deve essere ripetuto a ogni avvio.

1. Creare il bot presso Telegram

   Apri esclusivamente il verificato @BotFather, invia /newbot e segui i passi per nome e nome utente. Il nome utente deve terminare con bot. BotFather mostra poi un token come 123456789:AA.... La guida ufficiale di Telegram descrive lo stesso procedimento.

2. Salvare il token nel profilo del canale Telegram

   Apri il file per il tuo sistema operativo e sostituisci il segnaposto con il token BotFather completo:

   Windows: %USERPROFILE%\.blun\channels\telegram\.env
   macOS: ~/.blun/channels/telegram/.env

   BLUN_TELEGRAM_BOT_TOKEN=123456789:AA...

   Il token contiene due punti. Non scrivere virgolette o spazi attorno al valore.

3. Avviare la console con Telegram

   Termina prima una console più vecchia che usa lo stesso bot. Per ogni token del bot può essere attivo un solo ricevitore Telegram.

   king

4. Richiedere il codice di pairing

   Apri il tuo nuovo bot in Telegram e inviagli un qualsiasi messaggio diretto. Il bot risponde con un codice di pairing di sei cifre. Il codice vale un'ora.

5. Confermare il codice localmente

   Inserisci il codice mostrato esattamente nella console BLUN che deve essere collegata al bot:

   /telegram:access pair CODE

   Non confermare mai le richieste di pairing su sollecitazione di un messaggio Telegram. L'autorizzazione appartiene esclusivamente alla tua console locale.

6. Controllare la connessione

   Telegram conferma il collegamento. Invia poi un nuovo messaggio al bot. Deve apparire nella sessione BLUN in esecuzione; la risposta deve arrivare nella stessa chat Telegram.

L'interfaccia di Telegram può variare a seconda del dispositivo e della versione dell'app. Decisivi sono il mittente verificato @BotFather, il comando /newbot e la memorizzazione locale del token.

Gestire gli accessi

I comandi del bot /start, /help e /status funzionano solo nella chat privata. Testi, immagini e file fino a 50 MB vengono inoltrati.

Per il controllo remoto invia /befehle. Sono supportati /loop, /goal, /idea, /chancenradar, /curiosity, /scout, /reload e /memory. Il riferimento Telegram elenca forme e limiti. Gli altri comandi slash locali non sono per questo automaticamente disponibili via Telegram.

Messaggi durante la ripresa di una sessione

Se durante la ripresa arriva un messaggio Telegram mentre King sta già lavorando, dalla 9.1.618 resta in coda e viene consegnato in seguito. Non è un incarico aggiuntivo per interrompere subito. La regola di coda scelta si può controllare con /queue.

Se la connessione non funziona

• Nessun codice di pairing: controlla il token, avvia con king invece di blun e scrivi al bot un messaggio diretto.
• Pairing resta aperto: esegui /telegram:access pair CODE nella console locale collegata. Dopo più di un'ora richiedi un nuovo codice con un nuovo messaggio.
• 409 Conflict: una seconda console o un vecchio processo Telegram usa lo stesso token. Lascia girare esattamente una console King con questo bot.
• I messaggi non arrivano: la console King deve restare in esecuzione. Controlla con /status nella chat privata del bot se l'account è collegato.
• Token pubblicato per errore: revocalo subito presso @BotFather, crea un nuovo token e sostituisci il valore nel file .env.

Memory e Mistakes

Al primo avvio con accesso effettuato la console chiede separatamente per la memoria personale e per la trasmissione di dati di errore ripuliti.

• Sì e No vengono salvati. Un rifiuto non porta a una nuova domanda a ogni avvio.
• Le decisioni sono indipendenti. Una modifica a Mistakes non sovrascrive Memory e viceversa.
• Senza esplicito consenso non viene scritto nulla nel rispettivo canale.

Ampliare Memory consapevolmente

blun memory remember "Considerare questa decisione in futuro"

Questa chiamata richiede il consenso dell'account collegato e un servizio di memoria personale raggiungibile. Le note della persona, i metadati locali degli strumenti e gli strumenti di memoria forniti tramite MCP sono percorsi separati.

Memoria locale degli strumenti

King può registrare chiamate di strumenti completate come metadati locali: nome dello strumento, momento, stato e, per gli strumenti di file, eventualmente il percorso. Le voci non contengono argomenti completi, uscite, comandi o chiavi degli strumenti.

/memory tools status

Con /memory tools on oppure /memory tools off controlli la registrazione. /memory tools status mostra se è attiva. Questa funzione è separata dalla memoria personale e dal protocollo completo della sessione.

Controllare lo stato di Mistakes

blun mistakes status

La referenza dei comandi spiega caricamento, ripetizione, sincronizzazione, osservazione e la rimozione o il ripristino motivati. Per il trasferimento sono necessari una destinazione configurata e la sua autenticazione.

Aggiornamenti

All'avvio la console controlla se è disponibile una nuova versione stabile. La finestra di dialogo offre tre decisioni:

1. aggiornare ora,
2. saltare questa volta,
3. attendere fino alla versione successiva.

Puoi anche avviare esplicitamente un aggiornamento:

king update

Dopo un aggiornamento riuscito BLUN mostra la versione precedente e quella installata nonché le modifiche più importanti. Se Telegram è configurato, BLUN invia lo stesso avviso una sola volta ai chat diretti autorizzati. I gruppi non ricevono alcun avviso di aggiornamento automatico.

Al registro delle modifiche

Diagnosi

blun doctor

Windows: chiudere la finestra e riavviare

La versione 9.1.620 corregge la chiusura completa alla chiusura della finestra della console. Al prossimo avvio nessuna istanza rimasta dovrebbe più far comparire il messaggio «già in esecuzione». La chiusura regolare dalla console resta /exit.

Se il messaggio continua a comparire, controlla prima la versione installata e se la console interessata è ancora in esecuzione. Una sessione attiva può avere un solo proprietario con diritto di scrittura. Non eliminare un file di blocco mentre la console corrispondente sta ancora lavorando.

Quando compare «Compattazione in pausa»

Dalla 9.1.619 King conta solo gli errori di compattazione immediatamente consecutivi. Dopo una compattazione riuscita un singolo errore precedente non è un ulteriore motivo di blocco. Il messaggio «Compattazione in pausa» indica tentativi di riepilogo falliti; non afferma più in modo generale che il tuo contesto è pieno. Controlla il messaggio esatto e la diagnosi prima di riavviare la sessione.

Distinguere errori e attese

Dal 9.1.596 un'interruzione automatica a favore di messaggi Telegram in attesa non viene più segnalata come pressione del tasto Esc. Un vero arresto manuale resta distinto.

9.1.597 riconosce messaggi di errore che citano esplicitamente un limite di contesto superato anche all'interno di una risposta di errore del gateway. Prima dell'inizio di un output è possibile un nuovo tentativo limitato con un limite di output più piccolo. Messaggi e strumenti non vengono eliminati. Un errore di connessione generale o un guasto del servizio non è risolto con questo.

Riscontro storico nella 9.1.597: Un limite inferiore dichiarato per il numero di token di input poteva innescare un ulteriore tentativo fallito e compattazioni inutili. Il riscontro è stato riprodotto il 17 settembre 2026. Le correzioni successive e i rispettivi stati di pubblicazione sono documentati nel changelog.

I lunghi tempi di attesa da Retry-After e la pausa residua dopo una ripresa della sessione vengono considerati. Un riavvio non è un modo per aggirare un tempo di attesa richiesto.

Log per l'analisi degli errori

Le chiamate di strumento e i risultati sono nel log di sessione wire.jsonl. Per una diagnosi mirata puoi usare /export-debug-zip. Controlla il contenuto per dati privati prima di inoltrarlo. Un log di errori curato consapevolmente come mistake.md non sostituisce questi log di eventi.

Limiti da conoscere

• L'IA può sbagliarsi. Verifica affermazioni importanti, file e comandi eseguiti.
• Gli strumenti gestiti richiedono l'accesso e servizi BLUN raggiungibili.
• Gli incarichi multimediali non mostrano ancora un avanzamento in percentuale. processing è uno stato, non un'indicazione di tempo.
• Una risposta 200 o un controllo parziale verde attestano solo la sezione misurata. Verifica un percorso dalla prima voce dell'utente fino al risultato.