The global sessionLa session globale
The session that drives the others: its prompt, the map of your computer, callbacks, fan-out, and what it may and may not do.La session qui pilote les autres : son prompt, la carte de votre ordinateur, les rappels, la répartition, ce qu'elle peut et ne peut pas faire.
The global session is a Claude Code session of its own (Ctrl+G; [global]: folder, model, effort, permission mode). You talk to it in plain words or by voice; it dispatches work to the sub-sessions through its own MCP server and reports back. It is not a separate program: it is a session whose tools are the cluster itself.
La session globale est une session Claude Code à part entière (Ctrl+G ; [global] : dossier, modèle, effort, mode de permission). Vous lui parlez en langage courant ou à la voix ; elle répartit le travail aux sous-sessions avec son propre serveur MCP et vous rend compte. Ce n'est pas un programme séparé : c'est une session dont les outils sont le cluster lui-même.
1. What it hasCe qu'elle a
- A system prompt
~/.config/claude-cluster/global.md, written once and yours to edit (settings Global session > System prompt; it restarts on the same conversation), added to your globalCLAUDE.md. It ends with a compact toolbox: the MCP tools by family and when to use each. Rendering and routing guides come from the binary (rendering.md,routing.md). - The map of your computer
machine.md: you, your OS and hardware, tools and versions, shell aliases (the dangerous ones and the ones replacing a common command), git identity, Claude Code config, containers, SSH hosts and the git repositories of your home folder. Local only; read when a request touches a local project or the system. Note that what it reads is sent to its API provider. - The tools of the MCP server
claude-cluster mcp, allowed without a prompt but bounded (see Security).
- Un prompt système
~/.config/claude-cluster/global.md, écrit une fois et à vous d'éditer (réglages Global session > System prompt ; elle redémarre sur la même conversation), ajouté à votreCLAUDE.mdglobal. Il se termine par une boîte à outils compacte : les outils MCP par famille et quand utiliser chacun. Les guides de rendu et de routage viennent du binaire (rendering.md,routing.md). - La carte de votre ordinateur
machine.md: vous, votre système et matériel, outils et versions, alias de shell (les dangereux et ceux qui remplacent une commande courante), identité git, config de Claude Code, conteneurs, hôtes SSH et dépôts git de votre dossier personnel. Locale ; lue quand une demande touche un projet local ou le système. Ce qu'elle lit est envoyé à son fournisseur d'API. - Les outils du serveur MCP
claude-cluster mcp, autorisés sans demande mais bornés (voir Sécurité).
2. How it works with the othersComment elle travaille avec les autres
- It sends a prompt with
session_send; the answer comes back to it as[reply from <name> (<id>)]when the sub-session is done. It never polls (session_readre-reads a whole context). - Every end of a turn started for it calls it back once: the first prompt of a spawn, a task of the queue, an API error (
[error from ...]), an interrupted turn, an agent that exited, a background task that completes. - Several projects at once: a request touching several projects becomes a group (
session_fanout): a task per project (sessions or folders created for them, up to a patternmatch), a chain (after), a wait it chooses (all,first,count, with a timeout), a failed task tried once more. It is woken once with all the answers and merges them (merge: sessionfor a big merge,tablefor a comparison).[sessions] max_parallelsub-sessions work at once; the rest wait in the task queue. - Between sessions it speaks tersely (
key: valuelines, compact JSON without empty fields), likertk: what you read stays normal.
- Elle envoie un prompt avec
session_send; la réponse lui revient en[reply from <nom> (<id>)]quand la sous-session a fini. Elle n'interroge jamais (session_readrelit un contexte entier). - Chaque fin de tour lancé pour elle la rappelle une fois : le premier prompt d'un spawn, une tâche de la file, une erreur d'API (
[error from ...]), un tour interrompu, un agent qui s'est arrêté, une tâche d'arrière-plan qui se termine. - Plusieurs projets à la fois : une demande qui touche plusieurs projets devient un groupe (
session_fanout) : une tâche par projet (sessions ou dossiers créés pour eux, jusqu'à un motifmatch), un chaînage (after), une attente qu'elle choisit (all,first,count, avec un délai), une tâche en échec retentée une fois. Elle est réveillée une seule fois avec toutes les réponses et les fusionne (merge: sessionpour une grosse fusion,tablepour une comparaison).[sessions] max_parallelsous-sessions travaillent en même temps ; les autres attendent dans la file de tâches. - Entre sessions elle parle sobrement (lignes
clé: valeur, JSON compact sans champs vides), commertk: ce que vous lisez reste normal.
3. What it may and may not doCe qu'elle peut et ne peut pas faire
It can spawn, prompt, interrupt, close, restore, rename, move, describe and categorise sessions, change modes and models within your policy, manage tasks, schedules and jobs, show displays and pins, read and change most settings. It never changes the protected settings, and a few powers are off until you allow them: forking sessions (global_fork), editing a sub-session's conversation (global_edit), rewriting its own system prompt (rewrite_global_prompt), answering the agents' questions for you (global_answers). Autonomy follows its prompt: what you ask explicitly is done without asking again; what it decides alone is proposed first.
Elle peut créer, solliciter, interrompre, fermer, restaurer, renommer, déplacer, décrire et catégoriser des sessions, changer modes et modèles dans les limites de votre politique, gérer tâches, planifications et travaux, montrer affichages et épingles, lire et changer la plupart des réglages. Elle ne change jamais les réglages protégés, et quelques pouvoirs sont coupés tant que vous ne les autorisez pas : forker des sessions (global_fork), éditer la conversation d'une sous-session (global_edit), réécrire son propre prompt système (rewrite_global_prompt), répondre à votre place aux questions des agents (global_answers). L'autonomie suit son prompt : ce que vous demandez explicitement est fait sans redemander ; ce qu'elle décide seule est proposé d'abord.
4. Staying aliveRester en vie
It stays: if its process ends by itself it starts again on its conversation (once a minute at most). Start over (palette) sends every sub-session to the trash, stops the queued tasks and groups, and starts a new conversation, after a yes / no. /clear only starts the context of claude again; the transcript stays. Remote Control (remote on) puts the global session itself on claude.ai and the Claude app, live both ways.
Elle reste : si son processus s'arrête de lui-même il redémarre sur sa conversation (une fois par minute au plus). Start over (palette) envoie toutes les sous-sessions à la corbeille, arrête les tâches et groupes en file, et démarre une nouvelle conversation, après un oui / non. /clear ne repart qu'avec le contexte de claude ; la transcription reste. Remote Control (remote on) met la session globale elle-même sur claude.ai et l'application Claude, en direct dans les deux sens.
5. Its permission modeSon mode de permission
By default it runs in bypassPermissions ([global] permission_mode): it never asks, which is the point of an orchestrator and its risk, because a prompt injected in a sub-session (a web page it read) comes back to it as a reply. Setting auto makes it ask before a command; the MCP tools of claude-cluster stay bounded either way.
Par défaut elle tourne en bypassPermissions ([global] permission_mode) : elle ne demande jamais, ce qui est le but d'un orchestrateur et son risque, car un prompt injecté dans une sous-session (une page web qu'elle a lue) lui revient comme réponse. Régler auto la fait demander avant une commande ; les outils MCP de claude-cluster restent bornés dans les deux cas.