Auf Home anfangen
Rechner, Agent, Modell, Modus und Ordner wählen, Dateien anhängen und ein Ziel direkt in eine Unterhaltung oder ein Terminal senden.
BENUTZERHANDBUCH · REFERENZMANUAL
Alles, was du brauchst, um deinen Rechner stets griffbereit zu haben.
Muqun verbindet dein Smartphone direkt mit deinem eigenen Rechner oder Server. Erfahre, wie du das Gateway installierst und einrichtest, Terminal-Workspaces bedienst, deine Coding-Agenten einrichtest und steuerst — Antigravity, Claude Code, Antigravity, Claude Code, Codex, Cursor, DeepSeek Harness, FX, OpenCode, Pi, Qoder CLI Cursor FX Pi Qoder CLI und T3 Code, Themes installierst und Verbindungsfehler behebst.
MUQUN / 4.0.0
Ein Arbeitsbereich, vom ersten Ziel bis zur nächsten Änderung.
Native Sitzungen für Codex, OpenCode, DeepSeek Harness und T3 Code. Berechtigungen freigeben, Aufgaben verfolgen und Diffs prüfen — direkt auf deinem eigenen Rechner.
Sehen, was dich braucht
Rechnerkarten zeigen aktive Aufgaben, Fortschritt, Entscheidungen und letzte Arbeit. Unteraufgaben bleiben mit ihrer übergeordneten Arbeit verbunden.
Sprechen, dann prüfen
Senden gedrückt halten, aufnehmen und die Transkription in den Entwurf einfügen. Vor dem Senden prüfen; der Datei- oder Echtzeit-Endpunkt ist konfigurierbar.
Git im selben Arbeitsbereich
Changes und Lazygit gemeinsam öffnen. Verknüpfte Worktrees auf unterstützten Gateways ansehen, ohne den Terminal-Checkout zu wechseln.
Vor dem Download nachlesen
Kompatible Updates zeigen Hinweise, Downloadfortschritt und einen verifizierten Neustart. Später verschiebt die Meldung für diesen App-Start.
Antworten über Text hinaus
Native Diagramme und Gesprächsdateien ansehen, Inline-Audio bewusst abspielen. Es stoppt beim Schließen der Vorschau oder beim Start der Spracheingabe.
Temporären Speicher verwalten
Rückgewinnbare Caches ansehen und automatische Bereinigung in Storage einstellen.
Aktualisiere über Google Play oder den App Store. Agenten-, Aufgaben- und Git-Werkzeuge richten sich nach den Fähigkeiten des Gateways. Ältere Gateways behalten ihre unterstützten Terminal- und OpenCode-Wege.
muqun-gateway
Installiere das Gateway und kopple dein Handy.
Muqun kommuniziert mit einem einzigen Programm auf deinem eigenen Rechner: dem Gateway. Du installierst es dort, startest es und koppelst das Smartphone einmalig. Es gibt kein Benutzerkonto und nichts von dir passiert unsere Server.
PRE-FLIGHT REQUIREMENTScheck before installing
- macOS oder Linux auf einem Rechner, den du selbst verwaltest (Windows wird noch nicht unterstützt).
- tmux oder Herdr 0.7.5 oder neuer muss bereits installiert sein — das Gateway steuert eines davon, statt es zu ersetzen.
- Beide Geräte im selben privaten Netzwerk. Tailscale ist der empfohlene Weg; verwende Tailscale Serve, niemals Funnel.
- Kein Konto, kein Abonnement und kein zwischengeschaltetes Relais von uns.
Starte das Installationsskript auf deinem Rechner
Es legt eine einzelne Binärdatei unter ~/.local/bin/muqun-gateway ab, konfiguriert sie und öffnet beim ersten Start den Kopplungsbildschirm. Für macOS und Linux; Windows wird derzeit noch nicht unterstützt.install curl -fsSL https://muqun.dev/gateway.sh | shStarte es auf eine von zwei Arten
Entweder startest du es selbst oder übergibst es dem Betriebssystem zur permanenten Überwachung. Beide Wege führen zu einem laufenden Gateway; der Unterschied liegt im Verhalten bei einem Neustart.Wähle genau eine Option: Wenn der Dienst installiert ist, wird ein manuelles stop vom Supervisor sofort wieder rückgängig gemacht.Öffne das Verwaltungsfenster
Ganz gleich, wie du es gestartet hast: Das ist der nächste Schritt. Der Manager ist ein Vollbild-Panel in deinem Terminal, das den QR-Code, aktive Prozesse und jedes aktuell berechtigte Gerät anzeigt. Der Installer öffnet ihn beim ersten Mal automatisch; mit diesem Befehl kehrst du dorthin zurück.pair muqun-gateway manageScanne den QR-Code und tippe den Code ein
Scanne den QR-Code in Muqun. Der Rechner zeigt daraufhin einen kurzen Code im Format XXXX-XXXX an; die Eingabe in der App schließt die Kopplung ab. Das Scannen allein koppelt das Handy noch nicht — der Code beweist, dass die Person mit dem Handy du selbst bist.
MANUAL ADDRESS PAIRING
Kannst du nicht scannen? Gib die Gateway-Adresse in der App manuell ein (der Manager gibt die veröffentlichte Adresse aus) und tippe denselben Bestätigungscode ein.
CODE VALIDITY & RETRIES
Der Code ist fünf Minuten gültig und verfällt nach acht Fehlversuchen. Drücke im Manager p, um einen frischen QR-Code und Bestätigungscode zu generieren.
EMPFOHLENES PRIVATES NETZWERK
Nutze Tailscale auf beiden Geräten.
Wir empfehlen dringend, dein Handy und den Gateway-Rechner in dasselbe Tailscale-Tailnet zu holen. Das erspart Portfreigaben im Router und hält das Gateway aus dem öffentlichen Internet heraus. Tailscale Serve kann eine private HTTPS-Adresse ergänzen; nutze Tailscale Funnel nicht für Muqun.
workspace · group.panel
Dein echtes Terminal.
Kein Screenshot und kein nachträgliches Transkript, sondern dein lebendiges Terminal. Das Gateway steuert tmux oder Herdr auf deinem Rechner und die App zeichnet das Geschehen direkt nach — die Arbeit auf deinem Schreibtisch nimmst du nahtlos in die Hand, und das Schließen der App ändert daran nichts.
WORKSPACE ARCHITECTURE
Workspaces, Gruppen und Terminals
Drei Ebenen, adressiert als Workspace · Gruppe.Panel. Ein Workspace ist dein Projektverzeichnis, eine Gruppe bündelt Terminals darin, und ein Terminal ist eine Shell. Muqun zeigt jeweils ein Terminal formatfüllend an, ohne den mobilen Bildschirm unleserlich zu spalten.
Navigation zwischen Ebenen
Wische über die Titelleiste oben, um den Workspace zu wechseln. Die Chips über dem Eingabefeld wechseln zwischen den Terminals der aktuellen Gruppe. Für alles Weitere öffnest du die Panel-Übersicht.
Aktive Prozesse und Panel-Verwaltung
Das Panel-Sheet listet jeden Workspace, jede Gruppe und jedes Terminal auf deinem Rechner auf. Durch langes Drücken öffnest du Aktionen wie das sichere Schließen eines Fensters.
CONTROLS, EDITORS & DEVELOPER TOOLS
Die Terminal-Tastenleiste
Die Leiste über dem Eingabefeld liefert Tasten, die auf Smartphone-Tastaturen fehlen: Esc, Tab, ⌃C, Pfeiltasten sowie kontextabhängige Tasten (Shell-Befehle, ⇧TAB und ⌃O unter Claude Code, :w und gg unter nvim). In nvim führt im Insert-Modus stets Esc. Unter Einstellungen → Terminal abschaltbar.
Das Eingabefeld (Composer)
Nichtproportional, mehrzeilig, und die Eingabetaste erzeugt einen Zeilenumbruch — gesendet wird per Button, da versehentlich ausgeführte Befehle vermieden werden müssen.
Frühere Ausgaben nachladen
Ziehe vom oberen Rand des Terminals nach unten, um mehr Scrollback zu laden. Sobald du das Live-Ende verlässt, bringt dich ein „Neueste“-Pill sofort zurück. Neue Ausgaben reißen den Bildschirm niemals weg, während du liest.
Änderungen (Changes)
Die git-Ansicht für das Verzeichnis des Bereichs, dasselbe Sheet wie in einer Agentensitzung — siehe Das Änderungen-Sheet weiter unten. Der Button trägt die Zahl der geänderten Dateien und erscheint nur, wenn der Bereich in einem git-Checkout liegt und das Gateway Diffs liefern kann.
Dateien (Files)
Alles, was die Sitzung geschrieben hat — Bilder, Code und Dokumente — durchsuchbar und direkt in der App lesbar.
Im Browser öffnen
Tippe den Port deines lokalen Entwicklungsservers ein und Muqun öffnet ihn über die bestehende sichere Verbindung, ohne Freigabe im Internet.
Schnellaktionen (Quick actions)
Gespeicherte Befehle, Prompts und Tastenkombinationen, sortiert nach deiner Nutzungshäufigkeit. Frei anpassbar.
DAS ÄNDERUNGEN-SHEET
Terminalbereiche und Agentensitzungen teilen sich ein Änderungen-Sheet. Es führt git auf dem Host aus, im Verzeichnis des Bereichs oder der Sitzung.
Der Baum
Geänderte Dateien als Ordnerbaum, mit Dateianzahl und Zeilensummen. Lange Namen werden in der Mitte gekürzt, damit die Endung sichtbar bleibt, und tiefe Ordner rücken nach drei Ebenen nicht weiter ein.
Umfang
Das Menü oben wechselt zwischen nicht committeten Änderungen und dem Vergleich mit der Basis des Branches — der Merge-Base mit origin/HEAD, sonst main oder master.
Patches laden beim Öffnen
Die Liste enthält keine Diffs, daher öffnet auch eine große Änderung schnell. Mehr Kontext zeigen erweitert den Patch, den du gerade liest.
Verwerfen
Im …-Menü einer Datei, nach Rückfrage: Eine verfolgte Datei wird wiederhergestellt, eine unverfolgte gelöscht. Das Gateway verweigert es, wenn das Repository dein Home-Verzeichnis ist, und für jeden Pfad, der aus dem Repository herausführt — auch einen Symlink, der nach außen zeigt.
Auf einem älteren Gateway
Der Vergleich mit der Basis und Verwerfen im Terminal brauchen ein Gateway mit pane_vcs_files. Ohne zeigt das Terminal-Sheet denselben Baum der nicht committeten Änderungen und sonst nichts.
DIE PAD-TASTATUR UND ERWEITERTE TASTEN
Auf dem Tablet ist die Bildschirmtastatur eine ganze Tastatur: eine ausblendbare Funktionstastenleiste, eine Zahlenreihe, feststellbares Strg, Alt und Shift (Doppeltippen sperrt) und Pos1, Ende, Bild auf und Bild ab über den Pfeilen. Kombinationen außerhalb des klassischen Satzes — Strg+Enter, Shift+Enter, Strg+Pfeile, Alt+Buchstabe, F-Tasten — werden nur gesendet, wenn das Gateway sagt, dass es sie zustellen kann.
Tasten, die nicht gehen
Eine Taste, die das Gateway nicht zustellen kann, ist gedämpft gezeichnet und sagt das beim Drücken. Hältst du eine Sondertaste, werden die Tasten gedimmt, die diese Kombination nicht erreicht; eine abgelehnte Kombination verbraucht trotzdem eine einmalige Sondertaste.
Herdr
Stellt jede Kombination zu. Nichts einzustellen.
tmux
tmux 3.2 oder neuer mit extended-keys on, und das Programm im Bereich muss erweiterte Tasten anfordern. Strg+Enter und Shift+Enter brauchen außerdem extended-keys-format csi-u.
Codex und Claude Code
Codex unter tmux bekommt kein Shift+Enter: Für eine neue Zeile ⌃J verwenden. Claude Code nimmt \ gefolgt von Enter für eine neue Zeile.
tmux set -s extended-keys ontmux set -s extended-keys-format csi-uBeide wirken sofort und halten, bis der tmux-Server endet. Dauerhaft wird es mit denselben zwei Zeilen ohne das führende tmux in ~/.tmux.conf.
set -s extended-keys onset -s extended-keys-format csi-u●
Muqun beobachtet stets sicher: Das Öffnen einer Sitzung verändert deine Fensteranordnung nicht, und das Schließen der App stoppt keine Hintergrundprozesse.
muqun-gateway agent
Agenten.
Ein Terminal ist eine Shell, in die du tippst. Eine Agentensitzung ist ein Gespräch mit einem Coding-Agenten auf deinem Rechner — Antigravity, Claude Code, Codex, Cursor, DeepSeek Harness, FX, OpenCode, Pi, Qoder CLI oder T3 Code —, das die App als Nachrichten, Tool-Karten und Fragen zeichnet statt als Bildschirm voller Text. Beide laufen über dasselbe Gateway und dieselbe Kopplung; sie unterscheiden sich darin, mit wem das Gateway für dich spricht.
Ein Terminal
tmux oder Herdr auf dem Host. Die App zeigt, was der Bereich zeigt, und die Tasten, die du sendest, sind die Tasten, die das Programm bekommt — also läuft jedes Programm, auch CLI-Agenten, die direkt im Terminal leben, wie Claude Code.
Eine Agentensitzung
Ein Agent, mit dem das Gateway über dessen eigene API spricht. Jede Sitzung gehört einem Agenten und geht immer an ihn zurück. Die Werkbank — Modi, Modelle, Slash-Befehle, Skills, Anhänge, Rückgängig, Komprimierung, Hintergrundläufe — zeigt nur, was dieser Agent unterstützt.
DIE AGENTEN, DIE 4.0 UNTERSTÜTZT
codex
Codex
Codex ist standardmäßig aktiv. Das Gateway findet codex auf deinem PATH, bindet dessen geteilten Daemon an (startet ihn bei Bedarf) und übernimmt deine lokalen Anmeldedaten aus ~/.codex für native Agentensitzungen und Werkzeuge.
opencode
OpenCode
OpenCode braucht keine Einrichtung. Das Gateway übernimmt einen bereits laufenden OpenCode-Dienst oder startet selbst einen; nötig ist OpenCode 2. Die ganze Werkbank ist da.
deepseek
DeepSeek Harness
DeepSeek Harness ist aus, bis du es einschaltest. Starte das Harness auf dem Host und zeig dem Gateway, wo es läuft. Seine Modi sind seine eigenen Presets, gewählt beim Anlegen einer Sitzung; Anhänge erreichen es als Dateien auf dem Host.
t3
T3 Code
T3 Code ist aus, bis das Gateway Zugangsdaten dafür hat. Das Gateway koppelt sich einmal mit T3 und behält diese Zugangsdaten. Es kann Anhänge, Freigaben und Rückgängig — ein Rückgängig in T3 setzt ganze Runden zurück, deshalb fragt die App vorher nach.
EINRICHTUNG ÜBER DIE KOMMANDOZEILE
Auf dem Rechner, auf dem das Gateway läuft. muqun-gateway agent prüft jeden Agenten aus deiner Shell und zeigt Status, Version und Adresse, mit dem nächsten Schritt für alle, die nicht bereit sind. Solange ein eingeschalteter Agent nicht nutzbar ist, endet es mit einem Fehlercode, sodass auch ein Skript es prüfen kann.
Der Status jedes Agenten, mit dem nächsten Schritt.
muqun-gateway agentKoppelt T3 Code. Auf demselben Rechner stellt es Zugangsdaten mit t3 auth session issue aus — mit --base-dir, wenn T3 seine Daten anderswo hat. Für ein T3 auf einem anderen Host dort t3 pair ausführen und den Code mit --token CODE übergeben.
muqun-gateway agent setup t3Findet ein laufendes DeepSeek Harness und schaltet es ein. Gesucht wird auf den Ports 3080 und 19387; liegt das Harness woanders, --endpoint URL angeben.
muqun-gateway agent setup deepseekÄndert nichts. Zeigt, welches OpenCode-Binary das Gateway nehmen würde, und dessen Version — nötig ist 2.x.
muqun-gateway agent setup opencodesetup schreibt config.json und sagt, ob das laufende Gateway neu starten muss, um die Änderung zu sehen. Ein als Dienst installiertes Gateway wird nach Rückfrage neu gestartet (--yes überspringt sie); sonst starte es selbst neu.
Von Hand, in config.json
CONFIG.JSONDieselben Einstellungen, falls du sie lieber selbst schreibst. Die nötigen Blöcke ergänzen, dann das Gateway neu starten. Ein Code aus t3 pair gehört in pairing_token; beim nächsten Start tauscht das Gateway ihn einmal ein und braucht ihn danach nicht mehr. opencode.binary und codex.binary sind nur dafür da, eine bestimmte Binärdatei festzulegen.
{ "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" }}●
Die T3-Zugangsdaten liegen in t3-credential.json im Zustandsverzeichnis des Gateways — unter Linux ~/.local/share/muqun-gateway/ — und sind nur für dich lesbar. Widerruft T3 sie oder laufen sie ab, führe agent setup t3 erneut aus.
AUF DEM TELEFON
Eine Kachel pro Agent
Home zeigt für jeden Agenten, den das Gateway meldet, eine Kachel, den zuletzt benutzten zuerst. Ab dem vierten liegen die übrigen unter Weitere Agenten. Sind mehrere bereit, fragt Neue Sitzung, welcher.
Fragen kommen als Push
Bittet eine Sitzung — auch die eines Subagenten — dich, ein Formular auszufüllen, bekommt jedes gekoppelte Telefon eine Mitteilung, dass der Agent deine Eingabe braucht. Berechtigungsanfragen kommen wie bisher.
Einrichtung nötig
Das Gateway sieht den Agenten, hat aber keine Zugangsdaten. Die Kachel öffnet eine Anleitung mit dem genauen Befehl für den Host — für T3 Code t3 pair.
Update nötig
Der Agent spricht ein neueres Protokoll, als dieses Gateway kennt. Aktualisiere das Gateway auf diesem Rechner, indem du den Installationsbefehl erneut ausführst.
Nicht installiert, Offline
Der Agent ist nicht auf dem Host oder läuft nicht. Die Kachel sagt, was zutrifft, und öffnet eine Startanleitung für genau diesen Agenten.
Ältere Gateways
Ein Gateway vor 0.13 bietet kein multi_agent, also bleibt die App im Einzelagent-Modus mit OpenCode und sagt, wo eine Funktion ein neueres Gateway braucht.
opencode serve --service
Der OpenCode-Agent.
Ein Interface, das speziell für OpenCode entwickelt wurde, statt ein einfacher Terminal-Chatbot: Schneller Sitzungswechsel, Werkzeugaufrufe als visuelle Karten mit echten Unified Diffs und interaktive Freigaben.
LOKALE LAUFZEIT · KEIN BENUTZERKONTO
Dein Rechner spricht direkt mit deinen Modellanbietern.
Kein Login erforderlich. Muqun führt keine Konten und verlangt keine API-Schlüssel. Der Rechner selbst kommuniziert über OpenCode mit deinen KI-Anbietern. Das Gateway leitet keinerlei Anmeldedaten weiter.
VORAUSSETZUNGEN
- OpenCode 2.x auf demselben Rechner wie das Gateway installiert.
- Mindestens ein konfigurierter Modellanbieter in OpenCode (inklusive Filter für kostenlose Modelle).
- Laufender OpenCode-Dienst (wird vom Gateway automatisch gestartet oder angebunden).
- Ein aktuelles Gateway, das die Agenten-Oberfläche unterstützt.
AGENT CAPABILITIES & WORKFLOW
Sitzungen und Subagents
Jede Sitzung besitzt ihren eigenen Kontext. Wenn ein Task Subagents startet, werden diese eingerückt darunter dargestellt, sodass parallele Arbeitsabläufe übersichtlich bleiben.
Projects wechseln
Wechsle das Arbeitsverzeichnis des Agenten oder öffne ein neues. Bei der Auswahl eines Projekts wird die letzte Sitzung nahtlos fortgesetzt.
Modelle und Agentenrollen
Modellübersicht mit Kontextfenstergröße und Hinweisen auf kostenlose Modelle. Schneller Wechsel zwischen Rollen wie Build, Plan, Explore oder eigenen Agenten.
Slash-Befehle und Skills
Tippe / im Eingabefeld. Befehle wie /new, /models, /compact, /undo werden direkt beantwortet; andere laufen auf dem Host-Rechner.
Anhänge und @-Erwähnungen
Sende Fotos, Bilder oder Dateien. Bilder werden beim Senden neu encodiert, um EXIF-Metadaten zu entfernen. Mit @ referenzierst du Projektdateien direkt.
Berechtigungen und Rückfragen
Möchte der Agent Befehle ausführen oder Dateien verändern, entscheidest du per Tippen auf Erlauben, Immer erlauben oder Ablehnen — direkt auch auf dem Sperrbildschirm.
Hintergrundaufgaben & Warteschlange
Langwierige Tool-Ausführungen können in den Hintergrund verschoben werden. Neue Eingaben können sofort intervenieren oder für den nächsten Durchlauf eingereiht werden.
Kontext & automatische Verdichtung
Echtzeit-Einblick in Kontextfenster-Auslastung, Token-Verbrauch und geschätzte Kosten. Automatische Verlaufskomprimierung wird in der Timeline klar markiert.
Rückgängig machen (Undo)
/undo setzt das Projekt auf den Zustand vor deiner letzten Nachricht zurück; /redo hebt dies wieder auf. Bewusst als Befehl statt Button umgesetzt.
●
Werkzeugaufrufe erscheinen als Karten: Dateiänderungen zeigen ein direktes Unified Diff, genau wie in der Changes-Ansicht.
config.json
Das Gateway konfigurieren.
Die meisten Benutzer müssen die Konfiguration nie manuell öffnen. Sie existiert für Sonderfälle: ein anderer Port, ein Gateway, das Neustarts überleben soll, oder wenn OpenCode an einem unüblichen Pfad liegt.
Die Konfigurationsdatei
JSON SCHEMASie ist im JSON-Format verfasst und wird beim Setup automatisch erzeugt. Bearbeite sie nur von Hand, wenn du einen der unten stehenden Schlüssel anpassen musst, und starte das Gateway danach neu — die Konfiguration wird nur beim Start eingelesen. Unter macOS liegt die Datei unter ~/Library/Application Support/muqun-gateway/. Daneben liegt pairing.json; gekoppelte Geräte, Push-Tokens und Logs befinden sich im Statusverzeichnis ~/.local/share/muqun-gateway/.
~/.config/muqun-gateway/config.jsonCONFIGURATION KEYS REFERENCE
labelDer Name, den die App für diesen Rechner anzeigt.
listenDer Socket, an den gebunden wird (Host und Port). Standard ist 0.0.0.0:23847, oder Loopback, wenn die veröffentlichte Adresse eine Loopback-Adresse ist.
public_urlDie im Kopplungs-QR codierte Adresse — das, was das Handy tatsächlich anruft. Ändere sie vorzugsweise im Manager mit u statt von Hand.
transport_encryptionTransportverschlüsselung, standardmäßig auf required (erforderlich). Geräte behalten den Modus, in dem sie gekoppelt wurden; Änderungen wirken sich erst auf künftig gekoppelte Geräte aus.
sessionsDie Terminal-Backends, die dieses Gateway einbindet — tmux, Herdr oder beide gleichzeitig. Wird über muqun-gateway backend verwaltet.
autostart_backendsWelche davon mit dem Gateway gestartet werden sollen. Standardmäßig leer, um unbeabsichtigte Serverstarts zu vermeiden.
rich_agent_pushesStandardmäßig aus. Wenn aktiv, fließen Agent-Fragen und Optionen direkt in den Benachrichtigungstext ein — was Terminaltext auf den Sperrbildschirm und über Apple/Google-Server leitet.
opencode.autostartStandardmäßig aktiv: Das Gateway startet OpenCode selbst, wenn es keinen laufenden Dienst findet. Mit "opencode": { "autostart": false } abschaltbar.
opencode.binaryWelche OpenCode-Binärdatei gestartet werden soll. Falls weggelassen, wird OpenCode in ~/.opencode/bin oder im System-PATH gesucht.
codexCodex Coding-Agent. Standardmäßig aktiv (enabled: true); das Gateway sucht codex auf deinem PATH und verbindet den geteilten Daemon. Mit codex.binary eine genaue Binärdatei festlegen oder mit enabled: false deaktivieren.
deepseekDeepSeek Harness. Nur angebunden, wenn enabled true ist oder ein endpoint angegeben ist; token und secret, falls dein Harness sie braucht. Das Gateway durchsucht keine Ports danach.
t3T3 Code. enabled, url (standardmäßig http://127.0.0.1:3773) und entweder pairing_token aus t3 pair oder ein token, den du schon hast. runtime_mode legt die Berechtigungsregel fest; standardmäßig full-access.
PORTS & BINDUNG
Standard
Ein TCP-Port: 23847.
Ändern
muqun-gateway setup --port N ausführen und neu starten.
Bindung
127.0.0.1 wenn die publizierte Adresse Loopback ist, andernfalls 0.0.0.0.
Im Tailnet
Keine Portweiterleitung im Router erforderlich — daher unsere Empfehlung.
ZWEI WEGE ZUR PERMANENTEN AUSFÜHRUNG
DIRECT
Selbst im Hintergrund starten
Startet
Wenn du den Befehl ausführst.
Stoppt
muqun-gateway stop oder bei Rechner-Neustart.
Übersteht Neustart
Nein.
Rückgängig
Nichts nötig, einfach stop.
muqun-gateway startSERVICE
Als Systemdienst registrieren
Startet
Bei Anmeldung und nach Abstürzen automatisch.
Stoppt
Nur bei service uninstall.
Übersteht Neustart
Ja.
Rückgängig
service uninstall (Kopplungen bleiben erhalten).
muqun-gateway service installEine systemd-User-Unit unter Linux, ein LaunchAgent unter macOS. Niemals root, niemals außerhalb deines Home-Verzeichnisses.
WIE OPENCODE GESTARTET WIRD
- Das Gateway prüft, ob bereits ein intakter OpenCode-Dienst läuft, indem es die Adresse in ~/.local/state/opencode/service.json ausliest.
- Gefunden? Es dockt direkt daran an, und deine eigene opencode serve-Sitzung bleibt unberührt.
- Andernfalls startet es opencode serve --service selbst und überwacht den Prozess. Startet OpenCode auf einem neuen Port neu, wird dies automatisch erkannt.
●
Kein OpenCode auf dem Rechner? Dann dockt nichts an; nur die Agent-Ansicht zeigt Offline, das Terminal bleibt völlig unbeeinträchtigt.
"opencode": { "autostart": false }DAS VERWALTUNGSFENSTER
Wird mit muqun-gateway manage geöffnet. Es listet aktive Prozesse und berechtigte Geräte auf und bietet folgende Tastenkürzel:
p
Kopplungs-QR-Code erneut anzeigen, um ein weiteres Gerät hinzuzufügen.
x
Zugriffsberechtigung für ein Gerät widerrufen.
u
Im QR codierte Adresse bearbeiten (a führt eine automatische Neu-Erkennung durch).
s / t
Gateway starten oder stoppen, ohne den Manager zu verlassen.
m / h
tmux- oder Herdr-Backend hinzufügen (f wählt Standard, d entfernt eines).
e
Verschlüsselungsmodus für künftige Kopplungen ändern.
q
Manager schließen. Beendet deine Terminalsitzungen niemals.
Ältere Gateways bleiben kompatibel
Die App fragt das Gateway aktiv nach seinen Fähigkeiten, statt diese anhand der Versionsnummer zu erraten, und blendet nicht unterstützte Funktionen nahtlos aus. Ein älteres Gateway bleibt also ein voll funktionsfähiges Terminal. Lediglich die Agent-Kollaboration setzt Herdr 0.9.0 oder neuer in der jeweiligen Sitzung voraus (tmux unterstützt dies nicht).
Aktualisierung
Führe einfach denselben Installationsbefehl erneut aus. Er ersetzt die Binärdatei an Ort und Stelle, behält deine Server-Identität, Adresse, Konfiguration und alle Kopplungen bei. Falls du den Dienst installiert hattest, führe danach noch einmal service install aus.
Protokolle
DIAGNOSTICSIm Direktmodus und unter macOS LaunchAgent schreibt das Gateway nach ~/.local/share/muqun-gateway/gateway.log. Unter Linux mit systemd fließen die Logs ins Journal. Für mehr Details setze vor dem Start MUQUN_LOG=debug (oder RUST_LOG=debug); Standard ist info.
journalctl --user -u dev.osuki.muqun-gatewaymuqun.dev/themes
Themes.
Cover Courier ist das integrierte Standard-Theme. Installiere helle und dunkle Themes aus dem Katalog, einer Datei oder einem Link, um Bilder sowie App- und Terminalfarben gemeinsam zu ändern.
Standard und importierte Themes
Wähle das Theme unter Einstellungen → Darstellung und den Farbmodus System, Hell oder Dunkel. Updates importierter Themes erneuern das ausgewählte Theme und behalten deine Darstellungseinstellungen.
Katalog durchstöbern
Online-Katalog auf muqun.dev durchsuchen. Der Download startet erst beim Antippen, die Paketgröße wird vorab transparent angezeigt.
Aufbau eines Themes
Eine .muqun-theme-Datei ist ein Zip mit einer theme.json und einem assets-Ordner für Grafiken. .muqun-theme.json ist die bildfreie Variante.
Anpassungsumfang
Themes definieren App-, Terminal- und ANSI-Farben, Bilder, Symbole und Deckkraft. Home-Szene, Seitenhintergrund und Home-Eingabebilder haben separate Plätze mit Telefon-/Tablet- und Hell-/Dunkelvarianten. PNG, JPEG und WebP werden unterstützt; externe Fonts, SVG und Animationsdateien nicht.
Dateigrößenlimits
Manifest bis 256 KiB, bis zu 32 Bilder mit je max. 8 MiB, maximal 25 MiB für das gesamte Paket.
Aus Datei installieren
Öffne eine .muqun-theme-Datei über Dateien, AirDrop oder das Teilen-Menü, oder nutze „Datei importieren“ in der Theme-Auswahl.
Per Weblink installieren
Theme-URL oder GitHub-Repository angeben. Vor dem Download zeigt eine Prüfkarte die Host-Domain der Bilddateien an.
Direkt aus dem Terminal installieren
Tippe auf einen .muqun-theme-Pfad in der Terminalausgabe, um eine sofortige Vorschau anzuzeigen.
Vorschau vor dem Anwenden
Das Theme wird geladen und temporär auf die gesamte App angewendet. Dein bisheriges Theme bleibt unverändert, bis du auf „Theme anwenden“ tippst.
Hintergrund-Deckkraft
Zwei Regler für eigene Themes: Deckkraft des UI-Hintergrunds und des Terminal-Hintergrunds für subtile Durchschein-Effekte.
Themes selbst erstellen
Themes werden als Dateien verfasst. Mit dem mitgelieferten Agent-Skill beschreibst du einfach das gewünschte Design und erhältst ein fertiges Paket.
Im Katalog veröffentlichen
Der Katalog wird auf GitHub per Pull Request gepflegt. Nach dem Merge erscheint dein Theme automatisch auf muqun.dev.
Themes löschen
Einfach in der Themenliste zur Seite wischen. Unter Einstellungen → Speicher können ungenutzte Themes mit einem Klick aufgeräumt werden.
when it does not connect
Fehlerbehebung.
Fast alle Verbindungsprobleme haben eine von vier Ursachen: Das Gateway läuft nicht, die Adresse ist nicht erreichbar, die Kopplung fehlt, oder OpenCode ist offline.
SCHNELLPRÜFUNGEN
Einen Rechner koppeln
Gateway auf dem Rechner installieren (unterstützt tmux oder Herdr), Manager öffnen, QR in Muqun scannen und Bestätigungscode eingeben.
Verbindung prüfen
Prüfen, ob tmux oder Herdr 0.7.5+ und das aktuelle Gateway laufen. Sicherstellen, dass beide Geräte dieselbe private Adresse erreichen.
Gerät entfernen
Server auf dem Muqun-Startbildschirm löschen, um den Zugriff zu entziehen. Alternativ im Gateway-Manager auf dem Rechner widerrufen.
Benachrichtigungen erneuern
Mitteilungen in den Systemeinstellungen und in Muqun aktivieren. Gekoppelten Server erneut öffnen, um das Token zu aktualisieren.
DIAGNOSTIC SOLUTIONS
Kopplung schlägt fehl
„Could not reach the gateway“ bedeutet, dass die Adresse im QR-Code vom Handy aus nicht erreichbar ist. Prüfe muqun-gateway status und stelle sicher, dass beide Geräte im selben Wi-Fi oder Tailnet sind. Ein an 127.0.0.1 gebundenes Gateway ist von außen unerreichbar; passe dies mit u im Manager an.
Code abgelehnt oder abgelaufen
Der 8-stellige Code ist 5 Minuten gültig und verfällt nach 8 Fehlversuchen. Drücke p im Manager für einen neuen Code. Die Zeichen 0, 1, I, L, O kommen nicht vor.
Bedeutung des Statuspunkts
Ein ausgefüllter Punkt bedeutet eine bestätigte Rückmeldung (Grün: ONLINE, Grau: OFFLINE). Ein hohler Kreis mit NOT CONNECTED bedeutet, dass noch keine Prüfung stattfand — einfaches Antippen verbindet.
Aufforderung zur erneuten Kopplung
Das Gerätetoken auf dem Gateway existiert nicht mehr. Koppel den Server einfach erneut; deine übrigen Einstellungen auf dem Handy bleiben erhalten.
OpenCode wird nicht gefunden
Wenn die Agent-Ansicht offline meldet, starte opencode serve --service auf dem Rechner und tippe auf Erneut prüfen. Falls es bereits läuft, gib in config.json den absoluten Pfad unter opencode.binary an.
Modelle ausgegraut oder keine kostenlosen
„Auf dem Host einrichten“ bedeutet, dass der Provider in OpenCode noch nicht konfiguriert ist. Wenn keine kostenlosen Modelle erscheinen, deaktiviere den „Nur kostenlos“-Filter. Muqun verlangt keine eigenen Gebühren.
Agent möchte das Projekt verlassen
Beim Lesen oder Schreiben außerhalb des Projekts erscheint eine Sicherheitsabfrage mit Pfadangabe. Prüfe den Pfad vor dem Erlauben.
Changes-Button fehlt
Er erscheint nur, wenn das Terminal in einem git-Checkout liegt und das Gateway neu genug ist, um Diffs zu liefern. Vergleich mit der Basis und Verwerfen brauchen Gateway 0.13 oder neuer. Zum Aktualisieren den Installationsbefehl erneut ausführen.
Neueres Gateway erforderlich
Ältere Gateways behalten ihre Terminalfunktion. Für Agent-Kollaboration wird Herdr 0.9.0+ benötigt; die App weist auf das nötige Upgrade hin.
Rechner hinter einem Proxy
Dein Rechner kommuniziert mit den Modellanbietern. Falls ein Proxy für den Internetzugang nötig ist, konfiguriere diesen direkt in OpenCode auf dem Rechner.
Terminal nicht verfügbar
Das Gateway läuft, aber kein Terminal-Backend — tmux ist installiert, aber kein tmux-Server läuft, oder Herdr ist nicht gestartet. Der Bildschirm listet die Backends des Gateways mit ihrem Zustand; starte eines, und das Terminal erscheint von selbst. Agentensitzungen funktionieren währenddessen weiter.
„Dieses Terminal kann ⌃↵ nicht senden“
Das Gateway hat eine Kombination abgelehnt. Unter tmux tmux set -s extended-keys on ausführen, für Strg+Enter zusätzlich tmux set -s extended-keys-format csi-u. Der Hinweis unter der Meldung wiederholt die Erklärung des Gateways.
Eine Agentenkachel sagt Einrichtung nötig oder Update nötig
Führe muqun-gateway agent auf dem Host aus: Es nennt für jeden Agenten den nächsten Schritt. Update nötig heißt, dieses Gateway ist älter als das Protokoll des Agenten — den Installationsbefehl erneut ausführen.
github · issues
Noch Fragen?
Eröffne ein Issue auf GitHub. Jedes Feedback fließt direkt in die Weiterentwicklung ein.
USEFUL REPORT CHECKLIST
Gib die App-Version, die Gateway-Version und die genauen Schritte vor dem Problem an.
PRIVACY GUARANTEE
Datenschutz und sicheres Melden
Der Support benötigt niemals Zugangstokens, vollständige Terminalausgaben, Quellcode oder Kopplungs-QRs. Entferne sensible Daten vor dem Hochladen von Screenshots oder Logs.