The interfacesLes interfaces
Terminal, window, web page and phone: the same sessions everywhere, in sync.Terminal, fenêtre, page web et téléphone : les mêmes sessions partout, synchronisées.
Every interface is a view of one core (claude-cluster serve --linger, started by the first terminal or window). Several terminals, windows, web pages and phones can be open at once, in sync: the same sessions, prompts, questions and notices ([ui] shared_core, on). Closing one leaves the others; the last one closed stops the core, unless the background service is the core.
Chaque interface est une vue d'un seul cœur (claude-cluster serve --linger, lancé par le premier terminal ou la première fenêtre). Plusieurs terminaux, fenêtres, pages web et téléphones peuvent être ouverts en même temps, synchronisés : mêmes sessions, prompts, questions et notices ([ui] shared_core, activé). En fermer une laisse les autres ; la dernière fermée arrête le cœur, sauf si le service d'arrière-plan est le cœur.
1. TerminalTerminal
claude-cluster in a terminal (or --tty). Built with FTXUI: a list of sessions, the conversation, panels, popups, the mouse (click, drag to select, wheel) and the keys of the keys page.
- Layouts (
F2,--layout):list(list plus active panel) andgrid(every session in a cell; arrows move between cells on an empty prompt,Shift+Enter/Alt+Oopens one). See Layouts. Alt+Gopens the graph view: the global session in the middle, the sessions around it.- The terminal stays in the foreground:
Ctrl+Zis undo in the prompt, never a suspend. - Images in the transcript need
chafaor ImageMagick (magick).
claude-cluster dans un terminal (ou --tty). Construit avec FTXUI : une liste de sessions, la conversation, des panneaux, des fenêtres, la souris (clic, glisser pour sélectionner, molette) et les touches de la page des touches.
- Dispositions (
F2,--layout) :list(liste plus panneau actif) etgrid(chaque session dans une cellule ; les flèches passent d'une cellule à l'autre sur un prompt vide,Shift+Entrée/Alt+Oen ouvre une). Voir Dispositions. Alt+Gouvre la vue graphe : la session globale au milieu, les sessions autour.- Le terminal reste au premier plan :
Ctrl+Zest « annuler » dans le prompt, jamais une suspension. - Les images de la transcription demandent
chafaou ImageMagick (magick).
2. WindowFenêtre
claude-cluster --gui (built when Qt6 Widgets is found): the same features in a native window with tabs, a header per session, dialogs for settings and a hub graph. claude-cluster -g --tty-mode shows the terminal interface inside the window ([ui] gui_mode = tty keeps it). The service opens it when you say the wake phrase.
claude-cluster --gui (compilée quand Qt6 Widgets est trouvé) : les mêmes fonctions dans une fenêtre native avec onglets, un en-tête par session, des dialogues de réglages et un graphe hub. claude-cluster -g --tty-mode montre l'interface terminal dans la fenêtre ([ui] gui_mode = tty le garde). Le service l'ouvre quand vous dites la phrase de réveil.
3. Web pagePage web
Open the web access (settings Web, the palette Web access: open, claude-cluster web on or --web) and a browser on the same network drives claude-cluster: sessions, transcripts, prompts, Stop, permissions and questions, new sessions, settings.
- Views (the same five in the terminal, the window, the page and the app; every start on the list): List, Grid (a tile per session, the Tasks as the last one), Graph (global, then the categories / sub-globals of the taxonomy, then the sessions), Hub (every session around global) and Tree (sessions by folder).
- Getting in: https with a certificate of your own authority (trusted once per device from the login page, no browser warning afterwards), a 6-digit code that changes at each opening, then your approval on the computer (Allow, Allow and trust, Deny). Trusted devices come back by themselves.
- Terminal mode: the ⌨ button runs a real
claude-cluster --ttyfor that device in the browser. - Beyond the LAN:
[web] remote = tailscale(recommended) orrouter. See Security. - Docs: this documentation is served by the core at
/docsand opens in a panel withCtrl+Kthen Docs. Without the web access,claude-cluster docs serve [port] [lan]serves it alone, read only (port 8790, this computer only unlesslan).
By default only private addresses of the subnets of your computer are served, and from the page you cannot open a shell or change the web settings unless you allowed it (see Security).
Ouvrez l'accès web (réglages Web, la palette Web access: open, claude-cluster web on ou --web) et un navigateur du même réseau pilote claude-cluster : sessions, transcriptions, prompts, Stop, permissions et questions, nouvelles sessions, réglages.
- Vues (les mêmes cinq dans le terminal, la fenêtre, la page et l'app ; chaque démarrage sur la liste) : List, Grid (une tuile par session, Tasks en dernier), Graph (global, puis les catégories / sous-globales de la taxonomie, puis les sessions), Hub (toutes les sessions autour de global) et Tree (sessions par dossier).
- Entrer : https avec un certificat de votre propre autorité (approuvée une fois par appareil depuis la page de connexion, plus d'avertissement ensuite), un code à 6 chiffres qui change à chaque ouverture, puis votre accord sur l'ordinateur (Allow, Allow and trust, Deny). Les appareils de confiance reviennent seuls.
- Mode terminal : le bouton ⌨ lance un vrai
claude-cluster --ttypour cet appareil dans le navigateur. - Hors du réseau local :
[web] remote = tailscale(recommandé) ourouter. Voir Sécurité. - Docs : cette documentation est servie par le cœur sur
/docset s'ouvre dans un panneau avecCtrl+Kpuis Docs. Sans l'accès web,claude-cluster docs serve [port] [lan]la sert seule, en lecture seule (port 8790, cet ordinateur seulement sauf aveclan).
Par défaut seules les adresses privées des sous-réseaux de votre ordinateur sont servies, et depuis la page on ne peut ni ouvrir un shell ni changer les réglages web sans l'avoir autorisé (voir Sécurité).
4. PhoneTéléphone
Any phone browser works. On Android the page offers an app (/app.apk): the same page in a thin shell that trusts your computer once, shows the notifications of the desktop, and can use the microphone. See Notifications and the phone app. iPhone: the browser page, with the certificate steps shown on the login page.
Tout navigateur de téléphone convient. Sur Android la page propose une application (/app.apk) : la même page dans une coque légère qui fait confiance à votre ordinateur une fois, affiche les notifications du bureau et peut utiliser le micro. Voir Notifications et application téléphone. iPhone : la page du navigateur, avec les étapes du certificat sur la page de connexion.
5. Simple modeMode simple
claude-cluster --simple (or --ipad-kid) opens a calmer interface in every front end, in English or French ([ui] language); [ui] mode = "simple" keeps it. The home shows what needs you first (questions and permissions answered there), then one card per helper (session) with what it does in plain words, its state and its time; a card opens its conversation with the same prompt as usual (/, ::, @). A New task tile asks the assistant, which decides how to split the work. Its settings have six pages: General (language, look, notifications, back to the classic interface), Account & provider, Assistant (how it splits the work, how smart, what to ask first, helpers at once), Phone (the web access and its QR code), Shortcuts, About (version, docs, all settings). F10 opens the statistics.
claude-cluster --simple (ou --ipad-kid) ouvre une interface plus calme dans chaque interface, en anglais ou en français ([ui] language) ; [ui] mode = "simple" la garde. L'accueil montre d'abord ce qui vous attend (questions et permissions, à répondre sur place), puis une carte par aide (session) avec ce qu'elle fait en mots simples, son état et son temps ; une carte ouvre sa conversation avec le prompt habituel (/, ::, @). Une tuile Nouvelle tâche s'adresse à l'assistant, qui décide comment répartir le travail. Ses réglages ont six pages : Général (langue, apparence, notifications, retour à l'interface classique), Compte & fournisseur, Assistant (comment il répartit le travail, quelle intelligence, quoi demander avant, aides en même temps), Téléphone (l'accès web et son QR code), Raccourcis, À propos (version, documentation, tous les réglages). F10 ouvre les statistiques.
6. SupervisorSuperviseur
claude-cluster --supervisor (or s in the start menu) shows every claude-cluster of this computer at a glance: the main one and each independent instance, running or stopped with sessions kept. Each one shows its version, its sessions counted by state (working, idle, waiting for you, background, queued, errors), its web access and its update; F2 adds the details (every session with its state, queued prompts, agents, ♨, model).
Entera popup of what to do with it (open, update, force, stop, start; the risky ones asked again);u/Uupdate one / all;f/Fforce;s/Sstop / start;wits web access;F9its web settings and devices;Pthe performance of the computer (CPU, RAM, GPU / VRAM, disk);F1the keys;Dits devices (tick, kick, ban, unban, untrust, allow);cor a click copies the code; a mouse drag copies what it selects;q/Ctrl+Cquit.- Faces like a session's (
>_<working,•_• !waits for you,-_-idle,z_zstopped),◆main /◇independent; below, the other agents of the computer (Claude Code, Codex, OpenCode, Qwen, Gemini, Aider, Ollama in their own terminals), a coloured dot for their state; Enter opens one in claude-cluster as a copy. - A device asking to use its web access pops up at once; its web access closes when the supervisor quits (or crashes); stopping a claude-cluster never closes the supervisor.
- It runs a newer binary again by itself as soon as it is installed.
- Its web access is a core of its own on
[web] supervisor_port(8788): the page and the app connected to it show the supervisor (cards, Details, Update / Force / Stop / Start, Update all / Force all) instead of sessions; its actions are accepted from that access only. - The window (
--supervisor -g) shows the same list as a tree with its buttons.
claude-cluster --supervisor (ou s dans le menu de départ) montre d'un coup d'œil chaque claude-cluster de cet ordinateur : le principal et chaque instance indépendante, en marche ou arrêtée avec des sessions gardées. Chacun affiche sa version, ses sessions comptées par état (au travail, inactives, en attente de vous, en arrière-plan, en file, en erreur), son accès web et sa mise à jour ; F2 ajoute le détail (chaque session avec son état, ses prompts en file, ses agents, ♨, son modèle).
Entréeune popup de ce qu'il faut faire (ouvrir, mettre à jour, forcer, arrêter, démarrer ; les risqués redemandés) ;u/Umettre à jour un / tous ;f/Fforcer ;s/Sarrêter / démarrer ;wson accès web ;F9ses réglages web et ses appareils ;Ples performances de l'ordinateur (CPU, RAM, GPU / VRAM, disque) ;F1les touches ;Dses appareils (cocher, expulser, bannir, débannir, ne plus faire confiance, autoriser) ;cou un clic copie le code ; un glisser à la souris copie ce qu'il sélectionne ;q/Ctrl+Cquittent.- Des visages comme ceux des sessions (
>_<au travail,•_• !vous attend,-_-inactif,z_zarrêté),◆principal /◇indépendant ; en dessous, les autres agents de l'ordinateur (Claude Code, Codex, OpenCode, Qwen, Gemini, Aider, Ollama dans leurs propres terminaux), un point coloré pour leur état ; Entrée en ouvre un dans claude-cluster en copie. - Un appareil qui demande l'accès web apparaît aussitôt ; l'accès web se ferme quand le superviseur quitte (ou plante) ; arrêter un claude-cluster ne ferme jamais le superviseur.
- Il relance de lui-même un binaire plus récent dès qu'il est installé.
- Son accès web est un cœur à part sur
[web] supervisor_port(8788) : la page et l'app connectées montrent le superviseur (cartes, Détails, Mettre à jour / Forcer / Arrêter / Démarrer, Tout mettre à jour / Tout forcer) au lieu des sessions ; ses actions ne sont acceptées que depuis cet accès. - La fenêtre (
--supervisor -g) montre la même liste en arbre avec ses boutons.
7. HeadlessSans interface
claude-cluster serve runs the core without any interface. Everything is then driven by the headless commands (list, send, spawn, allow, task, schedule, web... with --rtk for a compact output made for an AI, --json raw) and by the MCP server. See the protocol.
claude-cluster serve lance le cœur sans interface. Tout est alors piloté par les commandes headless (list, send, spawn, allow, task, schedule, web... avec --rtk pour une sortie compacte faite pour une IA, --json brut) et par le serveur MCP. Voir le protocole.