Commencer depuis l’accueil
Choisissez ordinateur, agent, modèle, mode et dossier, joignez des fichiers puis envoyez un objectif dans une conversation ou un terminal.
GUIDE D’UTILISATION · MANUEL DE RÉFÉRENCE
Tout ce dont vous avez besoin pour garder votre machine à portée de main.
Muqun connecte votre téléphone directement à votre propre ordinateur ou serveur. Découvrez comment installer et configurer la Gateway, naviguer dans vos terminaux, configurer et piloter vos agents de code — Antigravity, Claude Code, Antigravity, Claude Code, Codex, Cursor, DeepSeek Harness, FX, OpenCode, Pi, Qoder CLI Cursor FX Pi Qoder CLI et T3 Code, installer des thèmes et résoudre les problèmes de connexion.
MUQUN / 4.0.0
Un espace de travail, du premier objectif à la prochaine modification.
Sessions natives pour Codex, OpenCode, DeepSeek Harness et T3 Code. Approuvez les permissions, suivez les tâches et examinez les diffs depuis votre poche, relié à votre machine.
Voir ce qui vous attend
Les cartes d’ordinateur affichent tâches actives, progression, décisions et travail récent. Les sous-tâches restent liées au travail parent.
Parler, puis relire
Maintenez Envoyer pour enregistrer et insérer la transcription dans le brouillon. Relisez avant l’envoi ; configurez une transcription de fichier ou en temps réel.
Git dans le même espace
Ouvrez Changes et Lazygit ensemble. Parcourez les worktrees liés si le Gateway le permet, sans changer le checkout du terminal.
Lire avant de télécharger
Les mises à jour compatibles affichent notes, progression et redémarrage après vérification. Plus tard reporte la demande pour ce lancement.
Des réponses au-delà du texte
Lisez les diagrammes natifs et les fichiers, puis lancez l’audio intégré à votre choix. Il s’arrête à la fermeture de l’aperçu ou au début de la dictée.
Maîtriser le stockage temporaire
Consultez les caches récupérables et configurez le nettoyage automatique dans Storage.
Mettez à jour via Google Play ou l’App Store. Les outils d’agent, de tâches et de Git suivent les capacités du Gateway. Les anciens Gateways conservent leurs accès compatibles au terminal et à OpenCode.
muqun-gateway
Installez la Gateway, puis appairez votre téléphone.
Muqun communique avec un seul programme sur votre propre ordinateur : la Gateway. Vous l’installez, la lancez et appairez votre téléphone une seule fois. Aucun compte à créer, rien ne transite par nos serveurs.
PRE-FLIGHT REQUIREMENTScheck before installing
- macOS ou Linux, sur un ordinateur dont vous êtes administrateur (Windows non supporté).
- tmux ou Herdr 0.7.5 ou supérieur déjà installé — la Gateway pilote l’un d’eux sans le remplacer.
- Les deux appareils sur le même réseau privé. Tailscale est la solution recommandée (utilisez Tailscale Serve, jamais Funnel).
- Aucun compte, aucun abonnement et aucun relais intermédiaire nous appartenant.
Exécutez l’installateur sur votre ordinateur
Il place un binaire unique dans ~/.local/bin/muqun-gateway, le configure et ouvre l’écran d’appairage au premier lancement. Compatible macOS et Linux (Windows n’est pas encore pris en charge).install curl -fsSL https://muqun.dev/gateway.sh | shLancez-la selon l’un des deux modes
Vous pouvez soit la lancer vous-même, soit la confier au système pour la maintenir active. Les deux options rendent la Gateway opérationnelle ; la différence réside dans le comportement au redémarrage.Choisissez l’un ou l’autre : avec le service installé, un arrêt manuel via stop sera immédiatement relancé par le superviseur.Ouvrez le gestionnaire d’appairage
Quel que soit le mode de démarrage, voici l’étape suivante. Le gestionnaire est un panneau plein écran dans votre terminal affichant le QR code, l’état d’exécution et la liste des appareils autorisés.pair muqun-gateway manageScannez puis saisissez le code
Scannez le QR code dans Muqun. L’ordinateur affiche alors un code court au format XXXX-XXXX ; le saisir dans l’application valide l’appairage. Scanner seul ne suffit pas — le code prouve que la personne tenant le téléphone est bien vous.
MANUAL ADDRESS PAIRING
Impossible de scanner ? Entrez manuellement l’adresse de la Gateway dans l’application (affichée dans le gestionnaire), puis saisissez le même code court.
CODE VALIDITY & RETRIES
Le code est valable 5 minutes et s’annule après 8 essais infructueux. Appuyez sur p dans le gestionnaire pour générer un nouveau QR et un nouveau code.
RÉSEAU PRIVÉ RECOMMANDÉ
Utilisez Tailscale sur les deux appareils.
Nous vous recommandons vivement de placer votre téléphone et votre ordinateur sur le même réseau Tailscale tailnet. Cela évite toute redirection de port et protège votre Gateway d’Internet. Tailscale Serve permet d’ajouter une adresse HTTPS privée (n’utilisez pas Tailscale Funnel avec Muqun).
workspace · group.panel
Votre vrai terminal.
Il s’agit de votre véritable terminal, pas d’une simple retranscription. La Gateway pilote tmux ou Herdr sur votre ordinateur et l’application en dessine le contenu — vous retrouvez exactement la session laissée sur votre bureau.
WORKSPACE ARCHITECTURE
Espaces, groupes et terminaux
Trois niveaux : espace · groupe.panneau. Un espace correspond à un projet, un groupe regroupe plusieurs terminaux, et un terminal est un shell. Muqun affiche un terminal à la fois en plein écran, sans découper l’affichage mobile de façon illisible.
Changer de vue
Faites glisser la pilule de titre en haut pour changer d’espace de travail. Les puces au-dessus de la saisie basculent entre les terminaux d’un même groupe.
Panneau des processus
Le tiroir liste tous les espaces, groupes et terminaux actifs de la machine. Un appui long permet d’accéder aux actions de fermeture en toute sécurité.
CONTROLS, EDITORS & DEVELOPER TOOLS
Barre de touches dédiée
La bande au-dessus du champ de saisie fournit les touches essentielles absentes du clavier mobile : Échap, Tab, ⌃C, flèches, ainsi que des touches contextuelles adaptées à l’application en cours (⇧TAB et ⌃O sous Claude Code, :w et gg sous nvim). Désactivable dans Réglages → Terminal.
Zone de composition (Composer)
Police à chasse fixe, multiligne, touche Entrée dédiée aux retours à la ligne — l’envoi se fait par un bouton pour éviter toute exécution accidentelle.
Historique de défilement
Tirez vers le bas depuis le haut du terminal pour charger l’historique. Un bouton « Dernier » apparaît dès que vous quittez le bas de page pour y revenir instantanément sans être interrompu par les nouveaux flux.
Modifications Git (Changes)
La vue git du répertoire du volet, la même feuille que pour une session d’agent — voir La feuille Modifications plus bas. Le bouton porte le nombre de fichiers modifiés et n’apparaît que si le volet est dans un dépôt git et que le Gateway peut fournir des diffs.
Fichiers (Files)
Accédez aux fichiers générés pendant vos sessions — images, code et documents — lisibles sans quitter l’application.
Ouvrir dans le navigateur
Entrez le port de votre serveur de dev local et Muqun l’ouvre à travers le tunnel existant, sans publication sur Internet.
Actions rapides
Commandes enregistrées, prompts favoris et combinaisons de touches fréquentes. Entièrement personnalisables.
LA FEUILLE MODIFICATIONS
Les volets de terminal et les sessions d’agent partagent une même feuille Modifications. Elle lance git sur l’hôte, dans le répertoire du volet ou de la session.
L’arbre
Les fichiers modifiés en arbre de dossiers, avec le nombre de fichiers et les totaux de lignes. Les noms longs sont raccourcis au milieu pour garder l’extension visible, et les dossiers profonds cessent de s’indenter après trois niveaux.
Portée
Le menu du haut bascule entre les modifications non validées et la comparaison avec la base de la branche — la merge-base avec origin/HEAD, sinon main ou master.
Les patchs se chargent à l’ouverture
La liste ne contient pas de diffs, si bien qu’une grosse modification s’ouvre vite. Afficher plus de contexte élargit le patch que vous lisez.
Annuler les modifications
Dans le menu … d’un fichier, après confirmation : un fichier suivi est restauré, un fichier non suivi supprimé. Le Gateway refuse quand le dépôt est votre répertoire personnel, et pour tout chemin qui sort du dépôt — y compris un lien symbolique pointant au-dehors.
Sur un Gateway plus ancien
La comparaison avec la base et l’annulation dans un terminal demandent un Gateway qui propose pane_vcs_files. Sans lui, la feuille du terminal montre le même arbre de modifications non validées, sans plus.
LE CLAVIER DE TABLETTE ET LES TOUCHES ÉTENDUES
Sur une tablette, le clavier à l’écran est un clavier entier : une bande de touches de fonction que l’on peut masquer, une rangée de chiffres, ctrl, alt et shift collants (double touche pour verrouiller), et Début, Fin, Page préc. et Page suiv. au-dessus des flèches. Les combinaisons hors du jeu classique — Ctrl+Entrée, Maj+Entrée, Ctrl+flèches, Alt+lettre, touches F — ne partent que si le Gateway dit pouvoir les transmettre.
Les touches qu’il ne peut pas envoyer
Une touche que le Gateway ne peut pas transmettre est dessinée en atténué et le dit quand on la presse. Tant qu’un modificateur est tenu, les touches que cette combinaison n’atteint pas s’assombrissent, et une combinaison refusée consomme quand même un modificateur à usage unique.
Herdr
Transmet toutes les combinaisons. Rien à régler.
tmux
tmux 3.2 ou plus récent avec extended-keys on, et le programme du volet doit demander les touches étendues. Ctrl+Entrée et Maj+Entrée demandent aussi extended-keys-format csi-u.
Codex et Claude Code
Codex sous tmux ne reçoit pas Maj+Entrée : utilisez ⌃J pour une nouvelle ligne. Claude Code prend \ suivi d’Entrée pour une nouvelle ligne.
tmux set -s extended-keys ontmux set -s extended-keys-format csi-uCes deux commandes prennent effet tout de suite et durent jusqu’à l’arrêt du serveur tmux. Pour les garder, mettez les deux mêmes lignes, sans le tmux du début, dans ~/.tmux.conf.
set -s extended-keys onset -s extended-keys-format csi-u●
Muqun reste un observateur : ouvrir une session ne modifie pas votre agencement et fermer l’application n’arrête aucun processus.
muqun-gateway agent
Agents.
Un terminal est un shell dans lequel vous tapez. Une session d’agent est une conversation avec un agent de code qui tourne sur votre ordinateur — Antigravity, Claude Code, Codex, Cursor, DeepSeek Harness, FX, OpenCode, Pi, Qoder CLI ou T3 Code — que l’app dessine en messages, cartes d’outil et questions plutôt qu’en écran de texte. Les deux passent par le même Gateway et le même jumelage ; ils diffèrent par ce à quoi le Gateway parle pour vous.
Un terminal
tmux ou Herdr sur l’hôte. L’app montre ce que montre le volet, et les touches que vous envoyez sont celles que le programme reçoit — tout programme fonctionne donc, y compris les agents CLI qui vivent directement dans un terminal, comme Claude Code.
Une session d’agent
Un agent auquel le Gateway parle par sa propre API. Chaque session appartient à un agent et revient toujours à lui. L’atelier — modes, modèles, commandes slash, skills, pièces jointes, annulation, compaction, exécutions en arrière-plan — ne montre que ce que cet agent prend en charge.
LES AGENTS PRIS EN CHARGE PAR 4.0
codex
Codex
Codex est activé par défaut. Le Gateway détecte codex sur votre PATH, s’attache à son daemon partagé (le démarre au besoin) et hérite de vos identifiants locaux depuis ~/.codex pour offrir sessions natives et cartes d’outils.
opencode
OpenCode
OpenCode ne demande aucune configuration. Le Gateway reprend un service OpenCode déjà lancé, ou en démarre un lui-même ; il faut OpenCode 2. Tout l’atelier est disponible.
deepseek
DeepSeek Harness
DeepSeek Harness reste éteint jusqu’à ce que vous l’activiez. Lancez le Harness sur l’hôte, puis indiquez-le au Gateway. Ses modes sont ses propres préréglages, choisis à la création d’une session ; les pièces jointes lui arrivent comme fichiers sur l’hôte.
t3
T3 Code
T3 Code reste éteint tant que le Gateway n’a pas d’identifiant pour lui. Le Gateway se jumelle une fois avec T3 et garde cet identifiant. Il gère pièces jointes, approbations et annulation — une annulation T3 revient sur des tours entiers, l’app demande donc confirmation avant.
LES METTRE EN PLACE EN LIGNE DE COMMANDE
Sur l’ordinateur qui fait tourner le Gateway. muqun-gateway agent vérifie chaque agent depuis votre shell et affiche son état, sa version et son adresse, avec l’étape suivante pour ceux qui ne sont pas prêts. Il sort avec un code non nul tant qu’un agent activé est inutilisable, ce qu’un script peut aussi vérifier.
L’état de chaque agent, avec l’étape suivante.
muqun-gateway agentJumelle T3 Code. Sur la même machine, il émet un identifiant avec t3 auth session issue — ajoutez --base-dir si T3 garde ses données ailleurs. Pour un T3 sur un autre hôte, lancez t3 pair là-bas et passez le code avec --token CODE.
muqun-gateway agent setup t3Trouve un DeepSeek Harness en marche et l’active. Il cherche sur les ports 3080 et 19387 ; passez --endpoint URL si le Harness est ailleurs.
muqun-gateway agent setup deepseekNe change rien. Affiche quel binaire OpenCode le Gateway utiliserait et sa version — il faut la 2.x.
muqun-gateway agent setup opencodesetup écrit config.json et indique si le Gateway en cours doit redémarrer pour voir la modification. Un Gateway installé comme service est redémarré pour vous après confirmation (--yes la saute) ; sinon, redémarrez-le vous-même.
À la main, dans config.json
CONFIG.JSONLes mêmes réglages, si vous préférez les écrire vous-même. Ajoutez les blocs nécessaires, puis redémarrez le Gateway. Un code de t3 pair va dans pairing_token ; au démarrage suivant, le Gateway l’échange une fois et n’en a plus besoin. opencode.binary et codex.binary ne servent qu’à imposer un binaire précis.
{ "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" }}●
L’identifiant T3 est rangé dans t3-credential.json, dans le répertoire d’état du Gateway — ~/.local/share/muqun-gateway/ sous Linux — lisible par vous seul. Si T3 le révoque ou s’il expire, relancez agent setup t3.
SUR LE TÉLÉPHONE
Une tuile par agent
L’accueil affiche une tuile pour chaque agent que le Gateway signale, le dernier utilisé en premier. Au-delà de trois, les autres sont sous Plus d’agents. Quand plusieurs sont prêts, Nouvelle session demande lequel.
Les questions arrivent en notification
Quand une session — celle d’un sous-agent comprise — vous demande de remplir un formulaire, chaque téléphone jumelé reçoit une notification indiquant que l’agent attend votre réponse. Les demandes d’autorisation sont notifiées comme avant.
Configuration requise
Le Gateway voit l’agent mais n’a pas d’identifiant pour lui. La tuile ouvre un guide avec la commande exacte à lancer sur l’hôte — pour T3 Code, t3 pair.
Mise à jour requise
L’agent parle un protocole plus récent que ce que connaît ce Gateway. Mettez à jour le Gateway sur cet ordinateur en relançant la commande d’installation.
Non installé, Hors ligne
L’agent n’est pas sur l’hôte, ou ne tourne pas. La tuile dit lequel et ouvre un guide de démarrage écrit pour cet agent.
Gateways plus anciens
Un Gateway antérieur à 0.13 n’offre pas multi_agent : l’app reste en mode agent unique avec OpenCode et signale quand une fonction demande un Gateway plus récent.
opencode serve --service
L’agent OpenCode.
Une interface pensée spécifiquement pour OpenCode plutôt qu’un simple agent dans un terminal : basculez entre vos sessions, inspectez les diffs de chaque outil sous forme de cartes et répondez aux questions en un clic.
RUNTIME LOCAL · AUCUN COMPTE REQUIS
Votre ordinateur discute directement avec vos fournisseurs d’IA.
Aucune connexion nécessaire. Muqun ne gère aucun compte et ne vous demande aucune clé d’API. C’est OpenCode sur votre ordinateur qui communique directement avec vos fournisseurs. La Gateway ne fait transiter aucun identifiant.
PRÉREQUIS
- OpenCode 2.x installé sur le même ordinateur que la Gateway.
- Au moins un fournisseur configuré dans OpenCode (filtre dédié aux modèles gratuits inclus).
- Le service OpenCode actif (démarré ou rattaché automatiquement par la Gateway).
- Une version récente de la Gateway compatible avec l’interface agent.
AGENT CAPABILITIES & WORKFLOW
Sessions et sous-agents
Chaque session possède son propre contexte. Si une tâche délègue à des sous-agents, ils apparaissent en retrait sous la session principale pour une lecture claire.
Projets
Changez le répertoire de travail de l’agent en un clin d’œil. Choisir un projet rouvre directement sa dernière session active.
Modèles et profils d’agents
Sélectionnez parmi vos modèles configurés avec affichage de la taille de fenêtre contextuelle et badge Free. Basculez entre Build, Plan, Explore et vos agents sur mesure.
Commandes / et compétences
Tapez / dans la saisie. Certaines commandes sont traitées directement par l’application (/new, /models, /undo) ; les autres s’exécutent sur l’hôte.
Pièces jointes et mentions @
Envoyez des photos ou des fichiers. Les images sont réencodées pour purger les métadonnées EXIF. Tapez @ pour cibler un fichier du projet sans devoir décrire son chemin.
Permissions et questions
Lorsque l’agent s’apprête à exécuter une commande ou modifier un fichier, une carte vous invite à choisir : Autoriser, Toujours autoriser ou Refuser (accessible également depuis les notifications).
Tâches d’arrière-plan et file d’attente
Détachez les opérations longues en arrière-plan. Pendant qu’un tour s’exécute, vos nouveaux messages peuvent intervenir immédiatement ou être mis en attente.
Contexte et compaction
Surveillez l’utilisation de la fenêtre contextuelle, les jetons consommés et l’estimation du coût. Les synthèses automatiques d’historique sont signalées dans la chronologie.
Annulation (Undo)
/undo rétablit le projet à l’état précédant votre dernier message ; /redo annule l’opération. Conçu volontairement sous forme de commande pour éviter les fausses manipulations.
●
Les appels d’outils s’affichent sous forme de cartes avec diffs unifiés, exactement comme dans la vue Modifications.
config.json
Configuration de la Gateway.
La plupart des utilisateurs n’ont jamais besoin d’ouvrir ce fichier. Il sert pour les cas particuliers : changer de port, persister au redémarrage, ou indiquer un chemin OpenCode non standard.
Le fichier de configuration
JSON SCHEMAAu format JSON, il est généré automatiquement lors de l’installation. Ne le modifiez manuellement que si nécessaire et redémarrez ensuite la Gateway. Sur macOS, il se situe dans ~/Library/Application Support/muqun-gateway/. Les appareils appairés et les journaux sont stockés dans ~/.local/share/muqun-gateway/.
~/.config/muqun-gateway/config.jsonCONFIGURATION KEYS REFERENCE
labelLe nom affiché par l’application pour cet ordinateur.
listenL’adresse et le port d’écoute. Par défaut 0.0.0.0:23847 (ou 127.0.0.1 si l’adresse publiée est locale).
public_urlL’adresse encodée dans le QR d’appairage. Modifiez-la avec u dans le gestionnaire plutôt qu’à la main.
transport_encryptionChiffrement du transport, défini sur required par défaut. Modifie les futurs appairages sans altérer les existants.
sessionsLes backends de terminaux montés (tmux, Herdr ou les deux). Géré via muqun-gateway backend.
autostart_backendsBackends démarrés avec la Gateway. Vide par défaut pour éviter tout lancement imprévu.
rich_agent_pushesDésactivé par défaut. Si activé, les questions de l’agent sont insérées dans la notification, ce qui expose le texte sur l’écran de verrouillage.
opencode.autostartActivé par défaut : la Gateway lance OpenCode si aucun service n’est détecté. Désactivable via "opencode": { "autostart": false }.
opencode.binaryChemin de l’exécutable OpenCode. À spécifier si votre service ne dispose pas du PATH de votre shell habituel.
codexAgent de code Codex. Activé par défaut (enabled: true) ; le Gateway recherche codex dans votre PATH et s’attache au daemon partagé. Utilisez codex.binary pour pointer un binaire précis, ou désactivez-le avec enabled: false.
deepseekDeepSeek Harness. Rattaché seulement si enabled vaut true ou si un endpoint est donné ; token et secret si votre Harness en a besoin. Le Gateway ne balaie jamais les ports pour le trouver.
t3T3 Code. enabled, url (http://127.0.0.1:3773 par défaut), et soit pairing_token issu de t3 pair, soit un token que vous détenez déjà. runtime_mode fixe sa politique d’autorisation ; full-access par défaut.
PORTS & ÉCOUTE
Défaut
Un seul port TCP : 23847.
Modifier
muqun-gateway setup --port N, puis redémarrez.
Adresse liée
127.0.0.1 si l’adresse publiée est locale, 0.0.0.0 sinon.
Sur un tailnet
Aucune redirection de port sur votre routeur, c’est pourquoi nous le conseillons.
DEUX MODES DE FONCTIONNEMENT
DIRECT
Lancement direct manuel
Démarrage
Quand vous lancez la commande.
Arrêt
muqun-gateway stop ou reboot de la machine.
Survit au reboot
Non.
Désinstallation
Rien à faire, un simple stop suffit.
muqun-gateway startSERVICE
En tant que service système
Démarrage
À la connexion de session et après un crash.
Arrêt
Uniquement via service uninstall.
Survit au reboot
Oui.
Désinstallation
service uninstall (appairages préservés).
muqun-gateway service installUnité utilisateur systemd sous Linux, LaunchAgent sous macOS. Jamais de privilèges root, aucun fichier hors de votre répertoire personnel.
COMMENT OPENCODE EST DÉMARRÉ
- Vérifie si un service OpenCode fonctionne déjà en lisant l’adresse publiée dans ~/.local/state/opencode/service.json.
- S’il existe, s’y rattache directement et préserve vos sessions existantes.
- Sinon, lance opencode serve --service et surveille le processus, en détectant automatiquement tout changement de port.
●
Pas d’OpenCode installé ? Rien ne s’y attache et seul l’écran d’agent indique l’état hors ligne ; le terminal n’est pas affecté.
"opencode": { "autostart": false }GESTIONNAIRE D’APPAIRAGE
Lancé avec muqun-gateway manage. Il liste les processus et appareils autorisés avec les raccourcis suivants :
p
Afficher à nouveau le QR code pour associer un nouvel appareil.
x
Révoquer l’accès d’un appareil.
u
Modifier l’adresse encodée dans le QR (a pour la redétecter).
s / t
Démarrer ou arrêter la Gateway sans quitter.
m / h
Ajouter un backend tmux ou Herdr (f pour défaut, d pour supprimer).
e
Modifier le chiffrement pour les futurs appairages.
q
Quitter le gestionnaire (n’arrête jamais vos sessions).
Rétrocompatibilité
L’application interroge la Gateway sur ses capacités réelles plutôt que de deviner par sa version, et masque les fonctionnalités absentes sans planter. Une ancienne Gateway reste un excellent terminal. Seule la collaboration multi-agents requiert Herdr 0.9.0 ou supérieur sur la session.
Mise à niveau
Exécutez simplement la même commande d’installation. Elle remplace le binaire, conserve vos clés, votre adresse, votre configuration et vos appairages. Si vous aviez installé le service, relancez service install une fois après la mise à niveau.
Journaux
DIAGNOSTICSEn mode direct et avec macOS LaunchAgent, les logs sont inscrits dans ~/.local/share/muqun-gateway/gateway.log. Sous Linux avec systemd, ils vont dans journalctl. Pour plus de détails, définissez MUQUN_LOG=debug (ou RUST_LOG=debug) avant le démarrage.
journalctl --user -u dev.osuki.muqun-gatewaymuqun.dev/themes
Thèmes.
Cover Courier est le thème intégré par défaut. Installez des thèmes clairs et sombres depuis le catalogue, un fichier ou un lien pour changer ensemble images et couleurs de l’application et du terminal.
Thèmes par défaut et importés
Choisissez dans Réglages → Apparence, puis Système, Clair ou Sombre. Les mises à jour des thèmes importés actualisent le thème choisi en conservant vos préférences d’apparence.
Parcourir le catalogue
Consultez le catalogue officiel sur muqun.dev. Aucun téléchargement ne s’effectue avant d’ouvrir une fiche, et le poids du pack est précisé à l’avance.
Structure d’un thème
Un fichier .muqun-theme est une archive zip contenant theme.json et un dossier assets d’images. .muqun-theme.json est la version textuelle sans images.
Personnalisations couvertes
Un thème définit couleurs de l’application, du terminal et ANSI, images, icônes et opacité. Scène d’accueil, fond de page et images de saisie d’accueil ont des emplacements séparés avec variantes téléphone/tablette et claires/sombres. PNG, JPEG et WebP sont acceptés, pas les polices externes, SVG ou animations.
Limites de taille
Manifeste jusqu’à 256 KiB, jusqu’à 32 images de 8 MiB max chacune, 25 MiB maximum pour l’archive globale.
Installer depuis un fichier
Ouvrez un .muqun-theme depuis vos fichiers ou via AirDrop, ou utilisez « Importer un fichier » dans l’application.
Installer depuis un lien
Indiquez une URL ou un dépôt GitHub. La provenance des ressources est contrôlée avant le téléchargement.
Installer depuis le terminal
Touchez un chemin .muqun-theme dans la sortie console pour obtenir une prévisualisation instantanée.
Aperçu avant application
Le thème s’applique temporairement à l’ensemble de l’application pour vous permettre de naviguer avant de confirmer l’application définitive.
Opacité d’arrière-plan
Ajustez séparément l’opacité du fond de l’interface et celle du terminal pour laisser transparaître vos fonds d’écran.
Créer votre thème
Grâce à la compétence agent dédiée intégrée à Muqun, décrivez simplement le style désiré pour obtenir un thème prêt à l’emploi.
Publier dans le catalogue
Le catalogue est un dépôt GitHub public. Soumettez une Pull Request pour être référencé sur muqun.dev en quelques minutes.
Supprimer des thèmes
Glissez sur une ligne dans la liste des thèmes pour le désinstaller. Réglages → Stockage permet de nettoyer les thèmes inutilisés.
when it does not connect
Dépannage.
La majorité des problèmes de connexion proviennent de l’une de ces 4 causes : la Gateway est arrêtée, l’adresse est inaccessible, l’appairage a sauté ou OpenCode est hors ligne.
VÉRIFICATIONS RAPIDES
Appairer un ordinateur
Installez la Gateway (compatible tmux ou Herdr), ouvrez le gestionnaire, scannez le QR avec Muqun et saisissez le code affiché à l’écran.
Rétablir une connexion
Vérifiez que tmux ou Herdr 0.7.5+ et la Gateway sont lancés. Assurez-vous que les deux appareils accèdent à la même adresse privée.
Supprimer un appareil
Supprimez le serveur depuis l’écran d’accueil pour révoquer l’accès du téléphone. Vous pouvez aussi le faire depuis le gestionnaire de la Gateway.
Réactiver les notifications
Activez les notifications dans les réglages système du téléphone et dans Muqun. Rouvrez le serveur pour réenregistrer le jeton auprès de la Gateway.
DIAGNOSTIC SOLUTIONS
Impossible d’appairer
Le message « Could not reach the gateway » indique que le téléphone ne peut joindre l’adresse du QR. Vérifiez muqun-gateway status sur l’ordinateur et assurez-vous d’être sur le même Wi-Fi ou le même tailnet Tailscale. Une Gateway liée à 127.0.0.1 n’est pas accessible de l’extérieur ; changez son adresse avec u dans le gestionnaire.
Code refusé ou expiré
Le code comporte 8 caractères et expire au bout de 5 minutes ou 8 échecs. Appuyez sur p dans le gestionnaire pour régénérer un QR et un code frais. Les caractères ambigus (0, 1, I, L, O) sont exclus.
Signification de la pastille
Une pastille pleine indique une réponse confirmée (vert pour ONLINE, gris pour OFFLINE). Un cercle vide avec NOT CONNECTED signifie qu’aucun test n’a encore eu lieu ; touchez pour ouvrir le serveur.
Demande de nouvel appairage
Le jeton de cet appareil a été révoqué ou perdu lors d’une réinitialisation de la Gateway. Il suffit de réappairer en scannant le QR code à nouveau.
OpenCode introuvable
Si l’écran agent indique OpenCode service offline, lancez opencode serve --service sur l’hôte et touchez Revérifier. Si le service tourne déjà, indiquez son chemin absolu dans config.json sous opencode.binary.
Modèles grisés ou aucun gratuit
« À configurer sur l’hôte » signifie que le fournisseur n’est pas paramétré dans OpenCode. Désactivez le filtre « Gratuit uniquement » si vous souhaitez afficher l’ensemble des modèles disponibles.
L’agent veut sortir du projet
Les demandes de lecture ou d’écriture hors du projet affichent le chemin cible exact. Vérifiez attentivement le chemin avant d’accorder l’autorisation.
Bouton Modifications absent
Il n’apparaît que si le terminal est dans un dépôt git et que le Gateway est assez récent pour fournir des diffs. La comparaison avec la base et l’annulation demandent Gateway 0.13 ou plus récent. Mettez à jour en relançant la commande d’installation.
Gateway plus récente requise
Les anciennes versions continuent de fonctionner comme terminal. La collaboration multi-agents requiert Herdr 0.9.0 ou supérieur sur la session.
Hôte derrière un proxy
C’est votre ordinateur qui dialogue avec vos fournisseurs d’IA. Si un proxy est requis, configurez-le directement dans OpenCode sur la machine.
Terminal indisponible
Le Gateway tourne mais aucun backend de terminal — tmux installé sans serveur tmux, ou Herdr non démarré. L’écran liste les backends du Gateway et leur état ; démarrez-en un et le terminal apparaît de lui-même. Les sessions d’agent continuent de fonctionner entre-temps.
« Ce terminal ne peut pas envoyer ⌃↵ »
Le Gateway a refusé une combinaison. Sous tmux, lancez tmux set -s extended-keys on, et pour Ctrl+Entrée aussi tmux set -s extended-keys-format csi-u. L’indication sous le message reprend l’explication du Gateway.
Une tuile d’agent indique Configuration requise ou Mise à jour requise
Lancez muqun-gateway agent sur l’hôte : il nomme l’étape suivante pour chaque agent. Mise à jour requise signifie que ce Gateway est plus ancien que le protocole de l’agent — relancez la commande d’installation.
github · issues
Encore bloqué ?
Ouvrez un ticket sur GitHub. Tous les retours sont lus attentivement et nourrissent les futures versions.
USEFUL REPORT CHECKLIST
Précisez la version de l’application, celle de la Gateway et l’action réalisée juste avant l’erreur.
PRIVACY GUARANTEE
Confidentialité et signalement sécurisé
L’assistance n’a jamais besoin de vos jetons d’accès, de vos sorties terminal complètes, de votre code source ou de vos QR codes. Masquez toute information sensible avant de joindre des captures d’écran ou des logs.