BLUN Code CLI

Was sich seit 9.1.605 geändert hat

Die einzelnen Änderungen und ihre Veröffentlichungsstände findest du im CLI-Changelog.

Voraussetzungen

• Windows oder macOS auf x64 oder ARM64; außerdem Linux
• Node.js 24.15.0 oder neuer aus der LTS-24-Reihe
• Node.js, npm und Git Bash unter Windows
• Internetzugang für Anmeldung, KI-Modelle und verwaltete Werkzeuge
• ein Arbeitsordner für dein Projekt

Node.js, npm und Git Bash unter Windows

Node.js führt die Konsole aus. npm installiert und aktualisiert das Paket. Der offizielle Node.js-Installer enthält npm. Git for Windows liefert die von King benötigte Shell Git Bash; mit Node.js wird Git Bash nicht installiert.

Vor der ersten Installation

1. Installiere Node.js 24 LTS (mindestens 24.15.0) mit dem Windows-MSI von nodejs.org/en/download. Lass npm und den PATH-Eintrag aktiviert.

2. Installiere Git for Windows von gitforwindows.org.

3. Schließe das Terminal vollständig und öffne eine neue Eingabeaufforderung.

4. Prüfe node --version, npm --version und git --version, bevor du King installierst.

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

Git for Windows enthält Git Bash. Du kannst King aus der Eingabeaufforderung oder PowerShell starten; ein zusätzliches Git-Bash-Fenster ist nicht nötig.

Installation von Node.js und npm: offizielle npm-Dokumentation.

Wenn node oder npm nicht gefunden wird

Node.js/npm fehlt oder ist über PATH nicht erreichbar. Öffne zuerst das Terminal neu. Bleibt der Fehler bestehen, repariere die Node.js-Installation mit aktiviertem npm und PATH-Eintrag.

where.exe node und where.exe npm zeigen die erreichbaren Pfade; ohne Treffer wurde das Programm über PATH nicht gefunden.

where.exe node
where.exe npm

Blockiert PowerShell npm.ps1, verwende npm.cmd, statt die Ausführungsrichtlinie zu lockern.

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

Wenn Git Bash nicht gefunden wird

Installiere Git for Windows und öffne das Terminal neu. Bei einer Installation in einem anderen Verzeichnis setze BLUN_SHELL_PATH auf den absoluten Pfad der installierten bash.exe.

Das folgende Beispiel gilt nur für die Eingabeaufforderung und diese Terminalsitzung; passe den Pfad an deine Installation an. Prüfe vor dem Setzen, ob die Datei existiert.

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

Node.js prüfen und aktuell halten

Prüfe zuerst die installierte Version:

node --version
npm --version

Für die einmalige npm-Installation müssen bereits Node und npm vorhanden sein. Eine Warnung EBADENGINE ist bei einer älteren Node-Version möglich. Nach erfolgreicher Installation genügt der erste Start mit king oder blun; BLUN richtet dann seine eigene Laufzeit ein.

Manueller Ersatzweg

Wenn der automatische Download oder die Prüfsummenprüfung unter Windows oder macOS scheitert, installiere Node.js 24 LTS manuell:

1. Offizielle Downloadseite öffnen

   Rufe nodejs.org/en/download auf und wähle Node.js 24 LTS.

2. Passenden Installer ausführen

   Unter Windows verwende den MSI-Installer. Unter macOS verwende das PKG-Paket. Wähle x64 oder ARM64 passend zu deinem Rechner.

3. Terminal vollständig neu öffnen

   Bereits geöffnete Terminals verwenden häufig noch den alten Programmpfad.

4. Version erneut prüfen

   node --version
   npm --version

Installation

1. Voraussetzungen prüfen

   node --version
   npm --version

   Unter Windows und macOS kann BLUN eine ältere vorhandene Node-Version beim ersten Start durch seine private Laufzeit ersetzen. Für die npm-Installation müssen Node und npm bereits aufrufbar sein. Unter Linux benötigst du vor dem Start Node.js 24.15.0 oder neuer.

   Node.js, npm und Git Bash unter Windows

2. Aktuelle stabile Fassung installieren

   npm install -g blun-king-cli@latest

3. Installation prüfen

   blun --version

4. Diagnose ausführen

   blun doctor

Start und Anmeldung

Profil, Arbeitsbereich und Sitzung

Ein Profil wählt die getrennte King-Identität und deren Einstellungen. Ein Arbeitsbereich bestimmt, welche Projektdateien geöffnet sind. Eine Sitzung enthält den Gesprächsverlauf und den Arbeitszustand. Eine neue Sitzung ist deshalb weder ein neues Konto noch automatisch ein isolierter Git-Worktree.

king --profile mein-king

--profile gehört zum king-Launcher. Für einen isolierten Git-Arbeitsbereich nutzt du blun workspace create <name>; zum Fortsetzen eines Gesprächs die Sitzungsauswahl. Die Terminal-Referenz erklärt diese Befehle und ihre Voraussetzungen.

Welchen Startbefehl solltest du verwenden?

Zum ersten Mal anmelden

1. Anmeldung starten

   blun login

2. Browser-Anmeldung abschließen

   Melde dich mit deinem BLUN-Konto an und kehre danach zur Konsole zurück.

3. Projektordner öffnen und starten

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

Alternativ kannst du in einer laufenden Konsole /login eingeben. Du musst keinen API-Schlüssel in eine Konfigurationsdatei kopieren.

Eine Sitzung fortsetzen

Mit /sessions öffnest du die Sitzungsauswahl. Du kannst auch eine exakte Kennung, einen exakten Titel oder einen eindeutigen Kennungsanfang angeben. Bei mehreren Treffern wählst du die gewünschte Sitzung aus der Liste.

/sessions API-Umbau

Für die letzte Sitzung des aktuellen Arbeitsordners startest du King im normalen Terminal mit:

king --continue

Ab 9.1.606 lädt die Anzeige zuerst die neuesten Verlaufseinträge. Standardmäßig sind es ungefähr 200; zusammengehörende Nachrichten und Werkzeugschritte bleiben vollständig und können diese Anzahl überschreiten. Über die Verlaufsnavigation erreichst du ältere Seiten. Der gespeicherte Gesprächsverlauf und der Modellkontext werden durch diese Anzeigegrenze nicht gekürzt.

Die Zielgröße für die Anzeige kannst du beim interaktiven Start zwischen 1 und 2000 einstellen:

king --continue --history-limit 400

Die zuletzt ausgewählte Sitzung beim Start öffnen

Wenn du regelmäßig zur gleichen Arbeit zurückkehrst, kannst du in deiner vorhandenen ~/.blun/tui.toml diese Einstellung ergänzen. Unter Windows liegt die Datei normalerweise in %USERPROFILE%\.blun\tui.toml.

resume_last_selected = true

Setze die Zeile im oberen Bereich der Datei vor einem Abschnitt wie [editor]. Die übrigen Einstellungen bleiben erhalten. Die Auswahl wird zum Konto, Agenten, Arbeitsordner und zur Laufzeit passend gespeichert. Eine ausdrücklich angegebene Sitzung hat Vorrang. Ist die gespeicherte Auswahl nicht mehr verfügbar, beginnt eine neue Sitzung. Mit false schaltest du diese Startoption wieder aus.

Profile auswählen

/profile oder /profiles öffnet die Profilauswahl. Während laufender Arbeit oder bei wartenden Nachrichten bleibt das aktuelle Profil aktiv; wähle das andere Profil, sobald die Sitzung bereit ist.

System32 ist kein Projektordner

Wechsle vor dem Start in der Eingabeaufforderung mit cd /d "%USERPROFILE%" in deinen Benutzerordner. Alternativ wechsle in einen eigenen vorhandenen Projektordner. In PowerShell wähle deinen Benutzerordner mit Set-Location $HOME. Starte danach king.

cd /d "%USERPROFILE%"
king

Arbeitsordner auswählen (9.1.603)

Wenn du unter Windows einen anderen Arbeitsordner wählst, öffnet sich ein Ordnerdialog. Du kannst den Pfad weiterhin von Hand eingeben. Wenn du den Dialog abbrichst, kehrst du zur Ordnerauswahl zurück, ohne einen Ordner zu übernehmen.

Ist kein Ordnerdialog verfügbar, fragt die Konsole den Pfad ab. Auf anderen Betriebssystemen bleibt es bei der Pfadeingabe.

Wenn beim Start ein Ordner innerhalb des Windows-Verzeichnisses übernommen wird oder gespeichert ist, schlägt die Ordnerauswahl deinen Benutzerordner vor. Von Hand eingegebene Pfade werden weiterhin wie bisher geprüft.

Tägliche Arbeit

Denkaufwand und Freigaben festlegen

Strg+L öffnet seit 9.1.609 die Auswahl für den Denkaufwand direkt aus dem Eingabefeld. Dein bisheriger Eingabetext bleibt erhalten. Während King arbeitet, wird ein Wechsel abgelehnt; öffne die Auswahl erneut, sobald die Sitzung bereit ist. Die verfügbaren Stufen hängen vom aktiven Modell ab.

Der Denkaufwand steuert, wie gründlich das Modell vor einer Antwort arbeitet. Höhere Stufen können deutlich länger dauern.

blun --effort high --permission-mode manual

Ausgabestil wählen

Mit /output-style öffnest du die Auswahl. Verfügbar sind Standard, Knapp, Proaktiv, Erklärend und Lernend. Die Auswahl gilt sofort für die laufende Sitzung und wird als Standard für spätere Starts gespeichert.

Aktiven Kontext verdichten

BLUN Code überwacht den aktiven Kontext für die nächste Modellanfrage, nicht einfach den gesamten gespeicherten Verlauf. Die wirksame Grenze hängt vom Modell, dem Konto und dem Verdichtungsbudget ab. Ältere Teile werden in begrenzten Stufen zusammengefasst; jede Stufe reserviert Platz für ihre Zusammenfassung.

Währenddessen erscheint im Gespräch beispielsweise Verdichte ~941,2k Tokens … · 2/~10 · 90 %. 2/~10 zeigt die laufende und die geschätzte Gesamtzahl der Stufen. 90 % ist die gemessene Auslastung des Modellfensters für den aktuellen Verdichtungsaufruf. Schlägt eine Stufe fehl oder verkleinert sie den Kontext nicht, bleibt der ursprüngliche Kontext erhalten.

Schon bei 75 Prozent der wirksamen Verdichtungsgrenze entlastet eine kleine, verlustfreie Verdichtung ältere große Werkzeugergebnisse und abgeschlossene Werkzeugargumente. Bei einem Modellfenster von 1.048.576 Token und einer Vollverdichtung bei 256.000 Token liegt dieser Punkt bei 192.000 Token. Die letzten 20 Nachrichten, normale Nutzertexte und der gespeicherte Rohverlauf bleiben unverändert.

Proaktiv an einer Arbeitsgrenze verdichten

Nutzer müssen keinen Befehl eingeben. Sobald der aktive Kontext die Hälfte der automatischen Vollverdichtungsgrenze erreicht, kann King nach einem abgeschlossenen Arbeitsabschnitt CompactConversation auswählen. Das Werkzeug plant den bestehenden sicheren Verdichtungsvorgang für das Ende des aktuellen Werkzeugschritts ein. Es öffnet keinen weiteren Zug; schlägt die Verdichtung fehl, bleibt der ursprüngliche Verlauf unverändert.

Kurze Serverüberlastung überstehen

Bei einer ausdrücklich als wiederholbar gekennzeichneten Serverüberlastung (HTTP 429 mit x-should-retry: true) wartet BLUN King gemäß Retry-After und sendet dieselbe Anfrage höchstens zweimal erneut. Authentifizierungs-, Kontingent- und andere nicht wiederholbare Fehler brechen weiterhin sofort ab. Bleibt der Server nach den begrenzten Versuchen überlastet, erhält der Nutzer weiterhin die klare Fehlermeldung.

Delegierte Arbeit nach einer Provider-Unterbrechung fortsetzen

Verliert ein delegierter Einzelagent oder ein Mitglied eines Agentenschwarms die Provider-Verbindung, erhält es eine leere Provider-Antwort, bricht sein Stream wegen Leerlaufs ab oder meldet der Server HTTP 408/500/502/503/504, setzt BLUN King denselben Agenten anhand seines dauerhaften Verlaufs fort. Bei Einzelagenten sowie bei Schwarm-Unterbrechungen außerhalb von HTTP 429 wartet die erste Fortsetzung zwei Sekunden und die zweite fünf Sekunden; danach bleibt der ursprüngliche Fehler sichtbar. HTTP 429 behält im Schwarm seine getrennte, längere Überlastungsregel. Authentifizierungs-, Zahlungs- oder Kontingent-, Richtlinien-, Kontext-, Werkzeug- und Codefehler sowie manuelle Abbrüche lösen keine automatische Fortsetzung aus. Jeder Fortsetzungsversuch verwendet die bestehende Agenten-ID, damit bereits abgeschlossene Arbeit nicht wiederholt wird.

Große Werkzeugergebnisse auslagern

Bei textbasierten Werkzeugergebnissen mit mehr als 12.000 Zeichen speichert BLUN King den vollständigen Inhalt im privaten Sitzungsordner tool-results. In späteren Modellanfragen verbleiben die ersten 1.000 und die letzten 1.000 Zeichen, die genaue Zahl der ausgelassenen Zeichen und der output_path. Gemischte Medienergebnisse und bereits gekürzte Ergebnisse bleiben unverändert. Eine spätere Mikroverdichtung bewahrt den Pfad.

Version 9.1.104 lässt Shell-Befehle im Vordergrund auch bei sehr großen Ausgaben bis zum regulären Ende laufen. King schreibt bis zu 16 MiB fortlaufend in das private Aufgabenprotokoll, verwirft darüber hinausgehende Ausgaben und meldet den tatsächlichen Exit-Code, statt den Prozess wegen der Ausgabemenge zu beenden. Kleine Ausgaben, Hintergrundaufgaben, Zeitgrenzen und manuelle Abbrüche bleiben unverändert.

Read output_path

Beispiel: Ein Suchergebnis mit 30.000 Zeichen bleibt vollständig in der lokalen Datei verfügbar. Das Modell sieht den Anfang und das abschließende Ergebnis oder den Fehler sofort; der Agent liest über den Pfad nur die benötigten Abschnitte, statt bei jedem Modellschritt erneut alle 30.000 Zeichen zu senden.

Parallele Werkzeugergebnis-Stapel

Ab Version 9.1.99 betrachtet King direkt aufeinanderfolgende reine Textergebnisse zusätzlich als Stapel. Überschreitet der Stapel insgesamt 12.000 Zeichen, obwohl jedes einzelne Ergebnis kleiner ist, lagert King so viele der größten Ergebnisse ab 3.000 Zeichen aus, wie zum Unterschreiten der Grenze nötig sind. Im Modellkontext bleiben lesbare Verweise; Sitzungsrohverlauf und Medien bleiben unverändert. Das Telemetrieereignis tool_result_batch_offloaded meldet nur Anzahl und Zeichengrößen, keine Inhalte oder Pfade.

Große Nutzernachrichten auslagern

Enthält eine echte Nutzernachricht mehr als 200.000 Textzeichen, speichert BLUN King den vollständigen Text im privaten Ordner conversation-history. Im Modellkontext bleiben die ersten fünf und letzten fünf Zeilen, Größenangaben und ein output_path erhalten. Mit Read und dem output_path liest der Agent nur die benötigten Seiten. Bilder, Audio und andere Nicht-Text-Bestandteile bleiben angehängt. Das sichtbare Transkript und der gespeicherte Rohverlauf enthalten weiterhin die vollständige Originalnachricht. Nachrichten mit exakt 200.000 Zeichen bleiben vollständig im Kontext; bei einem Schreibfehler gilt dasselbe.

Große Grep-Suchen begrenzen

Im Ausgabemodus content beendet Grep ripgrep nach offset plus head_limit plus einer vollständigen Vorschauzeile. Die zusätzliche Zeile dient nur dazu, eine weitere Seite zu erkennen. Bei head_limit=250 und offset=0 werden höchstens 251 vollständige Ergebniszeilen eingelesen. Bei head_limit=0, für count_matches und für nach Änderungszeit sortierte files_with_matches liest King das vollständige Ergebnis weiterhin ein.

Große Dateien präzise weiterlesen

Große Dateien werden weiterhin seitenweise gelesen. Erreicht Read seine interne Grenze von 1.000 Zeilen und enthält die Datei weitere Zeilen, nennt das Ergebnis den exakten nächsten line_offset. Beispiel: Ein Lesevorgang ab Zeile 2001 wird mit line_offset=3001 fortgesetzt. Am Dateiende und bei einem bewusst kleineren Leseausschnitt erscheint kein Hinweis. Dadurch zieht der Agent keine Schlüsse aus einem unvollständigen Ausschnitt und liest die Datei nicht erneut ab der ersten Zeile.

Gesprächsfäden verwenden

Hintergrundagenten

Hintergrundagenten erscheinen mit Aufgabe und Status in der Agentenansicht. Du kannst die Ausgabe öffnen, eine Rückfrage senden oder den Agenten stoppen. Hooks und die eingebundene Sprachserver-Diagnose prüfen geänderte Dateien nach Schreib- und Bearbeitungsvorgängen.

Version 9.1.105 ergänzt TaskUpdate für laufende Hintergrundagenten. King übergibt zusätzliche Anweisungen am nächsten sicheren Modellschritt an denselben aktiven Agenten, ohne ihn zu stoppen oder einen weiteren Agenten zu starten. Unbekannte und bereits beendete Aufgaben, Shell-Aufgaben sowie Agenten, die keine Aktualisierung mehr annehmen, werden unverändert abgewiesen.

Version 9.1.106 erlaubt Agentenprofilen, Werkzeuge namentlich auszuschließen. King wendet diese Ausschlüsse erst an, nachdem dauerhaft geladene, dynamisch nachgeladene und MCP-Werkzeuge zusammengestellt wurden. Die Standardprofile coder, explore und plan können über Telegram weder antworten noch reagieren, Nachrichten bearbeiten oder Anhänge herunterladen; der Hauptagent bleibt unverändert. So senden delegierte Agenten keine Nachrichten am Hauptagenten vorbei, und ihre Modellanfragen enthalten weniger Werkzeugschemas. Nicht gefundene, namentlich angegebene Werkzeuge werden sichtbar gemeldet.

Version 9.1.107 zeigt Providerfehler in verständlicher Kundensprache an; interne Fehlercodes und Support-Hinweise erscheinen dabei nicht. /help bietet eine mit Pfeiltasten steuerbare Befehlsliste und öffnet mit der rechten Pfeiltaste oder der Eingabetaste eine ausführliche Beschreibung des ausgewählten Befehls.

Version 9.1.108 entfernt identische, wiederholt eingespeiste Systemhinweise aus der Modellprojektion. Pro Hinweisart bleibt die neueste exakte Kopie sichtbar. Geänderte Hinweise, normale Nutzernachrichten, Werkzeugaufrufe, gemischte Inhalte und der gespeicherte Sitzungsrohverlauf bleiben unverändert. Dadurch werden die an den Anbieter gesendeten Daten in langen Sitzungen kleiner, ohne den gespeicherten Verlauf, Exporte oder Wiederaufnahmen zu beschneiden.

Werkzeuge und Skills nach Bedarf laden

Seit 9.1.595 lädt King optionale Werkzeugschemas wieder gezielt über ToolSearch, statt den vollständigen Katalog bei jeder Anfrage mitzuschicken. Die aufbewahrte Auswahl ist begrenzt; Werkzeuge bleiben auffindbar, auch wenn ihr Schema gerade nicht mitgesendet wird. Normale Berechtigungsprüfungen gelten weiterhin. Große Skill-Kataloge werden kompakt und seitenweise bereitgestellt.

Bei kurzen Begrüßungen kann King einen begrenzten Ausschnitt des jüngsten Dialogs verwenden. Systemanweisungen bleiben erhalten; für einen Arbeitsauftrag wird der aufbewahrte Arbeitsverlauf wieder berücksichtigt. Das löscht keine gespeicherten Nachrichten. Eine Begrüßung hat dadurch keinen festen Tokenpreis: Systemkontext, Werkzeuge, Wiederholungen und Antwortprüfung tragen weiterhin zum Verbrauch bei.

/context zeigt die geschätzte Kontextgröße der nächsten Anfrage und die dafür geltende Grenze. /context-doctor beziehungsweise /tokens ergänzt die Anzeige um verfügbare Diagnosedaten; /usage zeigt die Verbrauchs- und Kontingentansicht. Schätzwerte, aufsummierter Sitzungsverbrauch und tatsächlich abgerechnete Token sind unterschiedliche Größen.

Große Werkzeugkataloge werden bei Bedarf über die Werkzeugsuche erschlossen. Seit 9.1.615 richtet sich das Werkzeugbudget nach dem gemeldeten Kontextfenster des Anbieters. Gefundene Werkzeuge bleiben im nächsten Schritt verfügbar; ihre vollständigen Beschreibungen müssen nicht bei jedem Auftrag mitgesendet werden.

/context doctor: Unterscheidet gespeicherten Verlauf, geschätzte Tokenzahlen und die Bytezahl der serialisierten Anfrage. Zeigt erfasste Beiträge von AGENTS-Regeln, Mistake-Dateien, Memory, Skills und Werkzeugdefinitionen. Fehlende Herkunftsdaten bedeuten nicht null Byte.

Anfrage-Bytes, geschätzte Tokenzahlen, aufsummierter Sitzungsverbrauch und abgerechnete Token sind unterschiedliche Größen. Die Verbrauchsanzeige berücksichtigt auch die Antwortprüfung. /usage cost mit Tages- oder Monatskosten gehört nicht zu dieser Fassung. Geringere Kosten oder schnellere Antworten im Livebetrieb sind nicht belegt.

Jeder HTTP-Versuch erhält eine neue x-request-id, sofern der Aufrufer keine vorgibt. Vorgegebene Kennungen bleiben unverändert und werden nicht als beliebiger Fremdtext protokolliert. Die Kennung dient zur Zuordnung von Client- und Servermessungen; sie ist kein Abrechnungsschlüssel.

Sitzungssteuerung in 9.1.604

/queue: Zeigt oder ändert, wie diese Sitzung eingehende Nachrichten verarbeitet. Die Modi heißen steer, followup, collect und interrupt; reset oder default entfernt die sitzungsspezifische Einstellung.

Ohne sitzungsspezifische Änderung verwendet King steer mit 500 Millisekunden Bündelwartezeit und einer maximalen Bündelgröße von 20 Nachrichten. /queue zeigt die wirksamen Werte; /queue reset entfernt nur die sitzungsspezifische Einstellung.

steer übergibt neue Eingaben am nächsten geeigneten Übergabepunkt; ist das nicht möglich, warten sie auf den nächsten Durchlauf. followup wartet bis zum Ende des laufenden Durchlaufs. collect bündelt Eingaben; interrupt unterbricht den laufenden Durchlauf für neue Eingaben.

/queue collect debounce:500ms batch:10

Zulässig sind debounce:0ms bis debounce:60s und batch:1 bis batch:100. batch begrenzt die Bündelgröße, ohne überschüssige Nachrichten zu löschen. Es gibt keine cap:- oder drop:-Option. Warteschlangenregel und Verbrauchsanzeige bleiben beim Fortsetzen derselben Sitzung erhalten. Gewöhnliche neue Kanalnachrichten lösen nicht mehr automatisch nach 30 Sekunden eine Unterbrechung aus.

/session [ID|Titel]: Öffnet die Sitzungsauswahl oder wählt eine Sitzung anhand ihrer exakten Kennung, ihres exakten Titels oder eines eindeutigen Kennungspräfixes. Bei mehreren Treffern öffnet sich die Auswahl.

/question: Öffnet ausstehende Rückfragen erneut. Das Einklappen beantwortet oder verwirft eine Rückfrage nicht.

/usage: Zeigt den Verbrauch und verfügbare Kontingente. off, tokens und full speichern den Anzeigemodus für diese Sitzung. reset entfernt diese Einstellung; inherit, clear und default sind gleichwertig.

/settings: Öffnet die Einstellungen einschließlich der lokalen Anzeigeoptionen.

9.1.605

/context map zeigt die verfügbare Byte-Aufteilung der zuletzt erfassten Anfrage. /context list, /context detail und /context doctor öffnen den ausführlichen Bericht. Er unterscheidet Anweisungsdateien, Memory, Skills, Werkzeugdefinitionen und zugeordnete Verlaufstexte. Fehlende Messwerte bleiben als nicht verfügbar gekennzeichnet; sie werden nicht als null gezählt.

king --message "Prüfe die offenen Tests" übergibt der interaktiven Konsole eine erste Nachricht. Sie wird nach der Zustimmung beim Start und der Sitzungsauswahl über die normalen Nachrichtenprüfungen und die Warteschlange verarbeitet. Ihr Inhalt wird nicht als Slash- oder Shell-Befehl interpretiert. Die Zustimmung beim Start und die Berechtigungsprüfungen werden dadurch nicht übersprungen.

/abort bricht den laufenden Vorgang ab, ohne wartende Eingaben zu verwerfen. /stop verwirft zusätzlich die wartenden Eingaben. /exit beendet weiterhin die Konsole. Dies sind lokale Konsolenbefehle, keine zusätzlichen Telegram-Fernbefehle.

Die zusätzliche Agenten-/Sitzungszeile am unteren Rand entfällt. Sitzungsauswahl und Diagnose bleiben über die bestehenden Befehle verfügbar.

Aktuellen Kontext und gespeicherten Verlauf unterscheiden

Ein langer gespeicherter Verlauf muss nicht vollständig in einer einzelnen Modellanfrage stehen. King kann den aktiven Arbeitskontext verdichten und ältere Werkzeugausgaben über geprüfte Verweise bereitstellen. Die vollständigen Originale bleiben für das gezielte Nachlesen erhalten.

Die Vorschau großer Werkzeugausgaben berücksichtigt seit 9.1.617 auch das verfügbare Kontextfenster. Beim erneuten Laden derselben Sitzung werden unveränderte Plugin-Anweisungen nicht immer wieder ergänzt. Mit /context doctor prüfst du die erfasste Anfrage; /context map zeigt ihre verfügbare Byte-Aufteilung.

Für Anweisungsdateien wie AGENTS.md gilt in der King-Konsole ab 9.1.614: Sie bleiben vollständig, solange die Anfragegrenze das zulässt. Größere Dateien stoppen einen Auftrag nicht allein wegen ihrer Dateigröße. Die frühere pauschale Kürzung aus 9.1.613 beschreibt damit nicht mehr den aktuellen Konsolenweg.

Aufgaben und Ausgaben sichtbar halten

Eine überlange Aufgabenliste lässt sich mit Strg+T aufklappen. Lange Werkzeugausgaben werden im Verlauf gekürzt dargestellt und lassen sich mit Strg+O erweitern. Eingabe, Aktivitätsanzeige und die beiden Statuszeilen gehören zur Konsole. /tasks öffnet die Hintergrundaufgaben; /copy kopiert die letzte verfügbare Antwort. Die Befehlsreferenz enthält alle eingebauten Befehle sowie die Übersicht der Tastenkürzel und Agentenwerkzeuge.

Lange Züge überwachen

Ab Version 9.1.40 meldet die Konsole einen Zug, wenn 20 Minuten lang kein neues Werkzeugergebnis eingetroffen ist. Die Statuszeile zeigt die Laufzeit, das zuletzt verwendete Werkzeug und die Anzahl wiederholter Fehler. Fünf aufeinanderfolgende fehlgeschlagene Aufrufe desselben Werkzeugs mit denselben Argumenten beenden den Zug mit einer klaren Fehlermeldung, statt unbemerkt weiterzulaufen.

Skills, Plugins und MCP

Skills sind wiederverwendbare Arbeitsanleitungen. Plugins können zusätzlich Werkzeuge, Skills und eigene Befehle bereitstellen. MCP verbindet die Konsole mit konfigurierten Werkzeugservern.

Vorhandene Skills verwenden

Beschreibe deinen Auftrag konkret, damit King passende Anleitungen finden kann. Für eine bestimmte Anleitung gibst du im Eingabefeld / ein und wählst den angebotenen Skill. Eingebaute Skills erscheinen unter ihrem Namen; eigene Skills normalerweise als /skill:<name>. Die Vorschläge deiner Installation zeigen die tatsächlich verfügbaren Namen.

/skill:angebot-pruefen prüfe das Angebot im Projektordner

Dieses Beispiel funktioniert, nachdem du einen eigenen Skill mit dem Namen angebot-pruefen angelegt hast. Wenn mehrere Anleitungen infrage kommen, kannst du King zuerst um einen Vergleich und eine Empfehlung bitten.

Eine eigene Anleitung hinzufügen

Lege im Projekt zum Beispiel .agents/skills/angebot-pruefen/SKILL.md an. Eine Skill-Datei enthält einen Namen, eine Beschreibung des Einsatzbereichs und die eigentlichen Arbeitsschritte:

---
name: angebot-pruefen
description: Angebote auf Leistungsumfang, Termine und offene Fragen prüfen.
---

Lies das vollständige Angebot.
Prüfe Leistungsumfang, Termine, Ausschlüsse und offene Fragen.
Nenne zu jeder Feststellung die passende Stelle im Dokument.
Zeige das Ergebnis, bevor du Dateien änderst.

Projekt-Skills werden auch in .blun/skills gesucht. Für deine Projekte übergreifende Anleitungen gibt es ~/.agents/skills und ~/.blun/skills. Unter Windows steht ~ für deinen Benutzerordner. Starte King nach dem Hinzufügen neu oder lade die Sitzung mit /reload neu, sobald sie bereit ist, und prüfe die Slash-Vorschläge.

Für einen ausdrücklich gewählten Skill-Ordner kannst du King so starten:

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

Diese Option ersetzt die automatische Suche in Benutzer- und Projekt-Skillordnern für diesen Start. Du kannst sie für mehrere Ordner wiederholen. Ein Skill aus GitHub muss mit seiner Ordnerstruktur und einer gültigen SKILL.md in einem solchen Ordner liegen.

Plugins installieren und verwalten

/plugins öffnet die Plugin-Verwaltung. Dort kannst du den Marktplatz ansehen und vorhandene Plugins prüfen. Die Befehle list, info, install, enable, disable und remove stehen ebenfalls zur Verfügung.

/plugins list

Für die Installation gibst du /plugins install <Quelle> ein oder wählst einen Katalogeintrag. Prüfe Quelle und angezeigte Angaben und bestätige die angebotene Installation. Ein deaktiviertes Plugin bleibt installiert; remove entfernt es nach der Bestätigung. Ein Plugin kann eigene Slash-Befehle anbieten, etwa /<plugin>:<befehl>.

Werkzeugverbindungen prüfen

Mit /mcp öffnest du die MCP-Ansicht. Die Plugin-Verwaltung zeigt außerdem die MCP-Server eines Plugins. Eine installierte Anleitung ersetzt keine Anmeldung beim verbundenen Dienst. Prüfe in der jeweiligen Ansicht, ob die Verbindung aktiv ist, bevor du einen Auftrag davon abhängig machst.

Ziele, wiederkehrende Arbeit und Nebenagenten

Ein Ziel bis zum Ergebnis bearbeiten

/goal speichert ein konkretes Ziel. Beschreibe das gewünschte Ergebnis, die zulässigen Änderungen und woran die Erledigung erkennbar sein soll.

/goal Prüfe die offenen Tests, behebe die Ursachen im Projekt und zeige die Prüfergebnisse.

Mit /goal status prüfst du den Stand. /goal pause hält das Ziel an, /goal resume setzt es fort und /goal cancel beendet und entfernt es. /goal edit <Ziel> ändert den Auftrag; /goal replace <Ziel> ersetzt das aktive Ziel ausdrücklich.

Mit /goal next <Ziel> merkst du einen Folgeauftrag vor. /goal next manage öffnet die Verwaltung dieser Folgeziele. Ein neuer Auftrag oder das Fortsetzen eines Ziels beginnt erst, wenn die Sitzung bereit ist.

Eine Aufgabe wiederholen

/loop wiederholt einen Prompt im gewählten Intervall. Gib immer an, was geprüft werden soll und bei welchem Ergebnis King dich informieren soll.

/loop 10m Prüfe die vorhandenen Testergebnisse und melde nur neue Fehler.

/loop status, /loop pause, /loop resume und /loop stop steuern die Wiederholung. Das Anhalten einer Wiederholung und der Abbruch gerade laufender Arbeit sind getrennte Aktionen: Für die aktuelle Arbeit gibt es /abort und /stop.

Eine Frage neben dem Hauptauftrag stellen

/btw <Frage> startet eine Nebenfrage in einem abgezweigten Gespräch. /swarm <Aufgabe> verteilt eine ausdrücklich beauftragte Aufgabe auf mehrere Agenten. Mit /tasks siehst du die Hintergrundaufgaben und ihre Ergebnisse.

Für einen noch offenen Plan stehen außerdem /premortem, /idea, /chancenradar und /curiosity bereit. Ihre Unterschiede, Grenzen und Steuerbefehle findest du in der Befehlsreferenz.

Einmalige Aufträge ohne interaktive Oberfläche

Mit -p übergibst du einen einzelnen Auftrag aus dem normalen Terminal. King gibt das Ergebnis aus und beendet den Aufruf. Das ist beispielsweise für eine Zusammenfassung in einem Skript geeignet.

king -p "Fasse die README dieses Projekts kurz zusammen."

Für Programme kannst du --output-format json oder --output-format stream-json wählen. Ohne diese Option wird Text ausgegeben.

king -p "Fasse die README dieses Projekts kurz zusammen." --output-format json

Die interaktive Startnachricht --message und die Verlaufsanzeige --history-limit gehören zum interaktiven Start und lassen sich nicht mit -p kombinieren.

Antwortprüfung in 9.1.600

Die Antwortprüfung bleibt zeitlich begrenzt: Allgemeine Prüfer haben 30 Sekunden. Nach dem Startsignal der vertrauenswürdigen Host-Komponente stehen für die native Sprachprüfung pro äußerem Prüfversuch einmalig bis zu 90 Sekunden für den ersten inhaltlichen Text bereit. Inhaltlicher Text innerhalb der zulässigen Ausgabelänge sowie die geordneten Übergänge zur Freigabe und zur Belegprüfung setzen die Wartefrist jeweils auf 30 Sekunden zurück.

Unabhängig davon gilt pro äußerem Prüfversuch eine Gesamtgrenze von 120 Sekunden; höchstens zwei äußere Versuche sind erlaubt. Vor der Annahme einer Freigabe wird die tatsächlich verstrichene Zeit erneut geprüft, auch bei verzögerten Timer-Aufrufen. Verspäteter Fortschritt kann eine abgelaufene Frist nicht erneuern. Abbruchsignale werden weiterhin beachtet. Die Bindung an den exakten Antworttext, die zeitliche Gültigkeit des Freigabebelegs und die Autorisierung werden weiterhin geprüft.

Version 9.1.604 enthält AgentSpine 0.73.0 und Translate Native 6.155.0; das Guard-Protokoll bleibt auf 6.20.0. Damit ist keine Behebung von HTTP-502-Fehlern im Live-Betrieb nachgewiesen. Veröffentlichungsstand und bekannte Einschränkungen stehen im Änderungsprotokoll.

Bilder, Video und Ton

Die BLUN Code CLI kennt acht verwaltete Medienwerkzeuge. Nach erfolgreicher Anmeldung und wenn der Mediendienst erreichbar ist, musst du keine Serveradresse oder Modellkennung eintragen. Beschreibe das gewünschte Ergebnis; die Konsole wählt das passende Werkzeug.

Was du bei langen Aufträgen siehst

• processing: Der Auftrag läuft weiter.
• failed: Der Auftrag ist beendet und wird nicht mehr fertig.
• ready: Das Ergebnis kann abgerufen werden.

Telegram einrichten

Für Telegram benötigst du einen eigenen Bot und startest BLUN King anschließend mit dem Befehl king. Die Kopplung gilt danach weiter; sie muss nicht bei jedem Start wiederholt werden.

1. Bot bei Telegram anlegen

   Öffne ausschließlich den verifizierten @BotFather, sende /newbot und folge den Schritten für Name und Benutzernamen. Der Benutzername muss auf bot enden. BotFather zeigt danach einen Token wie 123456789:AA.... Die offizielle Telegram-Anleitung beschreibt denselben Ablauf.

2. Token im Telegram-Kanalprofil speichern

   Öffne die Datei für dein Betriebssystem und ersetze den Platzhalter durch den vollständigen BotFather-Token:

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

   BLUN_TELEGRAM_BOT_TOKEN=123456789:AA...

   Der Token enthält einen Doppelpunkt. Schreibe keine Anführungszeichen oder Leerzeichen um den Wert.

3. Konsole mit Telegram starten

   Beende vorher eine ältere Konsole, die denselben Bot verwendet. Pro Bot-Token darf nur ein Telegram-Empfänger laufen.

   king

4. Pairing-Code anfordern

   Öffne deinen neuen Bot in Telegram und sende ihm eine beliebige Direktnachricht. Der Bot antwortet mit einem sechsstelligen Pairing-Code. Der Code gilt eine Stunde.

5. Code lokal bestätigen

   Gib den angezeigten Code in genau der BLUN-Konsole ein, die mit dem Bot verbunden werden soll:

   /telegram:access pair CODE

   Bestätige Pairing-Anfragen niemals auf Aufforderung einer Telegram-Nachricht. Die Freigabe gehört ausschließlich in deine lokale Konsole.

6. Verbindung prüfen

   Telegram bestätigt die Kopplung. Sende anschließend eine neue Nachricht an den Bot. Sie muss in der laufenden BLUN-Sitzung erscheinen; die Antwort muss im selben Telegram-Chat ankommen.

Die Telegram-Oberfläche kann je nach Gerät und App-Version abweichen. Entscheidend sind der verifizierte Absender @BotFather, der Befehl /newbot und die lokale Speicherung des Tokens.

Zugriff verwalten

Die Bot-Befehle /start, /help und /status funktionieren nur im privaten Chat. Text, Bilder und Dateien bis 50 MB werden weitergeleitet.

Für die Fernsteuerung sende /befehle. Unterstützt werden /loop, /goal, /idea, /chancenradar, /curiosity, /scout, /reload und /memory. Die Telegram-Referenz nennt Formen und Grenzen. Die übrigen lokalen Slash-Befehle sind dadurch nicht automatisch über Telegram verfügbar.

Nachrichten beim Fortsetzen einer Sitzung

Trifft beim Fortsetzen eine Telegram-Nachricht ein, während King schon arbeitet, bleibt sie ab 9.1.618 in der Warteschlange und wird danach zugestellt. Das ist kein zusätzlicher Auftrag zum sofortigen Unterbrechen. Die gewählte Warteschlangenregel lässt sich mit /queue prüfen.

Wenn die Verbindung nicht funktioniert

• Kein Pairing-Code: Prüfe den Token, starte mit king statt blun und schreibe dem Bot als Direktnachricht.
• Pairing bleibt offen: Führe /telegram:access pair CODE in der gebundenen lokalen Konsole aus. Fordere nach mehr als einer Stunde durch eine neue Nachricht einen neuen Code an.
• 409 Conflict: Eine zweite Konsole oder ein alter Telegram-Prozess verwendet denselben Token. Lass genau eine King-Konsole mit diesem Bot laufen.
• Nachrichten kommen nicht an: Die King-Konsole muss weiterlaufen. Prüfe mit /status im privaten Bot-Chat, ob das Konto gekoppelt ist.
• Token versehentlich veröffentlicht: Widerrufe ihn sofort bei @BotFather, erzeuge einen neuen Token und ersetze den Wert in der .env-Datei.

Memory und Mistakes

Beim ersten angemeldeten Start fragt die Konsole getrennt nach persönlichem Memory und nach der Weitergabe bereinigter Fehlerdaten.

• Ja und Nein werden gespeichert. Eine Ablehnung führt nicht zu einer neuen Frage bei jedem Start.
• Die Entscheidungen sind unabhängig. Eine Änderung an Mistakes überschreibt Memory nicht und umgekehrt.
• Ohne ausdrückliche Zustimmung wird nichts in den jeweiligen Weg geschrieben.

Memory bewusst ergänzen

blun memory remember "Diese Entscheidung künftig berücksichtigen"

Dieser Aufruf benötigt die Zustimmung des angemeldeten Kontos und einen erreichbaren persönlichen Memory-Dienst. Persona-Notizen, lokale Werkzeugmetadaten und per MCP bereitgestellte Gedächtniswerkzeuge sind jeweils getrennte Wege.

Lokales Werkzeuggedächtnis

King kann abgeschlossene Werkzeugaufrufe als lokale Metadaten festhalten: Werkzeugname, Zeitpunkt, Status und bei Dateiwerkzeugen gegebenenfalls den Pfad. Die Einträge enthalten keine vollständigen Werkzeugargumente, Ausgaben, Befehle oder Schlüssel.

/memory tools status

Mit /memory tools on beziehungsweise /memory tools off steuerst du die Aufzeichnung. /memory tools status zeigt, ob sie aktiv ist. Diese Funktion ist vom persönlichen Gedächtnis und dem vollständigen Sitzungsprotokoll getrennt.

Mistake-Zustand prüfen

blun mistakes status

Die Terminal-Referenz erklärt Upload, Wiederholung, Synchronisierung, Beobachtung und die begründete Entfernung oder Wiederherstellung. Ein eingerichtetes Ziel und dessen Authentifizierung sind für die Übertragung erforderlich.

Updates

Beim Start prüft die Konsole, ob eine neue stabile Fassung bereitsteht. Der Dialog bietet drei Entscheidungen:

1. jetzt aktualisieren,
2. diesmal überspringen,
3. bis zur nächsten Version warten.

Ein Update kannst du auch ausdrücklich starten:

king update

Nach einem erfolgreichen Update zeigt BLUN die vorherige und die installierte Version sowie die wichtigsten Änderungen. Wenn Telegram eingerichtet ist, sendet BLUN denselben Hinweis einmalig an freigegebene Direktchats. Gruppen erhalten keinen automatischen Update-Hinweis.

Zum Änderungsprotokoll

Diagnose

blun doctor

Windows: Fenster schließen und erneut starten

Version 9.1.620 korrigiert das vollständige Beenden beim Schließen des Konsolenfensters. Dadurch soll beim nächsten Start keine zurückgebliebene Instanz mehr die Meldung „läuft bereits“ auslösen. Die reguläre Beendigung aus der Konsole bleibt /exit.

Falls die Meldung weiterhin erscheint, prüfe zuerst die installierte Version und ob die betreffende Konsole noch läuft. Eine aktive Sitzung darf nur einen schreibenden Besitzer haben. Lösche keine Sperrdatei, während die zugehörige Konsole noch arbeitet.

Wenn „Verdichtung pausiert“ erscheint

Ab 9.1.619 zählt King nur unmittelbar aufeinanderfolgende Verdichtungsfehler. Nach einer erfolgreichen Verdichtung ist ein früherer einzelner Fehler kein weiterer Sperrgrund. Die Meldung „Verdichtung pausiert“ bezeichnet fehlgeschlagene Zusammenfassungsversuche; sie behauptet nicht mehr pauschal, dass dein Kontext voll ist. Prüfe die genaue Meldung und die Diagnose, bevor du die Sitzung neu startest.

Fehler und Wartezeiten auseinanderhalten

Seit 9.1.596 wird eine automatische Unterbrechung zugunsten wartender Telegram-Nachrichten nicht mehr als Betätigung der Escape-Taste ausgegeben. Ein echter manueller Abbruch bleibt davon getrennt.

9.1.597 erkennt Fehlermeldungen, die ausdrücklich eine überschrittene Kontextgrenze nennen, auch innerhalb einer Gateway-Fehlerantwort. Vor Beginn einer Ausgabe ist ein begrenzter neuer Versuch mit kleinerem Ausgabelimit möglich. Nachrichten und Werkzeuge werden dabei nicht gelöscht. Ein allgemeiner Verbindungsfehler oder Dienstausfall ist dadurch nicht behoben.

Historischer Befund in 9.1.597: Eine gemeldete Untergrenze für die Zahl der Eingabetoken konnte einen weiteren fehlgeschlagenen Versuch und unnötige Verdichtungen auslösen. Der Befund wurde am 17. September 2026 reproduziert. Die späteren Korrekturen und ihre jeweiligen Veröffentlichungsstände sind im Changelog dokumentiert.

Lange Wartezeiten aus Retry-After und die verbleibende Pause nach einer Sitzungswiederaufnahme werden berücksichtigt. Ein Neustart ist kein Weg, eine angeforderte Wartezeit zu umgehen.

Protokolle für die Fehleranalyse

Werkzeugaufrufe und Ergebnisse stehen im Sitzungsprotokoll wire.jsonl. Für eine gezielte Diagnose kannst du /export-debug-zip verwenden. Prüfe den Inhalt vor einer Weitergabe auf private Daten. Ein bewusst gepflegtes Fehlerprotokoll wie mistake.md ersetzt diese Ereignisprotokolle nicht.

Ehrliche Grenzen

• Die KI kann sich irren. Prüfe wichtige Aussagen, Dateien und ausgeführte Befehle.
• Verwaltete Werkzeuge brauchen Anmeldung und erreichbare BLUN-Dienste.
• Medienaufträge zeigen noch keinen Prozentfortschritt. processing ist ein Zustand, keine Zeitangabe.
• Eine 200-Antwort oder grüne Teilprüfung belegt nur den gemessenen Abschnitt. Prüfe einen Weg von der ersten Benutzereingabe bis zum Ergebnis.