BLUN Code · Riferimento completo
Comandi e strumenti
I comandi slash iniziano con / e si scrivono nel campo di input della console BLUN in esecuzione. I comandi del sistema operativo come king update, king --version, npm o node appartengono invece a PowerShell o a un altro terminale.
Avvio rapido
Con /help vedi i comandi della tua versione installata. Dai un nome al tuo agente con /name Ada oppure avvia un'attività ricorrente con /loop 10m controlla lo stato della build.
Idee, opportunità e realizzazione autonoma
Questi comandi si distinguono per l'incarico: /idea e /chancenradar lavorano nell'ambito espressamente indicato. /curiosity si limita a fare ricerche e non realizza nulla.
/idea <Obiettivo>
Cosa fa il comando: BLUN crea prima un elenco di compiti concreto e lavora l'obiettivo indicato fino a ottenere un risultato verificato. Un rapporto di ricerca, un concetto o una bozza può già essere il risultato completo. Una realizzazione viene avviata solo se fa parte dell'incarico. Durante il lavoro resta attivo esattamente un passaggio del piano.
Quando è utile: Usa /idea quando un'idea vaga deve diventare un risultato concreto e non vuoi indicare ogni passaggio intermedio singolarmente.
/idea sviluppa un miglior percorso di onboarding per i nuovi clientiCosa succede dopo: BLUN lavora finché ogni punto non è terminato, bloccato in modo comprensibile, annullato o preparato per l'approvazione. Valgono la stessa modalità di autorizzazione e le stesse indicazioni espresse che valgono al di fuori di /idea. La modalità non concede autorizzazioni aggiuntive e non revoca un divieto di modifica o di pubblicazione.
Controllo: /idea status, /idea pause, /idea resume, /idea stop e /idea clear gestiscono la modalità in corso.
/chancenradar <Obiettivo>
Cosa fa il comando: Il radar delle opportunità cerca nelle fonti pubbliche attuali problemi concreti non ancora ben risolti. Registra le fonti e la data di consultazione, separa le osservazioni dalle conclusioni e da ciò che è sconosciuto e valuta ogni opportunità seria in base al problema, alle persone coinvolte, alle prove, alle alternative esistenti, all'impatto, allo sforzo e alla sicurezza.
Quando è utile: Usa il comando quando vuoi trovare non un'idea qualsiasi, ma l'opportunità di prodotto, mercato o miglioramento meglio documentata.
/chancenradar trova la migliore nuova funzione per il nostro software di contabilitàCosa succede dopo: I risultati deboli o doppi vengono scartati. BLUN motiva l'ordine di priorità, sceglie l'opportunità più solida ed esegue il miglior passo locale sicuro successivo. Non si inventano la dimensione del mercato, la domanda, le opinioni degli utenti né la portata.
/curiosity [Settore o problema]
Cosa fa il comando: /curiosity avvia un viaggio di scoperta aperto ma strutturato. Con un tema, BLUN cerca connessioni sorprendenti e opportunità inutilizzate. Senza tema, BLUN aiuta prima a scegliere una nicchia adatta. L'alias è /scout.
Quando è utile: Usa la modalità quando la direzione non è ancora definita, vuoi scoprire qualcosa di nuovo e la ricerca deve comunque portare a una decisione motivata e a un passo successivo.
/curiosity strumenti digitali per le piccole imprese artigianeCosa succede dopo: BLUN esamina al massimo dodici pagine di fonti con complessivamente al massimo 24 tentativi di consultazione. Il rapporto nomina fino a tre possibilità documentate oppure dichiara espressamente che non è stato trovato alcun risultato praticabile. I file non vengono modificati, non vengono avviati subagenti né cicli in background. A ogni possibilità motivata può appartenere un incarico /idea preparato; solo la sua selezione apre un incarico di realizzazione separato.
Avvio, cronologia ed export
| Comando | Cosa succede | Alias o esempio |
|---|---|---|
| /help | Mostra i comandi e le scorciatoie da tastiera attualmente disponibili. | /h, /? |
| /new | Avvia una nuova sessione nell'area di lavoro attuale. Le sessioni salvate in precedenza non vengono eliminate. | /clear |
| /sessions [ID|Titolo] | Apre la selezione delle sessioni oppure sceglie una sessione in base al suo identificativo esatto, al suo titolo esatto o a un prefisso univoco dell'identificativo. In caso di più risultati si apre la selezione. | /resume, /session |
| /profile | Apri la selezione del profilo. King cambia solo quando la tua sessione è pronta; il lavoro in corso e i messaggi in attesa impediscono un cambio prematuro, il tuo profilo precedente resta allora attivo. | /profiles |
| /question | Riapre le domande di chiarimento in sospeso. Comprimerle non risponde né scarta una domanda. | /question |
| /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. | /queue collect debounce:500ms batch:10 |
| /fork | Dirama la sessione attuale. La nuova sessione inizia con la cronologia finora esistente; non viene creato alcun branch Git. | /fork |
| /title [Titolo] | Mostra il titolo della sessione o salva un nuovo titolo con fino a 200 caratteri. | /rename API-ristrutturazione |
| /compact [Indicazione] | Condensa le parti più vecchie della conversazione tramite un riepilogo del modello. Un'istruzione facoltativa stabilisce cosa deve essere conservato. I file di istruzioni come AGENTS.md non vengono modificati; il riepilogo può consumare token. | /offload; esempio: /compact conserva i test aperti |
| /undo [Numero] | Ritira l'ultimo prompt o più inserimenti propri dalla cronologia. Le modifiche ai file già eseguite o le azioni esterne non vengono annullate automaticamente. | /undo 2 |
| /export-md [Percorso] | Esporta la sessione attuale come file Markdown. Controlla i contenuti privati della conversazione prima di inoltrarli. | /export |
| /copy | Copia negli appunti l'ultima risposta disponibile dell'assistente. | /copy |
| /export-debug-zip | Crea uno ZIP di debug della sessione attuale per un'analisi mirata degli errori. Controlla i dati diagnostici e di conversazione contenuti prima di inoltrarli. | /export-debug-zip |
| /web | Apre la sessione attuale nell'interfaccia web e termina la visualizzazione del terminale. | /web |
| /exit | Termina BLUN Code. | /quit, /q |
| /version | Mostra la versione installata e le informazioni di versione corrispondenti. | /version |
Lavoro e automazione
| Comando | Cosa succede | Esempio |
|---|---|---|
| /abort | Interrompe il processo in corso senza scartare gli input in attesa. | /abort |
| /stop | Interrompe il processo in corso e scarta gli input in attesa. La console non viene terminata per questo. | /stop |
| /god | Attiva la modalità di autorizzazione più ampia. Le regole di protezione e le azioni esterne o pericolose espressamente bloccate restano efficaci. | /yolo, /yes |
| /goal [Azione o obiettivo] | Avvia o gestisce un obiettivo. Senza argomento il comando mostra lo stato. pause mette in pausa l'obiettivo, resume lo riprende e cancel lo rimuove; clear e stop sono equivalenti a questo scopo. edit <obiettivo> modifica l'incarico, replace <obiettivo> lo sostituisce. next <obiettivo> prenota un incarico successivo e next manage apre la relativa gestione. | /goal ripara tutti i test rossi |
| /loop [Intervallo] [Prompt] | Avvia o gestisce un prompt ricorrente. Prima dell'intervallo sono ammessi start e parole di riempimento come mit, alle o jede. Senza argomento il comando mostra lo stato; pause, resume e stop controllano l'esecuzione. Se manca un intervallo valido, BLUN mostra la forma corretta del comando invece di un messaggio tecnico sull'intervallo. | /loop mit 5m controlla il servizio |
| /premortem [Piano o decisione] | Controlla un piano prima della realizzazione per individuare i punti deboli. BLUN parte dal presupposto che il piano sia fallito, ordina le cause di errore plausibili in base a impatto e probabilità, nomina segnali di allarme precoci, contromisure, nonché punti di interruzione e di decisione, e conclude con i tre passi più efficaci per ridurre il rischio. Il piano resta visibile nella chat; l'incarico di analisi viene aggiunto internamente. | /premortem pubblica oggi la nuova API |
| /swarm [on|off|Compito] | Commuta la modalità swarm oppure esegue esattamente un compito nello swarm. Ulteriori agenti possono causare un consumo aggiuntivo di token; il runtime deve supportare lo swarm. | /swarm controlla frontend e API |
| /btw [Domanda] | Pone una domanda a un agente secondario diramato senza sostituire l'incarico principale. Il lavoro aggiuntivo del modello può consumare token. | /aside, /side; /btw quali test sono ancora rossi? |
| /tasks | Apre la panoramica dei compiti in background in corso e terminati. | /task |
| /improve | Mostra i candidati di apprendimento salvati e il loro stato. Il comando è una panoramica, non un'approvazione generale delle modifiche. | /learning |
| /init | Analizza la base di codice aperta e crea un AGENTS.md adatto. | /init |
Impostazioni e visualizzazione
| Comando | Cosa succede | Alias o esempio |
|---|---|---|
| /auto [on|off] | Attiva o disattiva la modalità di autorizzazione automatica. Senza argomento viene commutata la modalità attuale. | /auto on |
| /permission | Apre la selezione della modalità di autorizzazione. | /permission |
| /settings | Apre le impostazioni, comprese le opzioni di visualizzazione locali. | /config |
| /output-style | Apre la selezione dello stile di output preferito. Sono disponibili Standard, Conciso, Proattivo, Esplicativo e Apprendimento. La selezione vale subito e viene salvata come predefinita. | /style |
| /plan [on|off|clear] | Attiva o disattiva la modalità piano. clear rimuove un piano esistente ed è possibile solo in stato di inattività. | /plan on |
| /effort [Livello] | Apre la selezione dell'effort oppure modifica lo sforzo di riflessione del modello. L'adozione richiede un limite di richieste libero; vengono offerti solo i livelli supportati dal modello. | /thinking high |
| /name [Nome] | Mostra il nome dell'agente oppure salva un nome personale con fino a 40 caratteri. King tenta poi di ricaricare il contesto della sessione. | /name Ada |
| /persona [name …|note …] | Mostra la persona. name modifica il nome, note, remember o merke aggiunge una nota con fino a 200 caratteri. reset svuota la persona; export mostra i suoi dati. Le note della persona sono separate dalla memoria personale dell'account. | /persona note Rispondi in modo conciso |
| /language [Lingua] | Mostra o modifica la lingua dell'interfaccia e delle risposte. | /languages Deutsch |
| /theme [Tema] | Apre la selezione del tema oppure imposta un tema direttamente. | /theme |
| /editor [Comando] | Mostra o imposta l'editor esterno che si apre con Ctrl-G. | /editor code --wait |
| /reload | Ricarica la sessione e adotta le impostazioni di runtime e dell'interfaccia. | /reload |
| /reload-tui | Ricarica solo le impostazioni dell'interfaccia del terminale; la sessione resta. | /reload-tui |
| /status | Mostra lo stato attuale della sessione e del runtime. | /status |
| /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. | /usage full |
| /context | Mostra il contesto di richiesta stimato, il limite di contesto effettivo e lo spazio rimanente calcolato. map mostra la ripartizione dei byte disponibile; list, detail e doctor aprono il rapporto dettagliato. | /context |
| /context-doctor | Distingue lo storico salvato, i conteggi di token stimati e il numero di byte della richiesta serializzata. Mostra i contributi registrati delle regole AGENTS, dei file Mistake, di Memory, delle Skills e delle definizioni degli strumenti. La mancanza di dati di origine non significa zero byte. | /tokens, /context doctor |
| /summarization-model [Modello|inherit] | Apre la selezione del modello di compattazione oppure imposta un modello configurato. inherit adotta il modello della sessione. Le modifiche sono possibili solo in stato di inattività. La selezione viene salvata e la stessa sessione viene ricaricata. | /summary-model, /compaction-model |
Servizi, accessi e aree di lavoro
| Comando | Cosa succede | Alias o esempio |
|---|---|---|
| /mcp | Mostra lo stato dei server MCP e apre la loro gestione. | /mcp |
| /plugins | Apre la gestione dei plugin. Lì i plugin possono essere cercati, installati, attivati, disattivati, ricaricati o rimossi. | /plugins |
| /agent-spine | Installa un plugin AgentSpine mancante, attiva un plugin disattivato oppure apre la sua gestione se è già attivo. La via normale per plugin e approvazioni resta efficace. | /agent-spine |
| /telegram-access | Gestisce il token del bot Telegram e le chat che possono inviare messaggi. | /telegram-acces |
| /add-dir [list|Percorso] | Elenca cartelle di lavoro aggiuntive oppure aggiunge un'altra cartella. | /add-dir ../api |
| /experiments | Apre la gestione delle funzioni sperimentali. | /experimental |
| /memory status|on|off | Mostra lo stato della memoria personale oppure la attiva o disattiva secondo la tua decisione. /memory tools status|on|off controlla separatamente i metadati locali degli strumenti. | /memory status |
| /login | Seleziona una piattaforma e avvia l'accesso. | /login |
| /logout | Ti disconnette da un fornitore configurato. Le sessioni salvate non vengono eliminate. | /disconnect |
| /feedback | Apre il dialogo per inviare un feedback a BLUN. | /feedback |
Comandi di Skills e plugin
La guida CLI spiega passo dopo passo i file di skill personali, l'installazione dei plugin e le connessioni MCP. Obiettivi e incarichi ricorrenti sono descritti in Obiettivi e automazione.
Oltre ai 58 comandi di console integrati, la tua installazione può fornire comandi dinamici. Per questo /help è l'elenco determinante per il computer concreto.
| Forma | Significato | Esempio |
|---|---|---|
| /<skill-name> [Incarico] | Avvia una guida offerta con questo nome nella selezione con barra, ad esempio una skill integrata. Le skill personali compaiono di norma con il namespace skill:. | /screenshot-lesen controlla questa immagine |
| /skill:<name> [Incarico] | Avvia una Skill personalizzata tramite il suo spazio dei nomi completo. | /skill:il-mio-tester src |
| /<plugin>:<comando> [Argomenti] | Esegue un comando slash registrato da un plugin attivo. | /il-mio-plugin:stato |
Nomi sconosciuti
Un nome slash sconosciuto viene trattato come un normale messaggio per l'agente. Controlla quindi l'ortografia con /help se ti aspettavi un comando integrato.
Comandi nel terminale del sistema operativo
Questi comandi appartengono a PowerShell, al prompt dei comandi o al tuo altro terminale. Per i sottocomandi usa blun: un singolo nome dopo king può essere interpretato come nome del profilo. <…> indica un valore obbligatorio, […] un'indicazione facoltativa. I valori con spazi li metti tra virgolette; le parentesi non si digitano.
Lo stato 9.1.620 registra 36 percorsi di comando CLI pubblici incluse le relative voci di gruppo. I gruppi aprono un aiuto oppure offrono sottocomandi; non sono 36 azioni indipendenti tra loro. Tutte le opzioni aggiuntive le mostra blun <comando> --help.
Avvio, accesso e diagnostica
| Sintassi | Effetto e prerequisiti |
|---|---|
| blun upgrade | Installa la versione stabile attuale. Anche blun update è un alias.Nota: Un aggiornamento modifica l'installazione; le sessioni già caricate usano il codice precedente fino al riavvio. |
| blun login [--api-key-stdin] | Avvia l'accesso. Con --api-key-stdin una chiave API viene ripresa dall'input standard.Nota: Senza questa opzione King usa il normale percorso del browser oppure il codice del dispositivo. |
| blun doctor | Controlla i file di configurazione per impostazioni non valide. Nota: È anche il gruppo dei due controlli mirati qui sotto. Un esito errato restituisce uno stato di errore. |
| blun doctor config [<percorso>] [--schema] | Controlla config.toml; un percorso seleziona un altro file.Nota: --schema restituisce il riferimento dei campi come JSON Schema, senza leggere alcun file di configurazione. |
| blun doctor tui [<percorso>] [--schema] | Controlla le impostazioni in tui.toml.Nota: --schema restituisce invece il riferimento dei campi. Il comando non ricarica l'interfaccia. |
| blun acp [--login] | Fornisce il collegamento ACP per un client compatibile tramite input e output standard. Nota: --login esegue solo l'accesso tramite codice del dispositivo e termina poi la chiamata. |
| blun export [<id-sessione>] [-o <percorso>] [--no-include-global-log] | Esporta una sessione come ZIP. Senza identificatore viene scelta la sessione più recente; -y salta la conferma per una sessione precedente.Nota: Di norma è incluso anche il registro diagnostico globale attivo, non i file .1 ruotati. Controlla lo ZIP prima di inoltrarlo. --no-include-global-log lascia fuori questo registro. |
| blun vis [<id-sessione>] [--no-open] [--host <host>] [--port <numero>] | Apre la vista diagnostica locale di una sessione. Nota: Di norma usa un indirizzo locale e una porta libera. --no-open impedisce l'apertura del browser. |
Memoria personale e Mistakes
| Sintassi | Effetto e prerequisiti |
|---|---|
| blun memory --help | Mostra i sottocomandi per la memoria personale dell'account. Nota: Questo gruppo è separato dalla memoria locale degli strumenti e dagli strumenti MCP. |
| blun memory remember <testo...> | Salva un ricordo personale esplicitamente desiderato. Nota: Richiede il consenso salvato dell'account collegato e un servizio di memoria personale raggiungibile. |
| blun mistakes --help | Mostra i comandi per trasferire e gestire i dati degli errori. Nota: Per il trasferimento devono essere configurati indirizzo di destinazione e autenticazione. Questi comandi non sostituiscono alcun consenso. |
| blun mistakes upload <percorso> --source <identificatore> | Riprende i dati degli errori con un identificatore di origine nella coda locale di uscita e tenta il trasferimento. Nota: --source è obbligatorio. I dati non trasferiti con successo possono restare nella coda di uscita. |
| blun mistakes retry | Tenta nuovamente i trasferimenti ancora in sospeso dalla coda di uscita locale. Nota: Richiede lo stesso servizio configurato dell'upload. La chiamata non è una prova di consegna riuscita. |
| blun mistakes sync --config <percorso> | Sincronizza le fonti registrate in una configurazione JSON. Nota: --config è obbligatorio; il file definisce le fonti. Indirizzo di destinazione e coda di uscita possono essere configurati di conseguenza. |
| blun mistakes watch --config <percorso> [--interval <secondi>] | Ripete la sincronizzazione in primo piano; l'intervallo standard è di 300 secondi. Nota: Resta in esecuzione fino all'interruzione, ad esempio con Ctrl+C. Non viene installato alcun servizio del sistema operativo. |
| blun mistakes status [--no-fail-on-red] | Interroga consistenza, attualità e stato di sorveglianza presso il servizio configurato. Nota: Un esito rosso restituisce di norma il codice di uscita 2. --no-fail-on-red sopprime questo stato di errore. |
| blun mistakes remove <id-evento> --reason <testo> | Contrassegna un evento di errore come rimosso con una motivazione. Nota: La motivazione è obbligatoria. I dati grezzi non vengono eliminati; la modifica viene salvata come marcatore aggiuntivo. |
| blun mistakes restore <id-evento> --reason <testo> | Contrassegna un evento precedentemente rimosso come ripristinato con una motivazione. Nota: Richiede il servizio configurato. Anche il ripristino aggiunge un marcatore invece di riscrivere i dati originali. |
Server locale e interfaccia web
| Sintassi | Effetto e prerequisiti |
|---|---|
| blun server --help | Mostra i comandi registrati del server King locale. Nota: Il gruppo da solo non avvia alcun server. |
| blun server run [--foreground] [--open] | Avvia il server locale in background. --foreground lo lega al terminale; --open apre l'interfaccia web.Nota: L'indirizzo standard è raggiungibile solo localmente. Un'altra associazione viene scelta esplicitamente con le opzioni del server. |
| blun server kill | Termina il server locale prima tramite la sua API; se necessario segue l'interruzione del processo tramite la sua PID. Nota: I client collegati perdono la connessione. |
| blun server ps [--json] | Elenca le connessioni al server locale; su richiesta come JSON. Nota: Mostra le connessioni del server e non è un elenco generale dei processi del sistema operativo. |
| blun server rotate-token | Genera e salva un nuovo token di accesso per il server locale. Nota: Il token precedente diventa immediatamente non valido. I client devono eventualmente essere ricollegati con il nuovo token. |
| blun web | Fornisce l'interfaccia web locale e la apre nel browser. Nota: La chiamata di terminale è separata dal comando con barra /web: questo trasmette la sessione attuale alla vista web e termina la vista di terminale. |
Briefing, prove e passaggio di consegne
| Sintassi | Effetto e prerequisiti |
|---|---|
| blun brief --objective <testo> --outcome <testo> --rollback <testo> | Crea un briefing di progetto versionato con obiettivo, risultato e via di ritorno. Facoltativamente --step, --accept, --constraint e --decision completano l'incarico; sono ripetibili.Nota: Tutte e tre le opzioni mostrate sono obbligatorie. --workflow imposta l'identificatore comune; senza indicazione viene generato. Il file JSON si trova sotto BLUN_HOME/workflow e non sovrascrive alcuna uscita esistente. |
| blun proof [--check <comando>] [--artifact <percorso>] [--screenshot <percorso>] | Esegue comandi di verifica esplicitamente passati e registra le somme di controllo dei file di prova indicati. Tutte e tre le opzioni sono ripetibili; i percorsi dei file si riferiscono all'area di lavoro. Nota: Un comando di verifica può eseguire egli stesso modifiche. L'uscita JSON si trova nella directory privata delle prove; un file di uscita esistente non viene sovrascritto. La somma di controllo attesta l'integrità del contenuto, non la paternità o un'autorizzazione generale. |
| blun handoff <id-sessione> --workflow <identificatore> | Crea un passaggio di consegne portabile per continuare la stessa sessione in CLI, desktop o web. Nota: Facoltativamente --brief, --brief-hash, --proof e --proof-attestation integrano riferimenti e somme di controllo. Un file di passaggio non crea alcuna sessione e non prova un'interfaccia di destinazione collegata con successo. |
| blun replay <documenti...> | Ricostruisce una cronologia leggibile dai documenti di workflow ripuliti. Nota: Usa i file briefing, passaggio e guard passati. Non viene rieseguita alcuna azione originale degli strumenti. |
| blun guard <file-prova> --workflow <identificatore> | Verifica l'integrità della prova e l'attualità dei file associati. --workspace imposta l'area di lavoro; --artifact identificatore=percorso associa le prove ed è ripetibile.Nota: Prove mancanti o non valide portano a un errore. Questo controllo di workflow è separato dal controllo linguistico configurato per le risposte. |
| blun demo --brief <percorso> --guard <percorso> --replay <percorso> | Crea una rappresentazione HTML ripulita e autonoma del workflow documentato. Facoltativi sono --handoff e --title.Nota: I tre file mostrati sono obbligatori. Il risultato è una demo di workflow statica; l'anteprima CLI animata nell'introduzione dei docs è una rappresentazione separata. |
Aree di lavoro Git isolate
| Sintassi | Effetto e prerequisiti |
|---|---|
| blun workspace --help | Mostra la gestione delle aree di lavoro Git isolate. Nota: Richiede un'area di lavoro Git adatta; l'isolamento riguarda file e branch, non account o sessioni. |
| blun workspace create <nome> | Crea un worktree Git isolato dal commit attuale. Nota: Le modifiche non committate non vengono copiate automaticamente. Il checkout originale non viene ripristinato. |
| blun workspace list | Elenca le aree di lavoro isolate gestite da King. Nota: Non gestisce directory qualsiasi o estranee. |
| blun workspace preview <nome> | Mostra lo stato ripulito dell'area di lavoro isolata. Nota: L'anteprima non contiene contenuti di diff completi. |
| blun workspace reset <nome> --yes | Ripristina l'area di lavoro isolata al suo commit di partenza. Nota: --yes è necessario per l'esecuzione. Le modifiche in quest'area di lavoro vengono scartate. |
| blun workspace remove <nome> --yes | Rimuove il worktree isolato e il suo branch gestito. Nota: --yes è necessario per l'esecuzione. Salva prima il lavoro necessario. |
Per proof e i comandi di workflow -o rispettivamente --output scelgono il file di uscita. I file di workflow condividono un identificatore; briefing, prova, controllo di integrità e passaggio restano passaggi separati.
Ulteriori helper nel launcher
blun tools list mostra gli strumenti offerti dal launcher. Con blun tools enable <nomi...> configuri esplicitamente le voci selezionate. Usa i nomi dell'elenco; rimane necessario un accesso o una configurazione richiesta. Questi due helper del launcher non contano tra i 36 percorsi CLI registrati.
Opzioni per l'avvio della console
Queste opzioni stanno dietro blun o king quando avvii la console. La guida CLI contiene esempi per un singolo incarico senza interfaccia interattiva.
| Opzione | Uso |
|---|---|
| --help, -h --version, -V | Mostra l'aiuto rispettivamente la versione installata. |
| --session [<id>], -S --continue, -c | Apre la selezione delle sessioni oppure continua una sessione specifica; --continue continua la sessione precedente di questa cartella di lavoro. |
| --message <testo> | Trasmette dopo l'avvio interattivo un primo messaggio. Non combinare con --prompt; il testo non viene eseguito come comando con barra o comando di shell. |
| --history-limit <numero> | Carica inizialmente da 1 a 2000 voci di cronologia, di norma 200. Questo limita la visualizzazione all'avvio interattivo e non elimina messaggi più vecchi; non combinare con --prompt. |
| --prompt <testo>, -p --output-format <formato> | Esegue un singolo incarico senza interfaccia interattiva. Formati: text, json, stream-json; senza indicazione text. |
| --fork-session <id> | Dirama una sessione esistente per l'incarico singolo con prompt. |
| --plan | Avvia in modalità piano. |
| --permission-mode <modo> --auto --yolo, -y | Sceglie manual, auto o yolo. --auto imposta la modalità di autorizzazione automatica; --yolo conferma automaticamente le azioni ordinarie. Queste opzioni non sostituiscono limiti espliciti dell'utente. |
| --effort <livello> | Sceglie low, medium, high, xhigh o max, per quanto supportato dal modello attivo. Swarm viene gestito separatamente. |
| --settings <percorso> | Usa un altro config.toml per questa sessione. |
| --allowed-tools <nomi> | Limita la selezione degli strumenti ai nomi separati da virgola, ad esempio Read,Grep,Glob. Non rende disponibili strumenti mancanti e non revoca i controlli di autorizzazione. |
| --add-dir <cartella> | Aggiunge una cartella dell'area di lavoro; possibile più volte. |
| --skills-dir <cartella> | Carica le skill da cartelle esplicitamente indicate invece che dalle cartelle utente e di progetto trovate automaticamente; possibile più volte. |
| king --profile <nome> | Opzione del launcher esclusivamente per king: sceglie un profilo King separato. blun --profile non è un'opzione corrispondente. |
Strumenti che l'agente usa
Descrivi cosa deve essere fatto; King sceglie gli strumenti disponibili per questo. I nomi seguenti sono identificatori di strumenti per l'agente, non ulteriori comandi di terminale o con barra.
Lo stato della fonte contiene 44 possibili registrazioni di strumenti integrati. Quali di essi la tua sessione offre effettivamente dipende da modello, servizi, runtime, skill e autorizzazioni. Plugin e MCP possono aggiungere ulteriori strumenti. La ricerca degli strumenti può caricare le descrizioni secondo necessità; non è una voce aggiuntiva di questo elenco di 44.
File, ricerca e shell
| Strumento | Compito | Disponibilità e limiti |
|---|---|---|
| Read | Legge un file di testo o un intervallo di righe. I file grandi vengono letti a pagine. | Valgono area di lavoro, regole di accesso e limiti di lettura. |
| ReadBatch | Legge insieme da due a dodici file UTF-8 già noti e indipendenti, oppure intervalli. I risultati restano ordinati; i singoli errori vengono segnalati separatamente. | Stesse regole e limiti di Read; nessun sostituto per una ricerca di percorsi sconosciuti. |
| Write | Scrive un file secondo il protocollo di scrittura previsto. | Valgono diritti di scrittura e conferme; i contenuti grandi possono richiedere più continuazioni. |
| Edit | Modifica punti mirati di un file esistente. | Richiede posizioni di ricerca univoche e diritto di scrittura. |
| Grep | Cerca modelli di testo nell'area di lavoro. | I risultati possono essere limitati o forniti a pagine. |
| Glob | Trova percorsi di file in base a un modello. | Cerca nomi e percorsi; non legge automaticamente il contenuto dei file. |
| Bash | Esegue comandi di shell e fornisce uscita e codice di uscita. | Valgono la modalità di autorizzazione e i limiti di tempo. L'esecuzione in background deve essere consentita nel runtime. |
| CodebaseSearch | Cerca punti adatti nella codebase. | Richiede una cartella di progetto adatta e il relativo indice di ricerca. |
| LSP | Interroga il language server configurato su codice e diagnostiche. | Solo con servizio LSP presente e language server adatto. |
| ReadMediaFile | Legge un file immagine o video locale per un modello adatto. | Solo con supporto per l'ingresso di immagini o video; accesso ai file ed eventualmente upload devono essere disponibili. |
Pianificazione, contesto e collaborazione
| Strumento | Compito | Disponibilità e limiti |
|---|---|---|
| EnterPlanMode | Passa alla modalità piano. | Continuano a valere le regole di questa modalità e le autorizzazioni esistenti. |
| ExitPlanMode | Termina la modalità piano tramite la transizione prevista verso l'esecuzione. | Un piano non sostituisce il consenso necessario alle sue azioni. |
| TodoList | Crea o aggiorna l'elenco delle attività. | Documenta il progresso; non esegue le attività solo elencandole. |
| CreateGoal | Crea un obiettivo esplicitamente incaricato. | Gli strumenti degli obiettivi devono essere attivati; nessun sostituto di un incarico dell'utente. |
| GetGoal | Legge lo stato attuale dell'obiettivo e i suoi limiti. | Gli strumenti degli obiettivi devono essere attivati. |
| SetGoalBudget | Imposta un limite esplicitamente indicato per token, mosse o tempo di esecuzione. | Gli strumenti degli obiettivi devono essere attivati. Un limite non è una previsione di costi. |
| UpdateGoal | Aggiorna lo stato dell'obiettivo in corso. | Sono necessari strumenti degli obiettivi e un obiettivo esistente; lo stato segnalato deve corrispondere al risultato effettivo. |
| AskUserQuestion | Pone una richiesta strutturata con possibili risposte disponibili. | Solo se l'interfaccia fornisce la funzione di richiesta. |
| CompactConversation | Condensa le parti più vecchie della conversazione dopo il passo di strumento attuale in un riepilogo di continuazione. | Solo alla soglia di contesto sicura. Non aggira una compattazione in pausa e non rimuove alcuna cronologia non riepilogata. |
| ProgrammaticTool | Coordina più chiamate di strumenti BLUN esplicitamente indicate con JavaScript limitato. | L'interprete non ha accesso proprio a file, rete o processi. Ogni chiamata di strumento passa comunque attraverso i normali controlli di autorizzazione. |
| Skill | Carica una guida di lavoro disponibile per un incarico adatto. | Solo se sono presenti skill richiamabili. La guida non conferisce diritti aggiuntivi. |
| Agent | Delega un compito parziale concreto a un sotto-agente. | Richiede il runtime dei sotto-agenti; l'esecuzione in background dipende dalla configurazione. Ulteriori chiamate del modello possono consumare token. |
| AgentSwarm | Coordina più agenti per un incarico comune. | Richiede il runtime dei sotto-agenti e una configurazione adatta. Swarm è una modalità di lavoro propria, non un livello di effort. |
| MistakeRecord | Registra un candidato di apprendimento da un errore e dalla sua correzione. | Un candidato non è ancora conoscenza generalmente adottata né prova di un trasferimento privato riuscito. |
Attività in background e incarichi ricorrenti
| Strumento | Compito | Disponibilità e limiti |
|---|---|---|
| TaskList | Elenca le attività in background note con il loro stato. | Richiede la gestione delle attività del runtime. |
| TaskOutput | Legge l'uscita di una determinata attività in background. | Richiede un identificatore di attività noto; le uscite lunghe possono essere limitate. |
| TaskStop | Interrompe una determinata attività in background. | Richiede la gestione delle attività; l'interruzione può innescare ulteriori passaggi di pulizia. |
| TaskUpdate | Fornisce allo stesso agente in background in esecuzione istruzioni aggiuntive al prossimo passo di modello sicuro. | Richiede l'identificatore esatto. Le attività di shell e le attività terminate, sconosciute o che non accettano più vengono respinte. |
| TaskResume | Riprende un agente in background locale comprovatamente perso, con contesto conservato, sotto un nuovo identificatore di attività collegato. | Richiede l'origine salvata e il runtime dei sotto-agenti. Non riavvia processi di shell e non viene eseguito automaticamente all'avvio del programma. |
| CronCreate | Crea un incarico ricorrente nella sessione. | Solo con servizio cron presente; il runtime esecutore deve restare disponibile. |
| CronList | Elenca gli incarichi ricorrenti di questa sessione. | Solo con servizio cron presente. |
| CronRunList | Elenca i protocolli di esecuzione recenti di un incarico ricorrente. | Solo con servizio cron presente. L'elenco limitato non contiene prompt grezzi, argomenti di strumenti o risultati. |
| CronRunOutput | Legge un protocollo di esecuzione e, se assegnato completamente, la sua ultima risposta testuale salvata. | Solo all'interno della stessa sessione. I risultati incompleti non vengono rieseguiti; le risposte lunghe possono essere accorciate. |
| CronDelete | Rimuove un incarico ricorrente. | Solo con servizio cron presente; i protocolli di esecuzione già salvati ne sono separati. |
Web e media
| Strumento | Compito | Disponibilità e limiti |
|---|---|---|
| WebSearch | Cerca informazioni pubbliche nel web. | Solo con servizio di ricerca web configurato. |
| FetchURL | Richiama un indirizzo web concreto. | Solo con servizio di recupero configurato; valgono limiti di accesso e contenuto. |
| GenerateImage | Genera un'immagine con BLUN IMAGINE da una descrizione. | Richiede il servizio media; avvia un incarico asincrono a pagamento. |
| GenerateVideo | Genera un nuovo video da una descrizione. | Richiede il servizio media; avvia un incarico asincrono a pagamento. |
| GenerateSpeech | Genera dati audio parlati dal testo fornito. | Richiede il servizio media; avvia un incarico asincrono a pagamento. |
| UnderstandImage | Descrive o esamina un file PNG o JPEG locale tramite il lettore di immagini BLUN. | Carica il file su BLUN e avvia un incarico a pagamento; accesso ai file e servizio media sono necessari. |
| UnderstandVideo | Esamina un video BLUN già completato. | Richiede l'identificatore restituito dal servizio media. Un qualsiasi percorso video locale non basta. |
| DubVideo | Crea una traccia audio per un video BLUN completato. | Richiede il suo identificatore media e il servizio media. |
| LipSyncMedia | Genera un video con movimenti labiali sincronizzati da un'immagine o un video propri completati e da un proprio file audio completato. | Richiede gli identificatori media. L'incarico a pagamento può durare fino a 35 minuti; una percentuale non è attualmente disponibile. |
| GetMedia | Controlla un incarico media e fornisce l'immagine, l'audio o il video completato. | Usa solo identificatori degli strumenti media BLUN. Una generazione avviata non è ancora un file completato. |
Ulteriori agenti, tentativi ripetuti, servizi esterni e incarichi media possono causare consumo aggiuntivo. Il numero di strumenti disponibili non consente affermazioni su prezzo, velocità o consegna riuscita. Controlla i servizi e gli strumenti effettivamente disponibili nella tua installazione.
Scorciatoie da tastiera nella console
Le seguenti scorciatoie valgono nel campo di input della console. Finestre di dialogo aperte, autocompletamento e codifica dei tasti del tuo terminale possono modificarne l'effetto. Su macOS con Ctrl si intende il tasto Controllo.
| Tasto | Effetto |
|---|---|
| Ctrl+P | Apre la selezione delle sessioni. |
| Ctrl+L | Apre la selezione dell'effort. Viene adottato un livello supportato dal modello a un limite di richieste libero; la bozza di input resta conservata. |
| Ctrl+G | Apre la bozza di input nell'editor esterno configurato. Configuralo prima con /editor. |
| Ctrl+O | Apre o chiude le uscite degli strumenti nella cronologia. |
| Ctrl+T | Apre o chiude un elenco di attività troppo lungo. Senza attività nascoste questa scorciatoia speciale non interviene. |
| Ctrl+S | Adotta la bozza e gli inserimenti in attesa al prossimo passo sicuro. Durante l'esecuzione di shell o la compattazione restano prima in coda. Se bozza e coda sono vuote, la scorciatoia può invece aprire un elenco di attività troppo lungo. |
| Ctrl+B | Sposta l'attività di primo piano attuale in background, quando è attiva un'attività adatta. In stato di inattività o durante una compattazione questo cambio non interviene. |
| Maiusc+Tab | Commuta la modalità piano; non sceglie alcuna altra modalità di autorizzazione. |
| Escape | Chiude suggerimenti o una selezione. Fuori dall'autocompletamento e dalla selezione delle sessioni, Escape scarta gli inserimenti in attesa e interrompe il lavoro in corso; la bozza non ancora inviata resta conservata. |
| Due volte Escape in stato di inattività | Apre, con due pressioni rapide consecutive di Escape, la selezione per riprendere passi della conversazione. |
| Ctrl+C | Interrompe prima il lavoro di primo piano attivo. Senza tale lavoro svuota la bozza e mostra l'indicazione per uscire; un secondo Ctrl+C immediatamente successivo termina la console. |
| Ctrl+D con input vuoto | Mostra l'indicazione per uscire; un secondo Ctrl+D consecutivo termina la console. |
| Freccia su / giù con input vuoto | Può far scorrere la vista della domanda secondaria attiva. Durante il lavoro in corso la freccia su può riportare indietro l'ultimo input locale ancora in attesa per modificarlo; altrimenti valgono le normali regole dell'editor. |
| Alt+V su Windows Ctrl+V sugli altri sistemi | Apre prima un blocco di inserimento richiuso al cursore oppure tenta di inserire un'immagine dagli appunti. Senza immagine l'elaborazione ripiega sull'input di testo; supporto delle immagini e configurazione adatta restano necessari. |
Se gli input in attesa devono essere conservati, usa in modo mirato /abort. /stop li scarta in aggiunta. Per riprendere passi della conversazione è disponibile anche /undo.
Comandi via Telegram
La console King collegata deve essere in esecuzione. Nella chat diretta condivisa puoi inviare i comandi seguenti; nei gruppi il messaggio deve essere assegnato espressamente al bot. Un elenco locale di comandi o plugin non amplia questa autorizzazione.
| Comando | Uso |
|---|---|
| /befehle | Mostra i comandi Telegram effettivamente supportati, anche mentre la console è occupata. |
| /loop [Intervallo] [Prompt] | Crea un incarico ricorrente; status, pause, resume e stop lo controllano. |
| /goal | Creare un obiettivo oppure gestirlo con i suoi sottocomandi disponibili. |
| /idea, /chancenradar | Avviare o gestire la rispettiva modalità di lavoro nell'ambito previsto. |
| /curiosity, /scout | Avviare una ricerca limitata; senza tema viene chiesta prima la direzione. |
| /reload | Ricarica la sessione secondo le normali regole di disponibilità. |
| /memory status|on|off | Controllare o modificare lo stato della memoria personale. |
| /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. |
| /usage off|tokens|full|reset | off, tokens e full salvano la modalità di visualizzazione per questa sessione. reset rimuove questa impostazione; inherit, clear e default sono equivalenti. |
/loop@SuoBot status è anch'esso ammesso. Non tutti i comandi possono essere eseguiti durante una risposta. Nomi non supportati come /login, /new o /god non vengono eseguiti come comandi di controllo remoto. I comandi di connessione del bot /start, /help e /status nella chat diretta sono separati da questo.
Nomi di comandi precedenti
/model, /automodel e /router restano per motivi di compatibilità. Non selezionano più un modello, ma aprono come /effort la selezione dello sforzo di ragionamento. Gli argomenti dietro questi tre nomi precedenti vengono ignorati.
/update non è incluso nel registro dei comandi con barra integrati nella versione console 9.1.620. Usa blun update nel terminale del sistema operativo. Il comando non appartiene al campo di input della chat.