BLUN Code · Referencia completa
Comandos y herramientas
Los comandos slash empiezan por / y se escriben en el campo de entrada de la consola de BLUN en ejecución. Los comandos del sistema operativo, como king update, king --version, npm o node, se ejecutan en cambio en PowerShell o en otro terminal.
Inicio rápido
Con /help verás los comandos de tu versión instalada. Dale a tu agente un nombre con /name Ada o inicia una tarea periódica con /loop 10m comprueba el estado de la compilación.
Ideas, oportunidades y ejecución autónoma
Estos comandos se diferencian por su tarea: /idea y /chancenradar trabajan dentro del alcance indicado expresamente. /curiosity solo investiga y no implementa nada.
/idea <Objetivo>
Qué hace el comando: BLUN crea primero una lista de tareas concreta y persigue el objetivo indicado hasta obtener un resultado verificado. Un informe de investigación, un concepto o un borrador pueden ser ya el resultado completo. La implementación solo empieza si forma parte de la tarea. Durante el trabajo, permanece activo exactamente un paso del plan.
Cuándo tiene sentido: Usa /idea cuando una idea vaga deba convertirse en un resultado concreto y no quieras indicar cada paso intermedio por separado.
/idea desarrolla un mejor proceso de incorporación para nuevos clientesQué ocurre después: BLUN sigue trabajando hasta que cada punto esté terminado, bloqueado por un motivo claro, cancelado o preparado para su aprobación. Rigen el mismo modo de permisos y las mismas indicaciones expresas que fuera de /idea. Este modo de trabajo no concede permisos adicionales ni levanta ninguna prohibición de modificar o publicar.
Control: /idea status, /idea pause, /idea resume, /idea stop y /idea clear gestionan el modo activo.
/chancenradar <Objetivo>
Qué hace el comando: El radar de oportunidades busca en fuentes públicas actuales problemas concretos que aún no estén bien resueltos. Registra las fuentes y la fecha de consulta, separa las observaciones de las conclusiones y de lo desconocido, y evalúa cada oportunidad seria según el problema, las personas afectadas, las pruebas, las alternativas existentes, el impacto, el esfuerzo y la seguridad.
Cuándo tiene sentido: Usa el comando cuando no busques una idea cualquiera, sino la oportunidad de producto, de mercado o de mejora mejor documentada.
/chancenradar encuentra la mejor función nueva para nuestro software de contabilidadQué ocurre después: Los hallazgos débiles o duplicados se descartan. BLUN justifica el orden de prioridad, elige la oportunidad más sólida y ejecuta el mejor paso siguiente que sea local y seguro. No se inventan el tamaño del mercado, la demanda, las opiniones de los usuarios ni el alcance.
/curiosity [Sector o problema]
Qué hace el comando: /curiosity inicia una exploración abierta pero estructurada. Con un tema, BLUN busca conexiones sorprendentes y oportunidades sin aprovechar. Sin tema, BLUN le ayuda primero a elegir un nicho adecuado. El alias es /scout.
Cuándo tiene sentido: Usa el modo cuando la dirección aún no esté fijada, quieras descubrir algo nuevo y la investigación deba desembocar igualmente en una decisión fundamentada y en un siguiente paso.
/curiosity herramientas digitales para pequeñas empresas artesanalesQué ocurre después: BLUN examina como máximo doce páginas de fuentes, con un máximo de 24 intentos de consulta en total. El informe presenta hasta tres posibilidades documentadas o indica expresamente que no se encontró ningún resultado viable. No se modifica ningún archivo ni se inician subagentes o bucles en segundo plano. Cada posibilidad fundamentada puede ir acompañada de una tarea /idea preparada; solo cuando tú eliges una se abre una tarea de implementación independiente.
Inicio, historial y exportación
| Comando | Qué ocurre | Alias o ejemplo |
|---|---|---|
| /help | Muestra los comandos y atajos de teclado disponibles actualmente. | /h, /? |
| /new | Inicia una nueva sesión en el espacio de trabajo actual. Las sesiones guardadas anteriormente no se eliminan por ello. | /clear |
| /sessions [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. | /resume, /session |
| /profile | Abre la selección de perfil. King solo cambia cuando tu sesión está lista. El trabajo en curso y los mensajes en espera impiden un cambio prematuro; tu perfil anterior permanece entonces activo. | /profiles |
| /question | Vuelve a abrir las consultas pendientes. Contraer una consulta no la responde ni la descarta. | /question |
| /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. | /queue collect debounce:500ms batch:10 |
| /fork | Deriva la sesión actual. La nueva sesión comienza con el historial existente; no se crea ninguna rama Git por ello. | /fork |
| /title [Título] | Muestra el título de la sesión o guarda un título nuevo de hasta 200 caracteres. | /rename Rediseño-API |
| /compact [Instrucción] | Condensa las partes antiguas de la conversación mediante un resumen del modelo. Una instrucción opcional determina qué debe conservarse. Los archivos de instrucciones como AGENTS.md no se modifican por ello; el resumen puede consumir tokens. | /offload; ejemplo: /compact conserva los tests pendientes |
| /undo [Cantidad] | Retira el último prompt o varias entradas propias del historial. Los cambios de archivos ya ejecutados o las acciones externas no se deshacen automáticamente por ello. | /undo 2 |
| /export-md [Ruta] | Exporta la sesión actual como archivo Markdown. Comprueba el contenido privado de la conversación antes de transmitirlo. | /export |
| /copy | Copia la última respuesta disponible del asistente al portapapeles. | /copy |
| /export-debug-zip | Crea un ZIP de depuración de la sesión actual para un análisis de errores específico. Comprueba los datos de diagnóstico y de conversación incluidos antes de transmitirlo. | /export-debug-zip |
| /web | Abre la sesión actual en la interfaz web y cierra después la vista del terminal. | /web |
| /exit | Cierra BLUN Code. | /quit, /q |
| /version | Muestra la versión instalada y la información de versión correspondiente. | /version |
Trabajo y automatización
| Comando | Qué ocurre | Ejemplo |
|---|---|---|
| /abort | Interrumpe la operación en curso sin descartar las entradas pendientes. | /abort |
| /stop | Interrumpe la operación en curso y descarta las entradas pendientes. Esto no cierra la consola. | /stop |
| /god | Activa el modo de permisos más amplio. Las reglas de protección siguen vigentes y las acciones externas o peligrosas bloqueadas expresamente siguen bloqueadas. | /yolo, /yes |
| /goal [Acción u objetivo] | Inicia o gestiona un objetivo. Sin argumento, el comando muestra el estado. pause detiene el objetivo, resume lo reanuda y cancel lo elimina; clear y stop son equivalentes. edit <objetivo> cambia el encargo, replace <objetivo> lo sustituye. next <objetivo> reserva un encargo siguiente y next manage abre su gestión. | /goal corrige todos los tests que fallan |
| /loop [Intervalo] [Prompt] | Inicia o gestiona un prompt recurrente. Antes del intervalo se permiten start y palabras de relleno como mit, alle o jede. Sin argumento, el comando muestra el estado; pause, resume y stop controlan la ejecución. Si falta un intervalo válido, BLUN muestra la sintaxis correcta del comando en lugar de un mensaje técnico sobre el intervalo. | /loop mit 5m comprueba el servicio |
| /premortem [Plan o decisión] | Examina un plan antes de implementarlo para detectar puntos débiles. BLUN parte de la base de que el plan ha fracasado, ordena las causas de error plausibles por impacto y probabilidad, indica señales de alerta tempranas, contramedidas y puntos de cancelación y de decisión, y concluye con los tres pasos más eficaces para reducir el riesgo. El plan permanece visible en el chat; la tarea de análisis se añade internamente. | /premortem publica hoy la nueva API |
| /swarm [on|off|Tarea] | Conmuta el modo swarm o ejecuta exactamente una tarea en el swarm. Otros agentes pueden provocar un consumo adicional de tokens; el tiempo de ejecución debe admitir swarm. | /swarm comprueba el frontend y la API |
| /btw [Pregunta] | Plantea una pregunta a un agente secundario derivado sin sustituir la misión principal. El trabajo adicional del modelo puede consumir tokens. | /aside, /side; /btw ¿qué tests siguen fallando? |
| /tasks | Abre la vista general de las tareas en segundo plano en curso y finalizadas. | /task |
| /improve | Muestra los candidatos de aprendizaje guardados y su estado. El comando es una vista general, no una aprobación global de cambios. | /learning |
| /init | Analiza la base de código abierta y crea un archivo AGENTS.md adecuado. | /init |
Ajustes y visualización
| Comando | Qué ocurre | Alias o ejemplo |
|---|---|---|
| /auto [on|off] | Activa o desactiva el modo de permisos automático. Sin argumento, se alterna el modo actual. | /auto on |
| /permission | Abre el selector del modo de permisos. | /permission |
| /settings | Abre los ajustes, incluidas las opciones de visualización locales. | /config |
| /output-style | Abre el selector del estilo de salida preferido. Están disponibles Estándar, Conciso, Proactivo, Explicativo y Aprendizaje. La selección se aplica de inmediato y se guarda como predeterminada. | /style |
| /plan [on|off|clear] | Activa o desactiva el modo de plan. clear elimina un plan existente y solo es posible en reposo. | /plan on |
| /effort [Nivel] | Abre la selección de esfuerzo o cambia el esfuerzo de razonamiento del modelo. La adopción requiere un límite de solicitudes libre; solo se ofrecen niveles admitidos por el modelo. | /thinking high |
| /name [Nombre] | Muestra el nombre del agente o guarda un nombre personal de hasta 40 caracteres. King intenta después recargar el contexto de la sesión. | /name Ada |
| /persona [name …|note …] | Muestra la persona. name cambia el nombre; note, remember o merke añade una nota de hasta 200 caracteres. reset vacía la persona; export muestra sus datos. Las notas de persona son independientes de la memoria personal de la cuenta. | /persona note Responde brevemente |
| /language [Idioma] | Muestra o cambia el idioma de la interfaz y de las respuestas. | /languages Deutsch |
| /theme [Tema] | Abre el selector de temas o aplica un tema directamente. | /theme |
| /editor [Comando] | Muestra o define el editor externo que se abre con Ctrl-G. | /editor code --wait |
| /reload | Recarga la sesión y aplica los ajustes del entorno de ejecución y de la interfaz. | /reload |
| /reload-tui | Recarga solo los ajustes de la interfaz del terminal; la sesión se mantiene. | /reload-tui |
| /status | Muestra el estado actual de la sesión y del entorno de ejecución. | /status |
| /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. | /usage full |
| /context | Muestra el contexto de solicitud estimado, el límite de contexto efectivo y el espacio restante calculado. map muestra el desglose de bytes disponible; list, detail y doctor abren el informe detallado. | /context |
| /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. | /tokens, /context doctor |
| /summarization-model [Modelo|inherit] | Abre la selección del modelo de compactación o establece un modelo configurado. inherit adopta el modelo de la sesión. Los cambios solo son posibles en reposo. La selección se guarda y la misma sesión se recarga. | /summary-model, /compaction-model |
Servicios, accesos y áreas de trabajo
| Comando | Qué ocurre | Alias o ejemplo |
|---|---|---|
| /mcp | Muestra el estado de los servidores MCP y abre su gestión. | /mcp |
| /plugins | Abre la gestión de plugins. Allí se pueden buscar, instalar, activar, desactivar, recargar o eliminar plugins. | /plugins |
| /agent-spine | Instala el plugin AgentSpine si falta, lo activa si está desactivado o abre su gestión si ya está activo. Se mantiene el flujo habitual de plugins y aprobaciones. | /agent-spine |
| /telegram-access | Gestiona el token del bot de Telegram y los chats que pueden enviar mensajes. | /telegram-acces |
| /add-dir [list|Ruta] | Enumera las carpetas adicionales del área de trabajo o añade otra carpeta. | /add-dir ../api |
| /experiments | Abre la gestión de las funciones experimentales. | /experimental |
| /memory status|on|off | Muestra el estado de la memoria personal o la activa o desactiva según tu decisión. /memory tools status|on|off controla por separado los metadatos locales de herramientas. | /memory status |
| /login | Selecciona una plataforma e inicia sesión. | /login |
| /logout | Te desconecta de un proveedor configurado. Las sesiones guardadas no se eliminan por ello. | /disconnect |
| /feedback | Abre el diálogo para enviar comentarios a BLUN. | /feedback |
Comandos de Skills y plugins
La guía CLI explica tus archivos de Skills, la instalación de plugins y las conexiones MCP paso a paso. Los objetivos y los encargos recurrentes se encuentran en Objetivos y automatización.
Además de los 58 comandos de consola integrados, tu instalación puede proporcionar comandos dinámicos. Por eso, la lista que muestra /help es la de referencia en cada equipo.
| Forma | Significado | Ejemplo |
|---|---|---|
| /<nombre-del-skill> [Tarea] | Inicia una instrucción que se ofrece con este nombre en la selección de barra inclinada, por ejemplo un Skill integrado. Tus propios Skills aparecen normalmente con el espacio de nombres skill:. | /screenshot-lesen comprueba esta imagen |
| /skill:<nombre> [Tarea] | Inicia un Skill personalizado a través de su espacio de nombres completo. | /skill:mi-tester src |
| /<plugin>:<comando> [Argumentos] | Ejecuta un comando slash registrado por un plugin activo. | /mi-plugin:status |
Nombres desconocidos
Un nombre de comando slash desconocido se trata como un mensaje normal dirigido al agente. Por eso, comprueba la ortografía con /help si esperabas un comando integrado.
Comandos en el terminal del sistema operativo
Estos comandos pertenecen a PowerShell, al símbolo del sistema o a tu otro terminal. Para los subcomandos usa blun: un nombre solo detrás de king puede interpretarse como nombre de perfil. <…> designa un valor obligatorio, […] una indicación opcional. Los valores con espacios se escriben entre comillas; los corchetes no se teclean.
El estado 9.1.620 registra 36 rutas de comandos CLI públicas, incluidos sus grupos de comandos. Los grupos abren una ayuda u ofrecen subcomandos; no son 36 acciones independientes. Todas las opciones adicionales las muestra blun <comando> --help.
Inicio, acceso y diagnóstico
| Sintaxis | Efecto y requisitos |
|---|---|
| blun upgrade | Instala la versión estable actual. blun update es también un alias.A tener en cuenta: Una actualización modifica la instalación; las sesiones ya cargadas usan su código anterior hasta el reinicio. |
| blun login [--api-key-stdin] | Inicia el acceso. Con --api-key-stdin se adopta una clave API desde la entrada estándar.A tener en cuenta: Sin esta opción, King utiliza la vía normal del navegador o del código de dispositivo. |
| blun doctor | Comprueba los archivos de configuración para detectar ajustes no válidos. A tener en cuenta: Es a la vez el grupo de las dos comprobaciones específicas siguientes. Un resultado erróneo devuelve un estado de error. |
| blun doctor config [<ruta>] [--schema] | Comprueba config.toml; una ruta selecciona otro archivo.A tener en cuenta: --schema devuelve la referencia de campos como JSON Schema, sin leer ningún archivo de configuración. |
| blun doctor tui [<ruta>] [--schema] | Comprueba los ajustes en tui.toml.A tener en cuenta: --schema devuelve en su lugar la referencia de campos. El comando no recarga la interfaz. |
| blun acp [--login] | Proporciona la conexión ACP para un cliente compatible a través de la entrada y salida estándar. A tener en cuenta: --login solo realiza el acceso mediante código de dispositivo y finaliza la llamada después. |
| blun export [<id-de-sesión>] [-o <ruta>] [--no-include-global-log] | Exporta una sesión como ZIP. Sin identificador se elige la sesión más reciente; -y omite la confirmación para una sesión anterior.A tener en cuenta: Por defecto también se incluye el registro de diagnóstico global activo, no los archivos rotativos .1. Comprueba el ZIP antes de transmitirlo. --no-include-global-log deja fuera este registro. |
| blun vis [<id-de-sesión>] [--no-open] [--host <host>] [--port <número>] | Abre la vista de diagnóstico local de una sesión. A tener en cuenta: Por defecto utiliza una dirección local y un puerto libre. --no-open suprime la apertura del navegador. |
Memoria personal y Mistakes
| Sintaxis | Efecto y requisitos |
|---|---|
| blun memory --help | Muestra los subcomandos de la memoria personal de la cuenta. A tener en cuenta: Este grupo es independiente de la memoria local de herramientas y de las herramientas MCP. |
| blun memory remember <texto...> | Guarda una memoria personal expresamente deseada. A tener en cuenta: Requiere el consentimiento guardado de la cuenta conectada y un servicio de Memory personal accesible. |
| blun mistakes --help | Muestra los comandos para transferir y gestionar datos de errores. A tener en cuenta: Para la transferencia deben estar configurados la dirección de destino y la autenticación. Estos comandos no sustituyen ningún consentimiento. |
| blun mistakes upload <ruta> --source <identificador> | Adopta datos de errores con un identificador de origen en la cola de salida local e intenta la transferencia. A tener en cuenta: --source es obligatorio. Los datos no transferidos con éxito pueden permanecer en la cola de salida. |
| blun mistakes retry | Reintenta las transferencias pendientes desde la cola de salida local. A tener en cuenta: Requiere el mismo servicio configurado que la subida. La llamada no es una prueba de entrega correcta. |
| blun mistakes sync --config <ruta> | Sincroniza las fuentes inscritas en una configuración JSON. A tener en cuenta: --config es obligatorio; el archivo define las fuentes. La dirección de destino y la cola de salida pueden configurarse en consecuencia. |
| blun mistakes watch --config <ruta> [--interval <segundos>] | Repite la sincronización en primer plano; el intervalo estándar es de 300 segundos. A tener en cuenta: Se ejecuta hasta la interrupción, por ejemplo con Ctrl+C. No se instala ningún servicio del sistema operativo. |
| blun mistakes status [--no-fail-on-red] | Consulta el contenido, la actualidad y el estado de supervisión en el servicio configurado. A tener en cuenta: Un resultado rojo devuelve por defecto el código de salida 2. --no-fail-on-red suprime este estado de error. |
| blun mistakes remove <id-de-evento> --reason <texto> | Marca un evento de error como eliminado con una justificación. A tener en cuenta: La justificación es obligatoria. Los datos brutos no se borran; el cambio se guarda como marcador adicional. |
| blun mistakes restore <id-de-evento> --reason <texto> | Marca un evento anteriormente eliminado como restaurado con una justificación. A tener en cuenta: Requiere el servicio configurado. También la restauración añade un marcador en lugar de reescribir los datos originales. |
Servidor local e interfaz web
| Sintaxis | Efecto y requisitos |
|---|---|
| blun server --help | Muestra los comandos registrados del servidor King local. A tener en cuenta: La presencia del grupo solo no inicia ningún servidor. |
| blun server run [--foreground] [--open] | Inicia el servidor local en segundo plano. --foreground lo vincula al terminal; --open abre la interfaz web.A tener en cuenta: La dirección estándar solo es accesible localmente. Otra vinculación se elige expresamente con las opciones del servidor. |
| blun server kill | Detiene primero el servidor local a través de su API; si es necesario, el proceso se termina después mediante su PID. A tener en cuenta: Los clientes conectados pierden entonces su conexión. |
| blun server ps [--json] | Lista las conexiones al servidor local; si se desea, como JSON. A tener en cuenta: Muestra las conexiones del servidor y no es una lista general de procesos del sistema operativo. |
| blun server rotate-token | Genera y guarda un nuevo token de acceso para el servidor local. A tener en cuenta: El token anterior queda inmediatamente inválido. Los clientes deben conectarse si es necesario con el token nuevo. |
| blun web | Pone a disposición la interfaz web local y la abre en el navegador. A tener en cuenta: La llamada de terminal es distinta del comando de barra /web: este transfiere la sesión actual a la vista web y finaliza la vista de terminal. |
Briefing, pruebas y traspaso
| Sintaxis | Efecto y requisitos |
|---|---|
| blun brief --objective <texto> --outcome <texto> --rollback <texto> | Crea un briefing de proyecto versionado con objetivo, resultado y vía de retorno. --step, --accept, --constraint y --decision complementan opcionalmente la misión; son repetibles.A tener en cuenta: Las tres opciones mostradas son obligatorias. --workflow establece el identificador común; sin indicación se genera. El archivo JSON se encuentra en BLUN_HOME/workflow y no sobrescribe ninguna salida existente. |
| blun proof [--check <comando>] [--artifact <ruta>] [--screenshot <ruta>] | Ejecuta los comandos de comprobación transmitidos expresamente y registra las sumas de comprobación de los archivos de prueba indicados. Las tres opciones son repetibles; las rutas de archivo se refieren al espacio de trabajo. A tener en cuenta: Un comando de comprobación puede realizar cambios por sí mismo. La salida JSON se encuentra en el directorio de pruebas privado; un archivo de salida existente no se sobrescribe. La suma de comprobación prueba la integridad del contenido, no la autoría ni una autorización general. |
| blun handoff <id-de-sesión> --workflow <identificador> | Crea un traspaso portátil para continuar la misma sesión en CLI, escritorio o web. A tener en cuenta: Opcionalmente, --brief, --brief-hash, --proof y --proof-attestation integran referencias y sumas de comprobación. Un archivo de traspaso no crea ninguna sesión y no prueba una interfaz de destino conectada con éxito. |
| blun replay <documentos...> | Reconstruye una cronología legible a partir de documentos de workflow depurados. A tener en cuenta: Utiliza los archivos de briefing, traspaso y guard transmitidos. No se vuelven a ejecutar acciones de herramientas originales. |
| blun guard <archivo-de-prueba> --workflow <identificador> | Comprueba la integridad de la prueba y la actualidad de los archivos asociados. --workspace define el espacio de trabajo; --artifact identificador=ruta asocia pruebas y es repetible.A tener en cuenta: Las pruebas faltantes o no válidas provocan un error. Esta comprobación de workflow es distinta de la verificación lingüística configurada para las respuestas. |
| blun demo --brief <ruta> --guard <ruta> --replay <ruta> | Crea una representación HTML depurada y autónoma del workflow documentado. --handoff y --title son opcionales.A tener en cuenta: Los tres archivos mostrados son obligatorios. El resultado es una demo de workflow estática; la vista previa CLI animada en la entrada de los docs es una representación distinta. |
Espacios de trabajo Git aislados
| Sintaxis | Efecto y requisitos |
|---|---|
| blun workspace --help | Muestra la gestión de los espacios de trabajo Git aislados. A tener en cuenta: Requiere un espacio de trabajo Git adecuado; el aislamiento afecta a los archivos y las ramas, no a las cuentas ni a las sesiones. |
| blun workspace create <nombre> | Crea un worktree Git aislado desde el commit actual. A tener en cuenta: Los cambios no confirmados no se copian automáticamente. El checkout original no se restablece por ello. |
| blun workspace list | Lista los espacios de trabajo aislados gestionados por King. A tener en cuenta: No gestiona directorios arbitrarios o ajenos. |
| blun workspace preview <nombre> | Muestra el estado depurado del espacio de trabajo aislado. A tener en cuenta: La vista previa no contiene el contenido completo de los diffs. |
| blun workspace reset <nombre> --yes | Restablece el espacio de trabajo aislado a su commit de partida. A tener en cuenta: --yes es necesario para la ejecución. Los cambios en este espacio de trabajo se descartan. |
| blun workspace remove <nombre> --yes | Elimina el worktree aislado y su rama gestionada. A tener en cuenta: --yes es necesario para la ejecución. Guarda antes el trabajo necesario. |
Para proof y los comandos de workflow, -o o respectivamente --output elige el archivo de salida. Los archivos de workflow comparten un identificador; briefing, prueba, comprobación de integridad y traspaso siguen siendo pasos distintos.
Ayudantes adicionales en el lanzador
blun tools list muestra las herramientas ofrecidas por el lanzador. Con blun tools enable <nombre...> configuras expresamente las entradas elegidas. Usa los nombres de la lista; un acceso o una configuración necesarios siguen siendo obligatorios. Estos dos ayudantes del lanzador no cuentan entre las 36 rutas CLI registradas.
Opciones para el inicio de la consola
Estas opciones se colocan detrás de blun o king al iniciar la consola. La guía CLI contiene ejemplos para una misión única sin interfaz interactiva.
| Opción | Uso |
|---|---|
| --help, -h --version, -V | Muestra la ayuda o la versión instalada. |
| --session [<id>], -S --continue, -c | Abre la selección de sesión o reanuda una sesión determinada; --continue reanuda la sesión anterior de esta carpeta de trabajo. |
| --message <texto> | Transmite un primer mensaje tras el inicio interactivo. No combinar con --prompt; el texto no se ejecuta como comando de barra o de shell. |
| --history-limit <número> | Carga primero de 1 a 2000 entradas de historial, por defecto 200. Esto limita la visualización en el inicio interactivo y no borra ningún mensaje anterior; no combinar con --prompt. |
| --prompt <texto>, -p --output-format <formato> | Ejecuta una misión única sin interfaz interactiva. Formatos: text, json, stream-json; sin indicación, text. |
| --fork-session <id> | Divide una sesión existente para la misión de prompt único. |
| --plan | Inicia en modo de plan. |
| --permission-mode <modo> --auto --yolo, -y | Elige manual, auto o yolo. --auto activa el modo de permisos automático; --yolo confirma automáticamente las acciones habituales. Estas opciones no sustituyen ningún límite expreso del usuario. |
| --effort <nivel> | Elige low, medium, high, xhigh o max, en la medida en que el modelo activo lo admita. El swarm se controla por separado. |
| --settings <ruta> | Utiliza otro config.toml para esta sesión. |
| --allowed-tools <nombres> | Limita la selección de herramientas a los nombres separados por comas, por ejemplo Read,Grep,Glob. No hace disponibles herramientas inexistentes y no anula las comprobaciones de permisos. |
| --add-dir <carpeta> | Añade una carpeta de espacio de trabajo; posible varias veces. |
| --skills-dir <carpeta> | Carga skills desde carpetas indicadas expresamente en lugar de las carpetas de usuario y de proyecto encontradas automáticamente; posible varias veces. |
| king --profile <nombre> | Opción del lanzador exclusiva para king: elige un perfil King distinto. blun --profile no es una opción correspondiente. |
Herramientas que usa el agente
Describe lo que debe lograrse; King elige para ello las herramientas disponibles. Los nombres siguientes son identificadores de herramientas para el agente, no comandos adicionales de terminal o de barra.
El estado de la fuente contiene 44 registros posibles de herramientas integradas. Cuáles ofrece realmente tu sesión depende del modelo, los servicios, la ejecución, los skills y los permisos. Los plugins y MCP pueden añadir más herramientas. La búsqueda de herramientas puede cargar descripciones según sea necesario; no es una entrada adicional en esta lista de 44.
Archivos, búsqueda y shell
| Herramienta | Tarea | Disponibilidad y límites |
|---|---|---|
| Read | Lee un archivo de texto o un intervalo de líneas. Los archivos grandes se leen página por página. | Se aplican el espacio de trabajo, las reglas de acceso y los límites de lectura. |
| ReadBatch | Lee conjuntamente de dos a doce archivos UTF-8 independientes, ya conocidos, o intervalos. Los resultados permanecen ordenados; los errores individuales se notifican por separado. | Las mismas reglas y límites que en Read; no es un sustituto de la búsqueda de rutas desconocidas. |
| Write | Escribe un archivo según el protocolo de escritura previsto. | Se aplican los permisos de escritura y las confirmaciones; los contenidos grandes pueden requerir varias continuaciones. |
| Edit | Modifica pasajes concretos de un archivo existente. | Requiere pasajes unívocos y permiso de escritura. |
| Grep | Busca patrones de texto en el espacio de trabajo. | Los resultados pueden entregarse limitados o por páginas. |
| Glob | Encuentra rutas de archivo mediante un patrón. | Busca nombres y rutas; no lee automáticamente el contenido del archivo. |
| Bash | Ejecuta comandos de shell y proporciona la salida junto con el código de salida. | Se aplican el modo de permisos y los límites de tiempo. La ejecución en segundo plano debe estar permitida en el entorno. |
| CodebaseSearch | Busca pasajes coincidentes en la base de código. | Requiere una carpeta de proyecto adecuada y el índice de búsqueda correspondiente. |
| LSP | Consulta al servidor de lenguaje configurado sobre el código y los diagnósticos. | Solo con un servicio LSP presente y un servidor de lenguaje adecuado. |
| ReadMediaFile | Lee un archivo de imagen o vídeo local para un modelo adecuado. | Solo con soporte de entrada de imagen o vídeo; el acceso a archivos y, en su caso, la carga deben estar disponibles. |
Planificación, contexto y colaboración
| Herramienta | Tarea | Disponibilidad y límites |
|---|---|---|
| EnterPlanMode | Cambia al modo de plan. | Las reglas de este modo y las autorizaciones existentes siguen aplicándose. |
| ExitPlanMode | Finaliza el modo de plan mediante la transición prevista hacia la ejecución. | Un plan no sustituye ningún consentimiento requerido para sus acciones. |
| TodoList | Crea o actualiza la lista de tareas. | Documenta el progreso; no ejecuta las tareas por el mero hecho de listarlas. |
| CreateGoal | Crea un objetivo explícitamente encomendado. | Las herramientas de objetivo deben estar activadas; no es un sustituto de una misión del usuario. |
| GetGoal | Lee el estado actual del objetivo y sus límites. | Las herramientas de objetivo deben estar activadas. |
| SetGoalBudget | Define un límite explícitamente nombrado para tokens, turnos o tiempo de ejecución. | Las herramientas de objetivo deben estar activadas. Un límite no es una previsión de costes. |
| UpdateGoal | Actualiza el estado del objetivo en curso. | Se requieren las herramientas de objetivo y un objetivo existente; el estado notificado debe corresponder al resultado efectivo. |
| AskUserQuestion | Plantea una pregunta de seguimiento estructurada con opciones de respuesta disponibles. | Solo si la interfaz ofrece la función de pregunta de seguimiento. |
| CompactConversation | Condensa las partes antiguas de la conversación, tras el paso de herramienta actual, en un resumen de continuación. | Solo en el umbral de contexto seguro. No elude ninguna condensación en pausa ni elimina ningún historial no resumido. |
| ProgrammaticTool | Coordina varias llamadas de herramientas BLUN explícitamente nombradas con JavaScript limitado. | El intérprete no tiene acceso propio a archivos, red ni procesos. Cada llamada de herramienta sigue pasando por las comprobaciones de permisos habituales. |
| Skill | Carga una instrucción de trabajo disponible para una misión adecuada. | Solo si hay skills invocables presentes. La instrucción no confiere derechos adicionales. |
| Agent | Delega una subtarea concreta en un subagente. | Requiere la ejecución de subagentes; el funcionamiento en segundo plano depende de la configuración. Las llamadas de modelo adicionales pueden consumir tokens. |
| AgentSwarm | Coordina varios agentes para una misión común. | Requiere la ejecución de subagentes y una configuración adecuada. El swarm es una forma de trabajo propia, no un nivel de esfuerzo. |
| MistakeRecord | Registra un candidato de aprendizaje a partir de un error y su corrección. | Un candidato aún no es un conocimiento adoptado en general ni la prueba de una transmisión privada exitosa. |
Tareas en segundo plano y misiones recurrentes
| Herramienta | Tarea | Disponibilidad y límites |
|---|---|---|
| TaskList | Enumera las tareas en segundo plano conocidas con su estado. | Requiere la gestión de tareas del entorno. |
| TaskOutput | Lee la salida de una tarea en segundo plano determinada. | Requiere un identificador de tarea conocido; las salidas largas pueden estar limitadas. |
| TaskStop | Detiene una tarea en segundo plano determinada. | Requiere la gestión de tareas; la detención puede provocar aún pasos de limpieza. |
| TaskUpdate | Da instrucciones adicionales al mismo agente de fondo en ejecución en el siguiente paso seguro del modelo. | Requiere el identificador exacto. Se rechazan las tareas de shell y las tareas finalizadas, desconocidas o que ya no aceptan. |
| TaskResume | Reanuda un agente de fondo local demostrablemente perdido con su contexto conservado bajo un nuevo identificador de tarea vinculado. | Requiere un origen guardado y la ejecución de subagentes. No reinicia ningún proceso de shell y no se ejecuta automáticamente al iniciar el programa. |
| CronCreate | Crea una misión recurrente en la sesión. | Solo con un servicio cron presente; el entorno que lo ejecuta debe permanecer disponible. |
| CronList | Enumera las misiones recurrentes de esta sesión. | Solo con un servicio cron presente. |
| CronRunList | Enumera las pruebas de ejecución recientes de una misión recurrente. | Solo con un servicio cron presente. La lista limitada no contiene prompts brutos, argumentos de herramientas ni resultados. |
| CronRunOutput | Lee una prueba de ejecución y, si está completamente asignada, su última respuesta de texto guardada. | Solo dentro de la misma sesión. Los resultados incompletos no se vuelven a ejecutar; las respuestas largas pueden estar truncadas. |
| CronDelete | Elimina una misión recurrente. | Solo con un servicio cron presente; las pruebas de ejecución ya guardadas son independientes de ello. |
Web y medios
| Herramienta | Tarea | Disponibilidad y límites |
|---|---|---|
| WebSearch | Busca información pública en la web. | Solo con un servicio de búsqueda web configurado. |
| FetchURL | Recupera una dirección web concreta. | Solo con un servicio de recuperación configurado; se aplican los límites de acceso y de contenido. |
| GenerateImage | Crea una imagen con BLUN IMAGINE a partir de una descripción. | Requiere el servicio de medios; inicia una misión asíncrona de pago. |
| GenerateVideo | Crea un vídeo nuevo a partir de una descripción. | Requiere el servicio de medios; inicia una misión asíncrona de pago. |
| GenerateSpeech | Crea datos de audio hablado a partir del texto proporcionado. | Requiere el servicio de medios; inicia una misión asíncrona de pago. |
| UnderstandImage | Describe o examina un archivo PNG o JPEG local mediante el lector de imágenes de BLUN. | Carga el archivo a BLUN e inicia una misión de pago; se requieren el acceso a archivos y el servicio de medios. |
| UnderstandVideo | Examina un vídeo BLUN ya finalizado. | Requiere el identificador devuelto por el servicio de medios. Una ruta de vídeo local cualquiera no basta. |
| DubVideo | Crea una pista de audio para un vídeo BLUN finalizado. | Requiere su identificador de medios y el servicio de medios. |
| LipSyncMedia | Crea un vídeo con movimientos de labios sincronizados a partir de tu propia imagen o vídeo finalizado y de tu propio archivo de audio finalizado. | Requiere los identificadores de medios. La misión de pago puede durar hasta 35 minutos; una indicación porcentual no está disponible por ahora. |
| GetMedia | Comprueba una misión de medios y entrega la imagen, el audio o el vídeo finalizados. | Usa únicamente identificadores de las herramientas de medios de BLUN. Una generación iniciada no es todavía un archivo finalizado. |
Otros agentes, intentos repetidos, servicios externos y misiones de medios pueden causar un consumo adicional. El número de herramientas disponibles no permite afirmar nada sobre el precio, la velocidad o una entrega exitosa. Comprueba los servicios y herramientas realmente disponibles en tu instalación.
Atajos de teclado en la consola
Los siguientes atajos se aplican en el campo de entrada de la consola. Los diálogos abiertos, el autocompletado y la codificación de teclas de tu terminal pueden modificar su efecto. En macOS, Ctrl designa la tecla Control.
| Tecla | Efecto |
|---|---|
| Ctrl+P | Abre la selección de sesión. |
| Ctrl+L | Abre la selección de esfuerzo. Se adopta un nivel admitido por el modelo en un límite de solicitudes libre; el borrador de entrada se conserva. |
| Ctrl+G | Abre el borrador de entrada en el editor externo configurado. Configúralo antes con /editor. |
| Ctrl+O | Despliega o repliega las salidas de herramientas en el historial. |
| Ctrl+T | Despliega o repliega una lista de tareas demasiado larga. Sin tareas ocultas, este atajo especial no se aplica. |
| Ctrl+S | Adopta el borrador y las entradas en espera en el siguiente paso seguro. Durante una ejecución de shell o una condensación, permanecen primero en la cola. Si el borrador y la cola están vacíos, el atajo puede desplegar en su lugar una lista de tareas demasiado larga. |
| Ctrl+B | Desplaza la tarea de primer plano actual al fondo cuando hay una tarea adecuada activa. En reposo o durante una condensación, este cambio no se aplica. |
| Mayús+Tab | Conmuta el modo de plan; no elige ningún otro modo de permisos. |
| Esc | Cierra sugerencias o una selección. Fuera del autocompletado y de la selección de sesión, Esc descarta las entradas en espera e interrumpe el trabajo en curso; el borrador aún no enviado se conserva. |
| Dos veces Esc en reposo | Abre, con dos pulsaciones rápidas de Esc, la selección para deshacer pasos de conversación. |
| Ctrl+C | Interrumpe primero el trabajo de primer plano activo. Sin ese trabajo, vacía el borrador y muestra la indicación para salir; un segundo Ctrl+C inmediatamente después finaliza la consola. |
| Ctrl+D con entrada vacía | Muestra la indicación para salir; un segundo Ctrl+D consecutivo finaliza la consola. |
| Flecha arriba / abajo con entrada vacía | Puede desplazar la vista de pregunta secundaria activa. Durante un trabajo en curso, la flecha arriba puede recuperar la última entrada local aún en espera para editarla; de lo contrario, se aplican las reglas normales del editor. |
| Alt+V en Windows Ctrl+V en otros sistemas | Despliega primero un bloque de inserción plegado en el cursor o intenta insertar una imagen desde el portapapeles. Sin imagen, el procesamiento vuelve a la entrada de texto; el soporte de imágenes y una configuración adecuada siguen siendo necesarios. |
Si las entradas en espera deben conservarse, usa específicamente /abort. /stop las descarta además. Para deshacer pasos de conversación también está disponible /undo.
Comandos por Telegram
La consola de King vinculada debe estar en ejecución. En el chat directo autorizado puedes enviar los siguientes comandos; en los grupos, el mensaje debe ir dirigido expresamente al bot. Una lista local de comandos o plugins no amplía esta autorización.
| Comando | Uso |
|---|---|
| /befehle | Muestra los comandos de Telegram realmente admitidos, incluso mientras la consola está ocupada. |
| /loop [Intervalo] [Prompt] | Crear una tarea recurrente; status, pause, resume y stop la controlan. |
| /goal | Crear un objetivo o gestionarlo con sus subcomandos disponibles. |
| /idea, /chancenradar | Iniciar o gestionar el modo de trabajo correspondiente dentro del alcance definido. |
| /curiosity, /scout | Iniciar una investigación limitada; sin tema, primero se pregunta qué dirección tomar. |
| /reload | Recargar la sesión según las reglas normales de disponibilidad. |
| /memory status|on|off | Comprobar o cambiar el estado de la memoria personal. |
| /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. |
| /usage off|tokens|full|reset | off, tokens y full guardan el modo de visualización para esta sesión. reset elimina este ajuste; inherit, clear y default son equivalentes. |
/loop@SuBot status también se acepta. No todos los comandos pueden ejecutarse durante una respuesta. Los nombres no admitidos, como /login, /new o /god, no se ejecutan como comandos de control remoto. Los comandos de conexión del bot /start, /help y /status en el chat directo son independientes de esto.
Nombres de comandos antiguos
/model, /automodel y /router se conservan por motivos de compatibilidad. Ya no seleccionan un modelo, sino que abren, como /effort, el selector del esfuerzo de razonamiento. Los argumentos que siguen a estos tres nombres antiguos se ignoran.
/update no está contenido en el registro de comandos de barra integrados de la versión de consola 9.1.620. Usa blun update en el terminal del sistema operativo. El comando no pertenece al campo de entrada del chat.