BLUN Code CLI

Qué ha cambiado desde 9.1.605

Los cambios individuales y sus estados de publicación se encuentran en el registro de cambios CLI.

Requisitos

• Windows o macOS en x64 o ARM64; además Linux
• Node.js 24.15.0 o superior, de la serie LTS 24
• Node.js, npm y Git Bash en Windows
• Acceso a internet para el inicio de sesión, los modelos de IA y las herramientas gestionadas
• una carpeta de trabajo para tu proyecto

Node.js, npm y Git Bash en Windows

Node.js ejecuta la consola. npm instala y actualiza el paquete. El instalador oficial de Node.js incluye npm. Git for Windows proporciona la shell Git Bash que King necesita; Git Bash no se instala con Node.js.

Antes de la primera instalación

1. Instala Node.js 24 LTS (al menos 24.15.0) con el MSI de Windows de nodejs.org/en/download. Deja activados npm y la entrada de PATH.

2. Instala Git for Windows desde gitforwindows.org.

3. Cierra el terminal por completo y abre un nuevo símbolo del sistema.

4. Comprueba node --version, npm --version y git --version, antes de instalar King.

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

Git for Windows incluye Git Bash. Puede iniciar King desde el símbolo del sistema o PowerShell; no se necesita una ventana adicional de Git Bash.

Instalación de Node.js y npm: documentación oficial de npm.

Si no se encuentra node o npm

Node.js/npm falta o no es accesible a través de PATH. Vuelve a abrir primero el terminal. Si el error persiste, repara la instalación de Node.js con npm y la entrada de PATH activadas.

where.exe node y where.exe npm muestran las rutas accesibles; si no devuelven nada, el programa no se encuentra a través de PATH.

where.exe node
where.exe npm

Si PowerShell bloquea npm.ps1, usa npm.cmd en lugar de flexibilizar la directiva de ejecución.

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

Si no se encuentra Git Bash

Instala Git for Windows y abre el terminal de nuevo. Si la instalación se realizó en otro directorio, establece BLUN_SHELL_PATH en la ruta absoluta del archivo bash.exe instalado.

El siguiente ejemplo solo es válido para el símbolo del sistema y esta sesión de terminal; ajusta la ruta a tu instalación. Antes de definirla, comprueba que el archivo existe.

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

Comprobar y mantener actualizado Node.js

Comprueba primero la versión instalada:

node --version
npm --version

Para la instalación inicial mediante npm, Node y npm ya deben estar instalados. Con una versión antigua de Node puede aparecer una advertencia EBADENGINE. Tras una instalación correcta, basta con iniciar por primera vez king o blun; BLUN configura entonces su propio entorno de ejecución.

Alternativa manual

Si la descarga automática o la comprobación de la suma de verificación falla en Windows o macOS, instala Node.js 24 LTS manualmente:

1. Abrir la página de descarga oficial

   Abre nodejs.org/en/download y elige Node.js 24 LTS.

2. Ejecutar el instalador adecuado

   En Windows usa el instalador MSI. En macOS usa el paquete PKG. Elige x64 o ARM64 según tu equipo.

3. Volver a abrir el terminal por completo

   Los terminales ya abiertos suelen usar todavía la ruta de programa antigua.

4. Volver a comprobar la versión

   node --version
   npm --version

Instalación

1. Comprobar requisitos

   node --version
   npm --version

   En Windows y macOS, BLUN puede sustituir una versión Node antigua presente en el primer inicio por su entorno privado. Para la instalación npm, Node y npm ya deben poder invocarse. En Linux necesitas Node.js 24.15.0 o más reciente antes del inicio.

   Node.js, npm y Git Bash en Windows

2. Instalar la versión estable actual

   npm install -g blun-king-cli@latest

3. Comprobar la instalación

   blun --version

4. Ejecutar el diagnóstico

   blun doctor

Arranque e inicio de sesión

Perfil, espacio de trabajo y sesión

Un perfil selecciona la identidad King separada y sus ajustes. Un espacio de trabajo determina qué archivos del proyecto están abiertos. Una sesión contiene el historial de la conversación y el estado de trabajo. Una sesión nueva no es por tanto ni una cuenta nueva ni automáticamente un worktree Git aislado.

king --profile mein-king

--profile pertenece al lanzador king. Para un espacio de trabajo Git aislado usa blun workspace create <nombre>; para continuar una conversación, la selección de sesión. La referencia del terminal explica estos comandos y sus requisitos.

¿Qué comando de inicio debes usar?

Iniciar sesión por primera vez

1. Iniciar el proceso de inicio de sesión

   blun login

2. Completar el inicio de sesión en el navegador

   Inicia sesión con tu cuenta de BLUN y vuelve después a la consola.

3. Abrir la carpeta del proyecto e iniciar

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

Alternativamente, puedes escribir /login en una consola en ejecución. No tienes que copiar ninguna clave de API en un archivo de configuración.

Continuar una sesión

Con /sessions abres la selección de sesiones. También puedes indicar un identificador exacto, un título exacto o un inicio de identificador único. Con varios resultados, eliges la sesión deseada en la lista.

/sessions Rediseño-API

Para la última sesión del directorio de trabajo actual, inicias King en el terminal normal con:

king --continue

Desde 9.1.606 la vista carga primero las entradas de historial más recientes. Por defecto son unas 200; los mensajes y pasos de herramientas que pertenecen juntos permanecen completos y pueden superar esa cantidad. Las páginas más antiguas se alcanzan mediante la navegación del historial. El historial de conversación guardado y el contexto del modelo no se acortan con este límite de visualización.

Puedes ajustar el tamaño objetivo de la visualización entre 1 y 2000 en el inicio interactivo:

king --continue --history-limit 400

Abrir la sesión seleccionada más recientemente al inicio

Si vuelves regularmente al mismo trabajo, puedes añadir este ajuste en tu ~/.blun/tui.toml existente. En Windows, el archivo se encuentra normalmente en %USERPROFILE%\.blun\tui.toml.

resume_last_selected = true

Coloca la línea en la parte superior del archivo, antes de una sección como [editor]. Los demás ajustes se conservan. La selección se guarda de forma adecuada a la cuenta, al agente, al directorio de trabajo y al entorno de ejecución. Una sesión indicada expresamente tiene prioridad. Si la selección guardada ya no está disponible, comienza una nueva sesión. Con false desactivas de nuevo esta opción de inicio.

Elegir un perfil

/profile o /profiles abre la selección de perfiles. Durante un trabajo en curso o con mensajes en espera, el perfil actual permanece activo; elige el otro perfil en cuanto la sesión esté lista.

System32 no es una carpeta de proyecto

Antes de iniciar, ve a tu carpeta de usuario en el símbolo del sistema con cd /d "%USERPROFILE%". También puedes ir a una carpeta de proyecto propia que ya exista. En PowerShell, ve a tu carpeta de usuario con Set-Location $HOME. Después, inicia king.

cd /d "%USERPROFILE%"
king

Elegir la carpeta de trabajo (9.1.603)

Si en Windows eliges otra carpeta de trabajo, se abre un diálogo de carpetas. Puedes seguir introduciendo la ruta a mano. Si cancelas el diálogo, vuelves a la selección de carpetas sin aplicar ninguna.

Si no hay ningún diálogo de carpetas disponible, la consola pregunta por la ruta. En otros sistemas operativos se sigue introduciendo la ruta a mano.

Si al iniciar se aplica o está guardada una carpeta dentro del directorio de Windows, la selección de carpetas propone tu carpeta de usuario. Las rutas introducidas a mano se siguen comprobando como hasta ahora.

Trabajo diario

Definir el esfuerzo de razonamiento y los permisos

Desde 9.1.609, Ctrl+L abre la selección del esfuerzo de razonamiento directamente desde el campo de entrada. Tu texto introducido se conserva. Mientras King trabaja, se rechaza un cambio; vuelve a abrir la selección en cuanto la sesión esté lista. Los niveles disponibles dependen del modelo activo.

El esfuerzo de razonamiento controla con qué minuciosidad trabaja el modelo antes de una respuesta. Los niveles superiores pueden tardar notablemente más.

blun --effort high --permission-mode manual

Elegir el estilo de salida

/output-style abre el selector. Están disponibles Estándar, Conciso, Proactivo, Explicativo y Aprendizaje. La selección se aplica de inmediato a la sesión en curso y se guarda como predeterminada para los siguientes inicios.

Compactar el contexto activo

BLUN Code supervisa el contexto activo para la próxima solicitud al modelo, no simplemente todo el historial guardado. El límite efectivo depende del modelo, de la cuenta y del presupuesto de compactación. Las partes más antiguas se resumen en etapas limitadas; cada etapa reserva espacio para su resumen.

Mientras tanto, aparece en la conversación, por ejemplo, Verdichte ~941,2k Tokens … · 2/~10 · 90 %. 2/~10 muestra la etapa en curso y el número total estimado de etapas. 90 % es la utilización medida de la ventana del modelo en la llamada de compactación actual. Si una etapa falla o no reduce el contexto, se conserva el contexto original.

Ya al alcanzar el 75 por ciento del límite efectivo de compactación, una compactación pequeña y sin pérdidas aligera los resultados de herramientas grandes y antiguos y los argumentos de herramientas ya completados. Con una ventana de modelo de 1.048.576 tokens y una compactación completa a 256.000 tokens, este punto se sitúa en 192.000 tokens. Los últimos 20 mensajes, los textos normales del usuario y el historial bruto guardado permanecen sin cambios.

Compactar de forma proactiva al cerrar un tramo de trabajo

Los usuarios no tienen que introducir ningún comando. En cuanto el contexto activo alcanza la mitad del límite automático de compactación completa, King puede seleccionar CompactConversation después de un tramo de trabajo finalizado. La herramienta programa el proceso seguro de compactación existente para el final del paso de herramienta actual. No abre ningún turno adicional; si la compactación falla, el historial original permanece sin cambios.

Superar una sobrecarga breve del servidor

Ante una sobrecarga del servidor marcada expresamente como repetible (HTTP 429 con x-should-retry: true), BLUN King espera según Retry-After y reenvía la misma solicitud como máximo dos veces. Los errores de autenticación, de cupo y otros errores no repetibles siguen provocando una interrupción inmediata. Si el servidor sigue sobrecargado tras los intentos limitados, el usuario sigue recibiendo el mensaje de error claro.

Reanudar el trabajo delegado tras una interrupción del proveedor

Si un agente individual delegado o un miembro de un enjambre de agentes pierde la conexión con el proveedor, recibe una respuesta vacía del proveedor, su stream se interrumpe por inactividad o el servidor responde con HTTP 408/500/502/503/504, BLUN King reanuda la ejecución del mismo agente a partir de su historial persistente. En agentes individuales y en interrupciones del enjambre distintas de HTTP 429, la primera reanudación espera dos segundos y la segunda, cinco; después permanece visible el error original. HTTP 429 conserva en el enjambre su regla de sobrecarga separada y más larga. Los errores de autenticación, de pago o de cupo, de políticas, de contexto, de herramientas y de código, así como las interrupciones manuales, no desencadenan ninguna reanudación automática. Cada intento de reanudación usa el ID de agente existente para que el trabajo ya finalizado no se repita.

Externalizar los resultados grandes de herramientas

Con resultados de herramientas basados en texto de más de 12.000 caracteres, BLUN King guarda el contenido completo en la carpeta privada de sesión tool-results. En las solicitudes posteriores al modelo permanecen los primeros 1.000 y los últimos 1.000 caracteres, el número exacto de caracteres omitidos y el output_path. Los resultados multimedia mixtos y los resultados ya recortados permanecen sin cambios. Una microcompactación posterior conserva la ruta.

La versión 9.1.104 permite que los comandos de shell en primer plano se ejecuten hasta terminar con normalidad, incluso con salidas muy grandes. King escribe hasta 16 MiB de forma continua en el registro privado de tareas, descarta la salida que supere ese límite y comunica el código de salida real, en lugar de terminar el proceso por el volumen de salida. Las salidas pequeñas, las tareas en segundo plano, los límites de tiempo y las interrupciones manuales permanecen sin cambios.

Read output_path

Ejemplo: un resultado de búsqueda con 30.000 caracteres sigue disponible íntegramente en el archivo local. El modelo ve el principio y el resultado o error final de inmediato; el agente lee a través de la ruta solo las secciones necesarias, en lugar de enviar de nuevo los 30.000 caracteres en cada paso del modelo.

Lotes paralelos de resultados de herramientas

Desde la versión 9.1.99, King considera además los resultados de texto puro directamente consecutivos como un lote. Si el lote supera en total 12.000 caracteres aunque cada resultado individual sea más pequeño, King externaliza tantos de los resultados más grandes a partir de 3.000 caracteres como sean necesarios para quedar por debajo del límite. En el contexto del modelo permanecen referencias legibles; el historial bruto de sesión y los archivos multimedia permanecen sin cambios. El evento de telemetría tool_result_batch_offloaded comunica solo la cantidad y los tamaños en caracteres, no contenidos ni rutas.

Externalizar los mensajes grandes de usuario

Si un mensaje real de usuario contiene más de 200.000 caracteres de texto, BLUN King guarda el texto completo en la carpeta privada conversation-history. En el contexto del modelo permanecen las primeras cinco y las últimas cinco líneas, las indicaciones de tamaño y un output_path. Con Read y el output_path, el agente lee solo las páginas necesarias. Las imágenes, el audio y otros componentes no textuales permanecen adjuntos. La transcripción visible y el historial bruto guardado siguen conteniendo el mensaje original completo. Los mensajes con exactamente 200.000 caracteres permanecen completos en el contexto; si falla la escritura, ocurre lo mismo.

Limitar las búsquedas Grep grandes

En el modo de salida content, Grep termina ripgrep después de offset más head_limit más una línea completa de vista previa. La línea adicional solo sirve para reconocer otra página. Con head_limit=250 y offset=0 se leen como máximo 251 líneas de resultado completas. Con head_limit=0, para count_matches y para los files_with_matches ordenados por fecha de modificación, King sigue leyendo el resultado completo.

Seguir leyendo archivos grandes con precisión

Los archivos grandes se siguen leyendo por páginas. Si Read alcanza su límite interno de 1.000 líneas y el archivo contiene más líneas, el resultado indica el siguiente line_offset exacto. Ejemplo: una lectura desde la línea 2001 continúa con line_offset=3001. Al final del archivo y con un tramo de lectura deliberadamente menor no aparece ninguna indicación. Así, el agente no saca conclusiones de un tramo incompleto ni vuelve a leer el archivo desde la primera línea.

Usar hilos de conversación

Agentes en segundo plano

Los agentes en segundo plano aparecen con tarea y estado en la vista de agentes. Puede abrir la salida, enviar una consulta o detener al agente. Los hooks y el diagnóstico del servidor de lenguaje integrado comprueban los archivos modificados tras operaciones de escritura y edición.

La versión 9.1.105 añade TaskUpdate para agentes en segundo plano en curso. King transmite instrucciones adicionales en el siguiente paso seguro del modelo al mismo agente activo, sin detenerlo ni iniciar otro agente. Las tareas desconocidas y ya finalizadas, las tareas de shell y los agentes que ya no aceptan ninguna actualización se siguen rechazando como hasta ahora.

La versión 9.1.106 permite a los perfiles de agente excluir herramientas por su nombre. King aplica estas exclusiones solo después de reunir las herramientas cargadas de forma permanente, las cargadas dinámicamente y las de MCP. Los perfiles estándar coder, explore y plan no pueden responder ni reaccionar por Telegram, ni editar mensajes ni descargar adjuntos; el agente principal permanece sin cambios. Así, los agentes delegados no envían mensajes al margen del agente principal y sus solicitudes al modelo contienen menos esquemas de herramientas. Las herramientas indicadas por su nombre que no se encuentren se notifican de forma visible.

La versión 9.1.107 muestra los errores del proveedor en un lenguaje comprensible para el cliente; los códigos de error internos y las indicaciones de soporte no aparecen. /help ofrece una lista de comandos navegable con las teclas de flecha y abre con la flecha derecha o la tecla Intro una descripción detallada del comando seleccionado.

La versión 9.1.108 elimina de la proyección del modelo las indicaciones de sistema idénticas e inyectadas repetidamente. Por tipo de indicación permanece visible la copia exacta más reciente. Las indicaciones modificadas, los mensajes normales de usuario, las llamadas a herramientas, los contenidos mixtos y el historial bruto de sesión guardado permanecen sin cambios. Así, los datos enviados al proveedor en sesiones largas se reducen sin recortar el historial guardado, las exportaciones ni las reanudaciones.

Cargar herramientas y Skills bajo demanda

Desde la versión 9.1.595, King vuelve a cargar los esquemas de herramientas opcionales de forma selectiva mediante ToolSearch, en lugar de enviar el catálogo completo en cada solicitud. La selección conservada es limitada; las herramientas siguen siendo localizables aunque su esquema no se envíe en ese momento. Las comprobaciones normales de permisos siguen vigentes. Los catálogos grandes de Skills se proporcionan de forma compacta y por páginas.

Ante saludos breves, King puede usar un tramo limitado del diálogo más reciente. Las instrucciones del sistema se conservan; para una tarea de trabajo se vuelve a tener en cuenta el historial de trabajo conservado. Esto no borra ningún mensaje guardado. Por ello, un saludo no tiene un precio fijo en tokens: el contexto del sistema, las herramientas, las repeticiones y la comprobación de respuestas siguen contribuyendo al consumo.

/context muestra el tamaño estimado del contexto de la próxima solicitud y el límite vigente. /context-doctor o /tokens completa la vista con los datos de diagnóstico disponibles; /usage muestra la vista de consumo y cupos. Los valores estimados, el consumo acumulado de la sesión y los tokens realmente facturados son magnitudes distintas.

Los catálogos de herramientas grandes se exploran mediante la búsqueda de herramientas cuando es necesario. Desde 9.1.615, el presupuesto de herramientas sigue la ventana de contexto declarada por el proveedor. Las herramientas encontradas permanecen disponibles en el siguiente paso; sus descripciones completas no tienen que enviarse en cada encargo.

/context doctor: Distingue el historial guardado, las cantidades de tokens estimadas y el número de bytes de la solicitud serializada. Muestra las contribuciones registradas de las reglas AGENTS, los archivos Mistake, Memory, Skills y las definiciones de herramientas. La falta de datos de origen no significa cero bytes.

Los bytes de solicitud, las cantidades de tokens estimadas, el consumo acumulado de la sesión y los tokens facturados son magnitudes distintas. La vista de consumo tiene en cuenta también la comprobación de respuestas. /usage cost con los costes diarios o mensuales no forma parte de esta versión. Unos costes menores o unas respuestas más rápidas en producción no están demostrados.

Cada intento HTTP recibe un nuevo x-request-id, salvo que quien realiza la llamada indique uno. Los identificadores indicados permanecen sin cambios y no se registran como texto externo arbitrario. El identificador sirve para relacionar las mediciones de cliente y servidor; no es una clave de facturación.

Control de la sesión en 9.1.604

/queue: Muestra o cambia cómo esta sesión procesa los mensajes entrantes. Los modos se llaman steer, followup, collect e interrupt; reset o default elimina el ajuste específico de la sesión.

Sin un ajuste específico de la sesión, King usa steer con 500 milisegundos de espera de agrupación y un tamaño de lote máximo de 20 mensajes. /queue muestra los valores en vigor; /queue reset elimina solo el ajuste específico de la sesión.

steer entrega las nuevas entradas en el siguiente punto de entrega adecuado; si no es posible, esperan al siguiente ciclo. followup espera hasta el final del ciclo en curso. collect agrupa las entradas; interrupt interrumpe el ciclo en curso para entradas nuevas.

/queue collect debounce:500ms batch:10

Se admiten valores de debounce:0ms a debounce:60s y de batch:1 a batch:100. batch limita el tamaño del lote sin borrar los mensajes sobrantes. No existe ninguna opción cap: ni drop:. La regla de cola y la vista de consumo se conservan al reanudar la misma sesión. Los mensajes nuevos ordinarios de un canal ya no provocan automáticamente una interrupción al cabo de 30 segundos.

/session [ID|Título]: Abre el selector de sesiones o elige una sesión por su identificador exacto, su título exacto o un prefijo inequívoco del identificador. Si hay varias coincidencias, se abre el selector.

/question: Vuelve a abrir las consultas pendientes. Contraer una consulta no la responde ni la descarta.

/usage: Muestra el consumo y los cupos disponibles. off, tokens y full guardan el modo de visualización para esta sesión. reset elimina este ajuste; inherit, clear y default son equivalentes.

/settings: Abre los ajustes, incluidas las opciones de visualización locales.

9.1.605

/context map muestra el desglose de bytes disponible de la última solicitud registrada. /context list, /context detail y /context doctor abren el informe detallado. Distingue archivos de instrucciones, Memory, Skills, definiciones de herramientas y textos de historial asignados. Los valores de medición ausentes permanecen marcados como no disponibles; no se cuentan como cero.

king --message "Comprueba los tests pendientes" entrega un primer mensaje a la consola interactiva. Se procesa tras la confirmación al inicio y la selección de sesión, a través de las comprobaciones normales de mensajes y de la cola. Su contenido no se interpreta como comando slash ni de shell. La confirmación al inicio y las comprobaciones de permisos no se omiten por ello.

/abort interrumpe el proceso en curso sin descartar las entradas pendientes. /stop descarta además las entradas pendientes. /exit sigue cerrando la consola. Son comandos locales de consola, no comandos remotos adicionales de Telegram.

La línea adicional de agente/sesión en el borde inferior se elimina. La selección de sesiones y el diagnóstico siguen disponibles a través de los comandos existentes.

Distinguir el contexto actual del historial guardado

Un historial guardado largo no tiene que caber por completo en una sola petición al modelo. King puede condensar el contexto de trabajo activo y proporcionar las salidas de herramientas antiguas mediante referencias verificadas. Los originales completos se conservan para una relectura selectiva.

Desde 9.1.617, la vista previa de las salidas de herramientas grandes tiene en cuenta también la ventana de contexto disponible. Al recargar la misma sesión, las instrucciones de plugins sin cambios no se vuelven a añadir siempre. Con /context doctor compruebas la petición capturada; /context map muestra su reparto de bytes disponible.

Para los archivos de instrucciones como AGENTS.md se aplica en la consola King desde 9.1.614: permanecen completos mientras el límite de petición lo permita. Los archivos más grandes no detienen un encargo solo por su tamaño. El antiguo recorte general de 9.1.613 ya no describe el camino actual de la consola.

Mantener visibles las tareas y las salidas

Una lista de tareas demasiado larga se puede desplegar con Ctrl+T. Las salidas largas de herramientas se muestran acortadas en el historial y se pueden ampliar con Ctrl+O. La entrada, el indicador de actividad y las dos líneas de estado pertenecen a la consola. /tasks abre las tareas en segundo plano; /copy copia la última respuesta disponible. La referencia de comandos contiene todos los comandos integrados, así como la vista de los atajos de teclado y de las herramientas de agente.

Supervisar los turnos largos

Desde la versión 9.1.40, la consola informa de un turno cuando no ha llegado ningún resultado nuevo de herramienta durante 20 minutos. La línea de estado muestra el tiempo transcurrido, la última herramienta usada y el número de errores repetidos. Cinco llamadas fallidas consecutivas de la misma herramienta con los mismos argumentos terminan el turno con un mensaje de error claro, en lugar de que siga ejecutándose sin que nadie lo note.

Skills, plugins y MCP

Los Skills son instrucciones de trabajo reutilizables. Los plugins pueden proporcionar además herramientas, Skills y comandos propios. MCP conecta la consola con servidores de herramientas configurados.

Usar los Skills existentes

Describe tu encargo de forma concreta para que King pueda encontrar las instrucciones adecuadas. Para una instrucción determinada, introduces / en el campo de entrada y eliges el Skill ofrecido. Los Skills integrados aparecen con su nombre; los propios normalmente como /skill:<nombre>. Las sugerencias de tu instalación muestran los nombres realmente disponibles.

/skill:angebot-pruefen comprueba la oferta en la carpeta del proyecto

Este ejemplo funciona después de haber creado tu propio Skill llamado angebot-pruefen. Si entran en consideración varias instrucciones, puedes pedir primero a King una comparación y una recomendación.

Añadir una instrucción propia

Crea por ejemplo .agents/skills/angebot-pruefen/SKILL.md en el proyecto. Un archivo de Skill contiene un nombre, una descripción del ámbito de aplicación y los pasos de trabajo propiamente dichos:

---
name: angebot-pruefen
description: comprobar las ofertas en cuanto a alcance de los servicios, plazos y preguntas abiertas.
---

Lee la oferta completa.
Comprueba el alcance de los servicios, los plazos, las exclusiones y las preguntas abiertas.
Nombra para cada hallazgo el pasaje correspondiente en el documento.
Muestra el resultado antes de modificar archivos.

Los Skills de proyecto también se buscan en .blun/skills. Para instrucciones que abarcan varios de tus proyectos existen ~/.agents/skills y ~/.blun/skills. En Windows, ~ designa tu carpeta de usuario. Tras añadirlo, reinicia King o recarga la sesión con /reload en cuanto esté lista, y comprueba las sugerencias de barra inclinada.

Para una carpeta de Skills elegida expresamente, puedes iniciar King así:

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

Esta opción sustituye la búsqueda automática en las carpetas de Skills de usuario y de proyecto para este inicio. Puedes repetirla para varias carpetas. Un Skill de GitHub debe encontrarse en una de estas carpetas con su estructura de carpetas y un SKILL.md válido.

Instalar y gestionar plugins

/plugins abre la gestión de plugins. Allí puedes ver el mercado y comprobar los plugins existentes. Los comandos list, info, install, enable, disable y remove también están disponibles.

/plugins list

Para la instalación introduces /plugins install <fuente> o eliges una entrada del catálogo. Comprueba la fuente y la información mostrada, y confirma la instalación ofrecida. Un plugin desactivado permanece instalado; remove lo elimina tras la confirmación. Un plugin puede ofrecer sus propios comandos de barra inclinada, por ejemplo /<plugin>:<comando>.

Comprobar las conexiones de herramientas

Con /mcp abres la vista MCP. La gestión de plugins muestra además los servidores MCP de un plugin. Una instrucción instalada no sustituye a una conexión con el servicio correspondiente. Comprueba en la vista respectiva si la conexión está activa antes de hacer depender un encargo de ella.

Objetivos, trabajo recurrente y subagentes

Tratar un objetivo hasta el resultado

/goal guarda un objetivo concreto. Describe el resultado deseado, los cambios permitidos y en qué se reconoce la finalización.

/goal Comprueba las pruebas abiertas, corrige las causas en el proyecto y muestra los resultados de las comprobaciones.

Con /goal status compruebas el estado. /goal pause detiene el objetivo, /goal resume lo reanuda y /goal cancel lo finaliza y elimina. /goal edit <objetivo> cambia el encargo; /goal replace <objetivo> sustituye expresamente el objetivo activo.

Con /goal next <objetivo> reservas un encargo siguiente. /goal next manage abre la gestión de estos objetivos siguientes. Un nuevo encargo o la reanudación de un objetivo solo comienza cuando la sesión está lista.

Repetir una tarea

/loop repite un prompt en el intervalo elegido. Indica siempre qué debe comprobarse y ante qué resultado King debe informarte.

/loop 10m Comprueba los resultados de las pruebas existentes e informa solo de errores nuevos.

/loop status, /loop pause, /loop resume y /loop stop controlan la repetición. Pausar una repetición e interrumpir un trabajo en curso son acciones separadas: para el trabajo en curso existen /abort y /stop.

Hacer una pregunta al margen del encargo principal

/btw <pregunta> inicia una pregunta secundaria en una conversación derivada. /swarm <tarea> reparte una tarea explícitamente encargada entre varios agentes. Con /tasks ves las tareas en segundo plano y sus resultados.

Para un plan aún abierto también están disponibles /premortem, /idea, /chancenradar y /curiosity. Sus diferencias, límites y comandos de control se encuentran en la referencia de comandos.

Encargos únicos sin interfaz interactiva

Con -p transmites un encargo único desde el terminal normal. King muestra el resultado y finaliza la llamada. Esto sirve por ejemplo para un resumen en un script.

king -p "Resume brevemente el README de este proyecto."

Para los programas puedes elegir --output-format json o --output-format stream-json. Sin esta opción se muestra texto.

king -p "Resume brevemente el README de este proyecto." --output-format json

El mensaje de inicio interactivo --message y la visualización del historial --history-limit pertenecen al inicio interactivo y no pueden combinarse con -p.

Comprobación de respuestas en 9.1.600

La comprobación de respuestas sigue limitada en el tiempo: los comprobadores generales tienen 30 segundos. Tras la señal de inicio del componente de host de confianza, la comprobación nativa de idioma dispone, una sola vez por cada intento de comprobación externo, de hasta 90 segundos para el primer texto con contenido. El plazo de espera se restablece a 30 segundos cada vez que llega texto con contenido dentro de la longitud de salida permitida y en cada una de las transiciones ordenadas hacia la aprobación y hacia la comprobación de recibos.

Independientemente de ello, se aplica por intento de comprobación externo un límite total de 120 segundos; como máximo se permiten dos intentos externos. Antes de aceptar una aprobación se vuelve a comprobar el tiempo realmente transcurrido, también con llamadas de temporizador retrasadas. El progreso tardío no puede renovar un plazo vencido. Las señales de interrupción se siguen teniendo en cuenta. Se siguen comprobando la vinculación al texto de respuesta exacto, la validez temporal del recibo de aprobación y la autorización.

La versión 9.1.604 contiene AgentSpine 0.73.0 y Translate Native 6.155.0; el protocolo de Guard permanece en 6.20.0. Con ello no se demuestra ninguna solución de los errores HTTP 502 en producción. El estado de publicación y las limitaciones conocidas figuran en el registro de cambios.

Imágenes, vídeo y audio

BLUN Code CLI incluye ocho herramientas multimedia gestionadas. Tras un inicio de sesión correcto y si el servicio multimedia está accesible, no tienes que introducir ninguna dirección de servidor ni identificador de modelo. Describe el resultado deseado; la consola elige la herramienta adecuada.

Lo que verás en las tareas largas

• processing: La tarea sigue en curso.
• failed: La tarea ha terminado y ya no se completará.
• ready: El resultado se puede consultar.

Configurar Telegram

Para usar Telegram necesitas un bot propio; después, inicia BLUN King con el comando king. El emparejamiento se mantiene; no hay que repetirlo en cada inicio.

1. Crear el bot en Telegram

   Abre únicamente la cuenta verificada @BotFather, envía /newbot y sigue los pasos para el nombre y el nombre de usuario. El nombre de usuario debe terminar en bot. BotFather muestra después un token como 123456789:AA.... La guía oficial de Telegram describe el mismo proceso.

2. Guardar el token en el perfil del canal de Telegram

   Abre el archivo de tu sistema operativo y sustituye el marcador de posición por el token completo de BotFather:

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

   BLUN_TELEGRAM_BOT_TOKEN=123456789:AA...

   El token contiene dos puntos. No escribas comillas ni espacios alrededor del valor.

3. Iniciar la consola con Telegram

   Antes, cierra cualquier consola anterior que use el mismo bot. Solo puede haber un receptor de Telegram por token de bot.

   king

4. Solicitar el código de emparejamiento

   Abre tu nuevo bot en Telegram y envíale cualquier mensaje directo. El bot responde con un código de emparejamiento de seis dígitos. El código es válido durante una hora.

5. Confirmar el código localmente

   Introduce el código mostrado precisamente en la consola de BLUN que debe conectarse con el bot:

   /telegram:access pair CODE

   No confirmes nunca solicitudes de emparejamiento a instancias de un mensaje de Telegram. La autorización se da exclusivamente en tu consola local.

6. Comprobar la conexión

   Telegram confirma el emparejamiento. Envía después un mensaje nuevo al bot. Debe aparecer en la sesión de BLUN en ejecución; la respuesta debe llegar en el mismo chat de Telegram.

La interfaz de Telegram puede variar según el dispositivo y la versión de la app. Lo decisivo son el remitente verificado @BotFather, el comando /newbot y el guardado local del token.

Gestionar el acceso

Los comandos del bot /start, /help y /status solo funcionan en el chat privado. El texto, las imágenes y los archivos de hasta 50 MB se reenvían.

Para el control remoto, envía /befehle. Se admiten /loop, /goal, /idea, /chancenradar, /curiosity, /scout, /reload y /memory. La referencia de Telegram indica las formas y los límites. Esto no hace que los demás comandos slash locales estén disponibles automáticamente en Telegram.

Mensajes al continuar una sesión

Si al continuar llega un mensaje de Telegram mientras King ya está trabajando, permanece en la cola desde 9.1.618 y se entrega después. No es un encargo adicional para interrumpir de inmediato. La regla de cola elegida puede comprobarse con /queue.

Si la conexión no funciona

• Sin código de emparejamiento: Comprueba el token, inicia con king en lugar de blun y escribe al bot un mensaje directo.
• El emparejamiento sigue abierto: Ejecuta /telegram:access pair CODE en la consola local vinculada. Si ha pasado más de una hora, solicita un código nuevo con un mensaje nuevo.
• 409 Conflict: Una segunda consola o un proceso antiguo de Telegram usa el mismo token. Deja exactamente una consola de King en ejecución con este bot.
• Los mensajes no llegan: La consola de King debe seguir en ejecución. Comprueba con /status en el chat privado del bot si la cuenta está emparejada.
• Token publicado por error: Revócalo de inmediato en @BotFather, genera un token nuevo y sustituye el valor en el archivo .env.

Memory y Mistakes

En el primer arranque con la sesión iniciada, la consola pregunta por separado por Memory personal y por el envío de datos de errores depurados.

• Tanto el sí como el no se guardan. Una negativa no provoca una pregunta nueva en cada inicio.
• Las decisiones son independientes. Un cambio en Mistakes no sobrescribe Memory y viceversa.
• Sin consentimiento expreso no se escribe nada por la vía correspondiente.

Ampliar Memory deliberadamente

blun memory remember "Ten en cuenta esta decisión en el futuro"

Esta llamada requiere el consentimiento de la cuenta conectada y un servicio Memory personal accesible. Las notas de persona, los metadatos de herramientas locales y las herramientas de memoria proporcionadas por MCP son vías separadas.

Memoria de herramientas local

King puede registrar las llamadas de herramientas finalizadas como metadatos locales: nombre de la herramienta, momento, estado y, en el caso de herramientas de archivos, posiblemente la ruta. Las entradas no contienen argumentos de herramientas completos, ni salidas, ni comandos, ni claves.

/memory tools status

Con /memory tools on respectivamente /memory tools off controlas el registro. /memory tools status muestra si está activo. Esta función es independiente de la memoria personal y del protocolo completo de sesión.

Comprobar el estado de Mistake

blun mistakes status

La referencia del terminal explica la subida, la repetición, la sincronización, la observación y la eliminación o restauración motivada. Para la transferencia se requieren un destino configurado y su autenticación.

Actualizaciones

Al iniciar, la consola comprueba si hay disponible una nueva versión estable. El diálogo ofrece tres decisiones:

1. actualizar ahora,
2. omitir esta vez,
3. esperar hasta la próxima versión.

También puedes iniciar una actualización expresamente:

king update

Tras una actualización correcta, BLUN muestra la versión anterior y la instalada, así como los cambios más importantes. Si Telegram está configurado, BLUN envía la misma nota una sola vez a los chats directos autorizados. Los grupos no reciben ninguna nota automática de actualización.

Ir al registro de cambios

Diagnóstico

blun doctor

Windows: cerrar la ventana y reiniciar

La versión 9.1.620 corrige la finalización completa al cerrar la ventana de la consola. Así, en el próximo inicio ninguna instancia restante debería volver a provocar el mensaje «ya en ejecución». La finalización regular desde la consola sigue siendo /exit.

Si el mensaje sigue apareciendo, comprueba primero la versión instalada y si la consola correspondiente sigue en ejecución. Una sesión activa solo puede tener un propietario de escritura. No elimines ningún archivo de bloqueo mientras la consola asociada siga trabajando.

Cuando aparece «Compactación en pausa»

Desde 9.1.619 King solo cuenta los errores de compactación directamente consecutivos. Tras una compactación exitosa, un error anterior aislado ya no es un motivo de bloqueo adicional. El mensaje «Compactación en pausa» designa intentos de resumen fallidos; ya no afirma de forma general que tu contexto está lleno. Comprueba el mensaje exacto y el diagnóstico antes de reiniciar la sesión.

Distinguir entre errores y tiempos de espera

Desde la versión 9.1.596, una interrupción automática en favor de mensajes de Telegram en espera ya no se muestra como pulsación de la tecla Escape. Una interrupción manual real sigue siendo algo distinto.

La versión 9.1.597 reconoce los mensajes de error que nombran expresamente un límite de contexto superado, también dentro de una respuesta de error de gateway. Antes de que empiece una salida, es posible un nuevo intento limitado con un límite de salida menor. Los mensajes y las herramientas no se borran por ello. Esto no resuelve un error general de conexión ni una caída del servicio.

Hallazgo histórico en 9.1.597: Un límite inferior declarado para el número de tokens de entrada podía provocar otro intento fallido y compactaciones innecesarias. El hallazgo se reprodujo el 17 de septiembre de 2026. Las correcciones posteriores y sus respectivos estados de publicación están documentados en el registro de cambios.

Los tiempos de espera largos de Retry-After y la pausa restante tras una reanudación de sesión se tienen en cuenta. Un reinicio no es una forma de eludir un tiempo de espera solicitado.

Registros para el análisis de errores

Las llamadas a herramientas y sus resultados figuran en el registro de sesión wire.jsonl. Para un diagnóstico específico puedes usar /export-debug-zip. Comprueba el contenido antes de compartirlo por si contiene datos privados. Un registro de errores mantenido deliberadamente, como mistake.md, no sustituye estos registros de eventos.

Limitaciones, con transparencia

• La IA puede equivocarse. Comprueba las afirmaciones importantes, los archivos y los comandos ejecutados.
• Las herramientas gestionadas necesitan un inicio de sesión y servicios de BLUN accesibles.
• Las tareas multimedia aún no muestran ningún progreso porcentual. processing es un estado, no una indicación de tiempo.
• Una respuesta 200 o una comprobación parcial en verde solo acredita el tramo medido. Comprueba un flujo completo, desde la primera entrada del usuario hasta el resultado.