Empezar desde Inicio
Elige ordenador, agente, modelo, modo y carpeta, adjunta archivos y envía un objetivo directamente a una conversación o terminal.
GUÍA DE USUARIO · MANUAL DE REFERENCIA
Todo lo que necesitas para tener tu máquina siempre a mano.
Muqun conecta tu teléfono directamente a tu propio ordenador o servidor. Aprende a instalar y configurar el Gateway, navegar por tus terminales, preparar y dirigir tus agentes de código (Antigravity, Claude Code, Antigravity, Claude Code, Codex, Cursor, DeepSeek Harness, FX, OpenCode, Pi, Qoder CLI Cursor FX Pi Qoder CLI y T3 Code), instalar temas y resolver problemas de conexión.
MUQUN / 4.0.0
Un espacio, desde el primer objetivo hasta el siguiente cambio.
Sesiones nativas para Codex, OpenCode, DeepSeek Harness y T3 Code. Aprueba permisos, sigue tareas y revisa diffs desde tu bolsillo, directo a tu propia máquina.
Ver qué necesita tu atención
Las tarjetas muestran tareas activas, progreso, decisiones y trabajo reciente. Las subtareas siguen conectadas con el trabajo principal.
Hablar y revisar
Mantén Enviar para grabar e insertar la transcripción en el borrador. Revisa antes de enviar; configura un servicio de archivos o de transcripción en tiempo real.
Git en el mismo espacio
Abre Changes y Lazygit juntos. Explora worktrees vinculados si el Gateway lo admite, sin cambiar el checkout del terminal.
Leer antes de descargar
Las actualizaciones compatibles muestran notas, progreso y reinicio tras verificar. Más tarde aplaza el aviso durante este inicio.
Respuestas más allá del texto
Lee diagramas nativos y archivos, y reproduce audio integrado cuando quieras. Se detiene al cerrar la vista previa o empezar el dictado.
Controlar el almacenamiento temporal
Consulta cachés recuperables y configura la limpieza automática en Storage.
Actualiza desde Google Play o App Store. Las herramientas de agentes, tareas y Git dependen de las capacidades del Gateway. Los Gateways antiguos conservan sus opciones compatibles de terminal y OpenCode.
muqun-gateway
Instala el Gateway y empareja tu teléfono.
Muqun se comunica con un único programa en tu propio ordenador: el Gateway. Lo instalas allí, lo inicias y vinculas el teléfono una sola vez. No se requiere cuenta y nada tuyo pasa por nuestros servidores.
PRE-FLIGHT REQUIREMENTScheck before installing
- macOS o Linux en un ordenador propio (Windows no está soportado todavía).
- tmux o Herdr 0.7.5 o superior ya instalado (el Gateway los maneja, no los sustituye).
- Ambos dispositivos en la misma red privada. Tailscale es la opción recomendada (usa Tailscale Serve, nunca Funnel).
- Sin cuentas, sin suscripciones y sin servidores intermediarios nuestros.
Ejecuta el instalador en tu ordenador
Coloca un binario único en ~/.local/bin/muqun-gateway, lo configura y abre la pantalla de emparejamiento en la primera ejecución. Compatible con macOS y Linux (Windows aún no está soportado).install curl -fsSL https://muqun.dev/gateway.sh | shInícialo de una de estas dos formas
Puedes iniciarlo tú mismo o dejar que el sistema lo mantenga activo en segundo plano. Ambas opciones dejan el Gateway en funcionamiento; difieren en cómo responden al reiniciar el equipo.Elige solo una: si el servicio está instalado, detenerlo con stop será revertido de inmediato por el supervisor.Abre el administrador de emparejamiento
Sin importar el modo de inicio, este es el siguiente paso. El administrador es un panel a pantalla completa en el terminal que muestra el código QR, los procesos y los dispositivos con token activo.pair muqun-gateway manageEscanea e introduce el código
Escanea el código QR desde Muqun. El ordenador mostrará un código corto en formato XXXX-XXXX; introducirlo en la app completa el emparejamiento. Escanear no basta por sí solo: el código confirma tu identidad.
MANUAL ADDRESS PAIRING
¿No puedes escanear? Escribe la dirección del Gateway manualmente en la app (el administrador muestra la dirección pública) e introduce el mismo código corto.
CODE VALIDITY & RETRIES
El código es válido durante 5 minutos y se anula tras 8 intentos fallidos. Pulsa p en el administrador para generar un nuevo QR y código.
RED PRIVADA RECOMENDADA
Usa Tailscale en ambos dispositivos.
Recomendamos encarecidamente conectar el teléfono y el ordenador del Gateway a la misma tailnet de Tailscale. Evita abrir puertos en el router y protege el Gateway de la red pública. Tailscale Serve puede añadir una dirección HTTPS privada (no utilices Tailscale Funnel con Muqun).
workspace · group.panel
Tu terminal de verdad.
Es tu terminal real y no una simple captura o transcripción. El Gateway maneja tmux o Herdr en tu equipo y la aplicación dibuja su contenido en pantalla con total fidelidad.
WORKSPACE ARCHITECTURE
Espacios, grupos y terminales
Tres niveles: espacio · grupo.panel. Un espacio es tu directorio de trabajo, un grupo reúne terminales y un terminal es una shell. Muqun muestra un terminal a la vez a pantalla completa para garantizar una lectura óptima.
Moverte entre vistas
Desliza la barra superior de título para cambiar de espacio. Las etiquetas sobre el campo de texto cambian de terminal dentro del mismo grupo.
Procesos y panel lateral
El panel lateral enumera todos los espacios, grupos y terminales de la máquina. Una pulsación prolongada abre opciones para cerrar de forma segura.
CONTROLS, EDITORS & DEVELOPER TOOLS
Barra de teclas del terminal
La barra sobre la entrada de texto incluye teclas esenciales que faltan en el teclado móvil: Esc, Tab, ⌃C, flechas, y teclas contextuales que cambian según el programa en ejecución (⇧TAB y ⌃O en Claude Code, :w y gg en nvim). Se puede desactivar en Ajustes → Terminal.
Editor de comandos (Composer)
Fuente monoespaciada, soporte multilínea y la tecla Intro añade saltos de línea: el envío se realiza mediante un botón para evitar pulsar comandos no deseados.
Historial de salida
Tira hacia abajo desde la parte superior del terminal para cargar el historial anterior. Si dejas el extremo en vivo, un botón flotante te devuelve al final al instante.
Cambios (Changes)
La vista git del directorio del panel, la misma hoja que usa una sesión de agente; consulta La hoja de Cambios más abajo. El botón lleva el número de archivos cambiados y solo aparece cuando el panel está dentro de un repositorio git y el Gateway puede servir diffs.
Archivos (Files)
Accede a los archivos creados durante tus sesiones (imágenes, código y documentos), legibles sin salir de la app.
Abrir en el navegador
Introduce el puerto de tu servidor de desarrollo y Muqun lo abrirá mediante la conexión segura existente sin exponerlo a Internet.
Acciones rápidas
Comandos guardados, prompts habituales y atajos de teclado, ordenados por frecuencia de uso. Personalizables en cualquier momento.
LA HOJA DE CAMBIOS
Los paneles de terminal y las sesiones de agente comparten una misma hoja de Cambios. Ejecuta git en el host, en el directorio del panel o de la sesión.
El árbol
Los archivos cambiados como árbol de carpetas, con el número de archivos y los totales de líneas. Los nombres largos se acortan por el medio para que la extensión siga visible, y las carpetas profundas dejan de sangrarse a partir del tercer nivel.
Alcance
El menú superior alterna entre los cambios sin confirmar y la comparación con la base de la rama: el merge-base con origin/HEAD o, si no, main o master.
Los parches se cargan al abrir un archivo
La lista no lleva diffs, así que incluso un cambio grande se abre rápido. Mostrar más contexto amplía el parche que estás leyendo.
Descartar
En el menú … de un archivo, tras una confirmación: un archivo con seguimiento se restaura y uno sin seguimiento se borra. El Gateway se niega cuando el repositorio es tu directorio personal y para cualquier ruta que salga del repositorio, incluido un enlace simbólico que apunte fuera.
Con un Gateway anterior
Comparar con la base y Descartar en un terminal necesitan un Gateway que ofrezca pane_vcs_files. Sin él, la hoja del terminal muestra el mismo árbol de cambios sin confirmar y nada más.
EL TECLADO DE LA TABLETA Y LAS TECLAS EXTENDIDAS
En una tableta, el teclado en pantalla es un teclado entero: una franja de teclas de función que puedes ocultar, una fila de números, ctrl, alt y shift fijables (doble toque para bloquear) e Inicio, Fin, RePág y AvPág sobre las flechas. Las combinaciones fuera del juego clásico — Ctrl+Intro, Mayús+Intro, Ctrl+flechas, Alt+letra, teclas F — solo se envían cuando el Gateway dice que puede entregarlas.
Teclas que no puede enviar
Una tecla que el Gateway no puede entregar aparece atenuada y lo dice al pulsarla. Mientras mantienes un modificador, se oscurecen las teclas que esa combinación no alcanza, y una combinación rechazada también gasta un modificador de un solo uso.
Herdr
Entrega todas las combinaciones. Nada que configurar.
tmux
tmux 3.2 o posterior con extended-keys on, y el programa del panel debe pedir teclas extendidas. Ctrl+Intro y Mayús+Intro necesitan además extended-keys-format csi-u.
Codex y Claude Code
Codex dentro de tmux no recibe Mayús+Intro: usa ⌃J para una línea nueva. Claude Code toma \ seguido de Intro para una línea nueva.
tmux set -s extended-keys ontmux set -s extended-keys-format csi-uEsas dos órdenes surten efecto al momento y duran hasta que termina el servidor de tmux. Para conservarlas, pon las mismas dos líneas, sin el tmux inicial, en ~/.tmux.conf.
set -s extended-keys onset -s extended-keys-format csi-u●
Muqun actúa siempre como un observador seguro: abrir una sesión no altera tus ventanas y cerrar la app no interrumpe ninguna tarea.
muqun-gateway agent
Agentes.
Un terminal es un shell en el que escribes. Una sesión de agente es una conversación con un agente de código que se ejecuta en tu ordenador — Antigravity, Claude Code, Codex, Cursor, DeepSeek Harness, FX, OpenCode, Pi, Qoder CLI o T3 Code — y que la app dibuja como mensajes, tarjetas de herramienta y preguntas en lugar de una pantalla de texto. Los dos pasan por el mismo Gateway y la misma vinculación; se diferencian en con qué habla el Gateway por ti.
Un terminal
tmux o Herdr en el host. La app muestra lo que muestra el panel, y las teclas que envías son las que recibe el programa, así que funciona cualquier programa, incluidos los agentes CLI que viven directamente en un terminal, como Claude Code.
Una sesión de agente
Un agente con el que el Gateway habla por su propia API. Cada sesión pertenece a un agente y siempre vuelve a él. El banco de trabajo — modos, modelos, comandos de barra, skills, adjuntos, deshacer, compactación, ejecuciones en segundo plano — solo muestra lo que ese agente admite.
LOS AGENTES QUE ADMITE 4.0
codex
Codex
Codex está activado por defecto. El Gateway detecta codex en tu PATH, se vincula a su daemon compartido (iniciándolo si es necesario) y hereda tus credenciales locales de ~/.codex para ofrecer sesiones nativas y herramientas.
opencode
OpenCode
OpenCode no necesita configuración. El Gateway adopta un servicio de OpenCode que ya esté en marcha o inicia uno él mismo; necesita OpenCode 2. Tiene todo el banco de trabajo.
deepseek
DeepSeek Harness
DeepSeek Harness está apagado hasta que lo actives. Inicia el Harness en el host y luego indícaselo al Gateway. Sus modos son sus propios preajustes, elegidos al crear una sesión; los adjuntos le llegan como archivos del host.
t3
T3 Code
T3 Code está apagado hasta que el Gateway tenga una credencial para él. El Gateway se vincula con T3 una vez y guarda esa credencial. Admite adjuntos, aprobaciones y deshacer; un deshacer de T3 revierte turnos enteros, así que la app pide confirmación antes.
PREPARARLOS DESDE LA LÍNEA DE COMANDOS
En el ordenador donde corre el Gateway. muqun-gateway agent comprueba cada agente desde tu shell y muestra su estado, versión y dirección, con el siguiente paso para los que no están listos. Termina con un código distinto de cero mientras un agente activado no se pueda usar, así que un script también puede comprobarlo.
El estado de cada agente, con el siguiente paso.
muqun-gateway agentVincula T3 Code. En la misma máquina emite una credencial con t3 auth session issue; añade --base-dir si T3 guarda sus datos en otro sitio. Para un T3 en otro host, ejecuta allí t3 pair y pasa el código con --token CODE.
muqun-gateway agent setup t3Encuentra un DeepSeek Harness en marcha y lo activa. Busca en los puertos 3080 y 19387; pasa --endpoint URL si el Harness está en otro lugar.
muqun-gateway agent setup deepseekNo cambia nada. Muestra qué binario de OpenCode usaría el Gateway y su versión; necesita la 2.x.
muqun-gateway agent setup opencodesetup escribe config.json e indica si el Gateway en marcha debe reiniciarse para ver el cambio. Un Gateway instalado como servicio se reinicia por ti tras una confirmación (--yes la omite); si no, reinícialo tú.
A mano, en config.json
CONFIG.JSONLos mismos ajustes, por si prefieres escribirlos tú. Añade los bloques que necesites y reinicia el Gateway. Un código de t3 pair va en pairing_token; en el siguiente arranque el Gateway lo canjea una vez y ya no lo necesita. opencode.binary y codex.binary solo sirven para fijar un binario concreto.
{ "opencode": { "binary": "/usr/local/bin/opencode" }, "codex": { "enabled": true }, "deepseek": { "enabled": true, "endpoint": "http://127.0.0.1:3080" }, "t3": { "enabled": true, "url": "http://127.0.0.1:3773", "pairing_token": "CODE-FROM-T3-PAIR" }}●
La credencial de T3 se guarda en t3-credential.json, en el directorio de estado del Gateway (~/.local/share/muqun-gateway/ en Linux), y solo tú puedes leerla. Si T3 la revoca o caduca, vuelve a ejecutar agent setup t3.
EN EL TELÉFONO
Un mosaico por agente
Inicio muestra un mosaico por cada agente que informa el Gateway, con el último que usaste primero. A partir de tres, el resto queda en Más agentes. Si hay más de uno listo, Nueva sesión pregunta cuál.
Las preguntas llegan como notificaciones
Cuando una sesión — también la de un subagente — te pide rellenar un formulario, cada teléfono vinculado recibe una notificación de que el agente necesita tu respuesta. Los permisos se notifican como antes.
Requiere configuración
El Gateway ve el agente pero no tiene credencial para él. El mosaico abre una guía con el comando exacto que ejecutar en el host; para T3 Code, t3 pair.
Requiere actualización
El agente habla un protocolo más nuevo del que conoce este Gateway. Actualiza el Gateway en ese ordenador volviendo a ejecutar el comando de instalación.
No instalado, Sin conexión
El agente no está en el host o no se está ejecutando. El mosaico dice cuál de las dos y abre una guía de inicio escrita para ese agente.
Gateways anteriores
Un Gateway anterior a 0.13 no ofrece multi_agent, así que la app se queda en modo de un solo agente con OpenCode y avisa cuando una función necesita un Gateway más reciente.
opencode serve --service
El agente OpenCode.
Una interfaz creada específicamente para OpenCode en vez de un simple chatbot en consola: cambia de sesión con rapidez, visualiza diffs reales en tarjetas y responde a preguntas con un solo toque.
EJECUCIÓN LOCAL · SIN CUENTA
Tu ordenador habla directamente con tus proveedores de IA.
No requiere iniciar sesión. Muqun no maneja cuentas ni solicita claves API. Quien se comunica con los modelos es OpenCode en tu propio ordenador. El Gateway no almacena ni reenvía tus credenciales.
REQUISITOS
- OpenCode 2.x instalado en el mismo ordenador que el Gateway.
- Al menos un proveedor configurado en OpenCode (con opción para filtrar solo modelos gratuitos).
- El servicio OpenCode en ejecución (el Gateway lo inicia o conecta automáticamente).
- Un Gateway reciente que admita la interfaz del agente.
AGENT CAPABILITIES & WORKFLOW
Sesiones y subagentes
Cada sesión tiene su propio contexto. Si una tarea delega en subagentes, estos se muestran indentados debajo de la sesión principal para una lectura cómoda.
Proyectos
Cambia el directorio de trabajo del agente al instante. Al elegir un proyecto se reanuda automáticamente su última sesión activa.
Modelos y agentes
Consulta los modelos disponibles según tus proveedores configurados, con tamaño de ventana de contexto e indicador Free. Alterna entre perfiles Build, Plan, Explore o agentes propios.
Comandos / y habilidades
Escribe / en la entrada de texto. Comandos como /new, /models o /undo son resueltos directamente por la app; el resto se ejecutan en el ordenador anfitrión.
Adjuntos y menciones con @
Envía fotos o archivos. Las imágenes se recodifican para eliminar metadatos EXIF. Escribe @ para vincular rápidamente archivos del proyecto.
Permisos y preguntas
Cuando el agente desea ejecutar comandos o modificar ficheros, una tarjeta te permite elegir entre Permitir, Permitir siempre o Denegar (también desde las notificaciones).
Tareas en segundo plano y cola
Envía herramientas lentas a segundo plano y supervisa el progreso desde la bandeja superior. Tus mensajes nuevos pueden intervenir de inmediato o esperar su turno en la cola.
Contexto y compactación
Supervisa la ocupación del contexto del modelo, los tokens consumidos y el coste estimado. Las compactaciones automáticas se marcan con claridad en la línea de tiempo.
Deshacer (Undo)
/undo revierte el proyecto al estado previo a tu último mensaje; /redo lo restaura. Diseñado como comando para prevenir pulsaciones involuntarias.
●
Las llamadas a herramientas aparecen como tarjetas interactivas: las ediciones muestran su diff unificado en línea, igual que en el visor de Cambios.
config.json
Configurar el Gateway.
La mayoría de usuarios no necesitan abrir la configuración. Está disponible para casos concretos: cambiar de puerto, mantener el Gateway tras un reinicio o usar una ruta no estándar para OpenCode.
El archivo de configuración
JSON SCHEMAEs un archivo JSON generado durante la instalación. Modifícalo manualmente solo cuando necesites ajustar las claves indicadas y reinicia el Gateway después. En macOS se ubica en ~/Library/Application Support/muqun-gateway/. Los dispositivos vinculados y registros se guardan en ~/.local/share/muqun-gateway/.
~/.config/muqun-gateway/config.jsonCONFIGURATION KEYS REFERENCE
labelEl nombre que la aplicación muestra para este ordenador.
listenEl socket al que se vincula (host y puerto). Por defecto 0.0.0.0:23847 (o 127.0.0.1 si la dirección publicada es local).
public_urlLa dirección codificada en el QR de emparejamiento. Es preferible modificarla pulsando u en el administrador.
transport_encryptionCifrado de transporte, por defecto required. Se aplica a los dispositivos vinculados en el futuro sin alterar los existentes.
sessionsLos motores de terminal que este Gateway monta (tmux, Herdr o ambos). Se gestiona con muqun-gateway backend.
autostart_backendsCuáles de ellos inician con el Gateway. Vacío por defecto para evitar lanzamientos involuntarios.
rich_agent_pushesDesactivado por defecto. Si se activa, las preguntas del agente se insertan en el cuerpo de la notificación (mostrando texto del terminal en la pantalla de bloqueo).
opencode.autostartActivado por defecto: el Gateway inicia OpenCode si no detecta ninguno en ejecución. Desactívalo con "opencode": { "autostart": false }.
opencode.binaryRuta al binario de OpenCode. Si se omite, se busca en ~/.opencode/bin o en tu PATH.
codexAgente de código Codex. Activado por defecto (enabled: true); el Gateway busca codex en tu PATH y se conecta al daemon compartido. Usa codex.binary para indicar un binario exacto, o desactívalo con enabled: false.
deepseekDeepSeek Harness. Solo se conecta cuando enabled es true o se da un endpoint; token y secret si tu Harness los necesita. El Gateway nunca rastrea puertos para buscarlo.
t3T3 Code. enabled, url (http://127.0.0.1:3773 por defecto) y, o bien pairing_token de t3 pair, o bien un token que ya tengas. runtime_mode fija su política de permisos; full-access por defecto.
PUERTOS Y ENLACES
Por defecto
Un único puerto TCP: 23847.
Cambiarlo
Ejecuta muqun-gateway setup --port N y reinicia.
Dónde escucha
127.0.0.1 si la dirección es loopback, 0.0.0.0 en los demás casos.
En una tailnet
No requiere abrir puertos en el router, por eso lo recomendamos.
DOS FORMAS DE MANTENERLO ACTIVO
DIRECT
Inicio manual directo
Inicio
Cuando ejecutas el comando.
Parada
muqun-gateway stop o al reiniciar el equipo.
Sobrevive al reinicio
No.
Desinstalación
Nada que hacer, solo detener con stop.
muqun-gateway startSERVICE
Como servicio del sistema
Inicio
Al iniciar sesión y tras caídas inesperadas.
Parada
Únicamente con service uninstall.
Sobrevive al reinicio
Sí.
Desinstalación
service uninstall (se conservan emparejamientos).
muqun-gateway service installUnidad de usuario de systemd en Linux, LaunchAgent en macOS. Nunca requiere permisos de root ni sale de tu directorio de usuario.
CÓMO ARRANCA OPENCODE
- Comprueba si ya hay un servicio OpenCode sano en ejecución leyendo la dirección en ~/.local/state/opencode/service.json.
- Si lo encuentra, se conecta directamente a él y tus sesiones abiertas se mantienen intactas.
- En caso contrario, ejecuta opencode serve --service y supervisa el proceso detectando automáticamente cualquier cambio de puerto.
●
¿No tienes OpenCode instalado? El sistema no conecta nada y solo la pantalla del agente mostrará desconexión; el terminal no se ve afectado.
"opencode": { "autostart": false }PANEL DE EMPAREJAMIENTO
Se abre con muqun-gateway manage. Muestra procesos y dispositivos autorizados y admite estas teclas:
p
Mostrar de nuevo el QR para vincular otro dispositivo.
x
Revocar el acceso a un dispositivo seleccionado.
u
Editar la dirección codificada en el QR (a para volver a detectarla).
s / t
Iniciar o detener el Gateway sin salir del administrador.
m / h
Añadir backend tmux o Herdr (f elige el predeterminado, d elimina).
e
Cambiar el modo de cifrado para emparejamientos futuros.
q
Cerrar el administrador (nunca interrumpe tus sesiones de terminal).
Compatibilidad con versiones anteriores
La app consulta directamente al Gateway qué funciones soporta en lugar de adivinar por su versión, ocultando lo no disponible sin dar fallos. Un Gateway más antiguo sigue siendo un terminal perfecto. Solo la colaboración de agentes requiere Herdr 0.9.0 o más reciente.
Actualizaciones
Vuelve a ejecutar el comando de instalación original. Reemplaza el binario respetando tu identidad, claves, configuración y vinculaciones. Si tenías el servicio activo, vuelve a ejecutar service install tras la actualización.
Registros
DIAGNOSTICSEn modo directo y con LaunchAgent en macOS, los registros van a ~/.local/share/muqun-gateway/gateway.log. En Linux con systemd, se consultan con journalctl. Para mayor nivel de detalle define MUQUN_LOG=debug (o RUST_LOG=debug) antes de iniciar.
journalctl --user -u dev.osuki.muqun-gatewaymuqun.dev/themes
Temas.
Cover Courier es el tema integrado por defecto. Instala temas claros y oscuros del catálogo, un archivo o un enlace para cambiar juntos imágenes y colores de app y terminal.
Temas predeterminados e importados
Elige en Ajustes → Apariencia y selecciona Sistema, Claro u Oscuro. Las actualizaciones de temas importados renuevan el tema elegido y conservan tus preferencias de apariencia.
Explorar el catálogo
Explora los temas publicados en muqun.dev. La descarga no comienza hasta que abres un tema, mostrándote el tamaño del paquete de antemano.
Estructura de un tema
Un archivo .muqun-theme es un zip con un theme.json y una carpeta assets de imágenes. .muqun-theme.json es la versión solo de colores sin imágenes.
Alcance de personalización
Un tema define colores de app, terminal y ANSI, imágenes, iconos y opacidad. Escena de Inicio, fondo de página e imágenes del cuadro de Inicio tienen espacios separados para teléfono/tableta y claro/oscuro. Se admiten PNG, JPEG y WebP, pero no fuentes externas, SVG ni archivos de animación.
Límites de tamaño
Manifiesto de hasta 256 KiB, hasta 32 imágenes de máximo 8 MiB cada una y 25 MiB para el archivo comprimido final.
Instalar desde archivo
Abre un .muqun-theme desde Archivos, AirDrop o compartir, o usa «Importar archivo» en la pantalla de temas de la app.
Instalar desde enlace
Introduce una URL pública o un repositorio de GitHub. Se verifica la procedencia de las imágenes antes de descargar nada.
Instalar desde el terminal
Toca en una ruta .muqun-theme que aparezca en la salida de consola para ver una tarjeta de previsualización al instante.
Vista previa antes de aplicar
El tema se aplica temporalmente a toda la app para que puedas inspeccionarlo con total libertad antes de pulsar «Aplicar tema».
Opacidad del fondo
Ajusta de forma independiente la opacidad del fondo de la app y del terminal para lograr transparencias agradables.
Crear tu propio tema
Los temas se escriben en archivos. Puedes pedirle a tu agente de IA mediante la habilidad integrada que cree la apariencia que deseas.
Publicar en el catálogo
El catálogo es un repositorio público de GitHub. Envía un Pull Request con tu carpeta para aparecer en muqun.dev en pocos minutos.
Eliminar temas
Desliza sobre un tema en la lista para desinstalarlo. En Ajustes → Almacenamiento puedes limpiar los temas en desuso.
when it does not connect
Resolución de problemas.
La inmensa mayoría de incidencias se reducen a cuatro causas: el Gateway no está corriendo, la dirección no es accesible, se perdió el emparejamiento o OpenCode no está activo.
COMPROBACIONES RÁPIDAS
Emparejar ordenador
Instala el Gateway (compatible con tmux o Herdr), abre el panel de control, escanea el QR con Muqun e introduce el código que aparece en pantalla.
Corregir conexión
Verifica que tmux o Herdr 0.7.5+ y el Gateway están en ejecución y que ambos dispositivos pueden comunicarse en la misma red privada.
Eliminar dispositivo
Borra el servidor en la pantalla de inicio de Muqun para retirar el acceso. También puedes revocarlo desde el administrador del Gateway.
Restablecer notificaciones
Activa los permisos de notificación en los ajustes del sistema y en Muqun. Vuelve a abrir el servidor para actualizar el token en el Gateway.
DIAGNOSTIC SOLUTIONS
No se puede emparejar
El error «Could not reach the gateway» significa que el teléfono no llega a la IP indicada en el QR. Comprueba muqun-gateway status y asegúrate de compartir la misma red Wi-Fi o tailnet de Tailscale. Si el Gateway está vinculado a 127.0.0.1 será inaccesible desde el exterior; cámbialo con u en el administrador.
Código rechazado o caducado
El código de 8 caracteres caduca a los 5 minutos o tras 8 intentos incorrectos. Pulsa p en el administrador para generar un nuevo QR y código. Se omiten caracteres confusos como 0, 1, I, L y O.
Significado del punto de estado
Un punto relleno indica respuesta comprobada (verde para ONLINE, gris para OFFLINE). Un círculo vacío con NOT CONNECTED indica que aún no se ha comprobado la conexión; pulsa en el servidor para conectar.
Pide volver a emparejar
El token del dispositivo se ha eliminado en el Gateway o su estado se ha reiniciado. Vuelve a escanear el QR; los demás ajustes de la app se mantendrán.
No se encuentra OpenCode
Si la pantalla del agente muestra OpenCode service offline, ejecuta opencode serve --service en el ordenador y pulsa Reintentar. Si ya está corriendo, define la ruta completa en config.json bajo opencode.binary.
Modelos atenuados o sin gratuitos
«Configurar en el host» indica que falta parametrizar ese proveedor en OpenCode. Si no ves modelos gratuitos, apaga el filtro de «Solo gratuitos» para ver toda la lista disponible.
El agente solicita salir del proyecto
Las tarjetas de solicitud muestran la ruta exacta involucrada para leer o escribir fuera del proyecto. Revisa la ruta con atención antes de conceder permiso.
Falta el botón de Cambios
Solo aparece cuando el terminal está dentro de un repositorio git y el Gateway es lo bastante reciente para servir diffs. Comparar con la base y Descartar necesitan Gateway 0.13 o posterior. Actualiza volviendo a ejecutar el comando de instalación.
Requiere un Gateway más reciente
Las versiones anteriores conservan su utilidad como terminal. La colaboración entre agentes requiere Herdr 0.9.0 o superior en esa sesión.
El host está tras un proxy
Tu ordenador es el que conecta con los proveedores de IA. Si necesitas proxy para acceder a la red, configúralo en OpenCode dentro de esa máquina.
Terminal no disponible
El Gateway está en marcha pero no hay ningún backend de terminal: tmux instalado sin servidor de tmux, o Herdr sin iniciar. La pantalla lista los backends del Gateway y su estado; inicia uno y el terminal aparece solo. Mientras tanto, las sesiones de agente siguen funcionando.
«Este terminal no puede enviar ⌃↵»
El Gateway rechazó una combinación. Con tmux, ejecuta tmux set -s extended-keys on y, para Ctrl+Intro, también tmux set -s extended-keys-format csi-u. La pista bajo el mensaje repite la explicación del propio Gateway.
Un mosaico de agente dice Requiere configuración o Requiere actualización
Ejecuta muqun-gateway agent en el host: indica el siguiente paso para cada agente. Requiere actualización significa que este Gateway es más antiguo que el protocolo del agente; vuelve a ejecutar el comando de instalación.
github · issues
¿Sigues con dudas?
Abre una incidencia en GitHub. Es el canal principal para recibir sugerencias y corregir incidencias.
USEFUL REPORT CHECKLIST
Incluye la versión de la app, la del Gateway y la acción realizada justo antes del problema.
PRIVACY GUARANTEE
Privacidad e informes seguros
El equipo de soporte nunca te solicitará tokens de acceso, transcripciones completas de terminal, código fuente confidencial ni códigos QR. Elimina cualquier dato sensible antes de adjuntar capturas o registros.