claude-cluster docs1.10.1
ReferenceRéférence

MCP toolsOutils MCP

Every tool of the global session, generated from the code: 79 tools with their parameters.Tous les outils de la session globale, générés depuis le code : 79 outils avec leurs paramètres.

The global session drives claude-cluster through the MCP server claude-cluster mcp. This page is generated from the tool schemas in the sources (Mcp.cpp, Orchestrator-Control.cpp): the names, descriptions and parameters below are exactly what the model is told. Each tool can be turned off in [mcp_tools] (settings page MCP): <tool> = false.

A sub-session of the claude driver has its own small MCP with task_*, schedule_* and the job tools only, limited to what it created.

La session globale pilote claude-cluster par le serveur MCP claude-cluster mcp. Cette page est générée à partir des schémas d'outils des sources (Mcp.cpp, Orchestrator-Control.cpp) : les noms, descriptions et paramètres ci-dessous sont exactement ce que le modèle reçoit. Chaque outil peut être désactivé dans [mcp_tools] (page de réglages MCP) : <outil> = false.

Les descriptions viennent du code et sont donc en anglais, la langue dans laquelle le modèle les lit.

Une sous-session du pilote claude a son propre petit MCP avec seulement task_*, schedule_* et les outils de travaux, limités à ce qu'elle a créé.

1. SessionsSessions

session_list

Every session of the cluster: id, name, project folder, backend, state, category, tags, permission mode, tokens, context, cost, pending permissions. Filters: category, tag (one or several, all required), under (a node of the taxonomy: every session below it), state (open: the live ones, default | archived: the trash | all | working, idle...). A category / tag also matches the sessions under the labels below it in the taxonomy (descendants: false: itself only).

ParameterTypeDescription
categorystringonly this category (and the ones below it in the taxonomy)
tagstringonly the sessions with this tag (several: separated by commas; the tags below each included)
understringevery session under this category / tag node of the taxonomy
descendantsbooleanfalse: category / tag match themselves only, not the labels below them (default true)
statestringopen (default) | archived (the trash) | all | a state: working, idle, waiting...

session_status

Details of one session and its last 20 messages (skills loaded, files modified).

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session

session_read

Same as session_status: the last messages of a session.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session

session_spawn

Start a new session in a project folder. backend: <provider>[/<model>] (claude, ollama/<model>, openai/<model>, opencode/<provider>/<model>, codex...). For a one-off task set one_shot: true, the session is then archived by itself when it is done.

ParameterTypeDescription
cwd (required)stringproject folder (~ allowed), or the name of a project of machine.md (its git repositories: the closest by its name)
namestringname of the session (default: the folder name)
backendstringprovider[/model], default from the config
modestringauto | manual | acceptEdits | plan | dontAsk | bypassPermissions
profilestringprofile of the config
promptstringfirst prompt
replybooleanthe answer to the first prompt (and later wake-up turns) sent back to you as "[reply from ...]" (default true)
one_shotbooleanthis session is for ONE precise task, never to be reused: closed to the trash (restorable) once its answer is relayed to you (needs reply, and the setting Archive one-shot sessions on; kept when the user typed in it, looks at it or it waits for them). Never for the session of a project you will talk to again (default false)
effortstringthinking effort: default | low | medium | high | xhigh | max
contextstringits context at most, compacted past it: 100k to 1M (200k, 500k) or auto (the setting Context at most of the sessions). Size it to the task: a small fix needs far less than a long refactor; every turn and a wake-up after its cache expired cost what it holds

session_send

Send a prompt to a session (queued when it is working). By default (reply: true) its answer comes back to you as a message "[reply from <name> (<id>)] ..." when it is done: go on with something else or end your turn, never poll it with session_read / session_status. A local command of claude-cluster (/clear, /model <m>, /mode <m>, /rename, /cd, /close, /cost, /context, /export...) runs at once, as typed in its prompt (no reply): /clear starts a new conversation for the session.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
text (required)stringthe prompt
replybooleanits answer sent back to you when done (default true)
attachmentsstring[]paths of local files to attach to the prompt (images as pictures, the others as @path): inside the project folder of the session or the home of the user only, no hidden folder; the number is limited by a setting

session_wait

Wait until a session is done (up to timeout seconds, 110 max) and get only its last answer (not its context); its outcome tells how its last turn ended - finished, cancelled (interrupted before it finished), error, closed: only finished is done, never take the others as finished: when you need the answer now to go on. A permission waiting is told.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
timeoutintegerseconds (default 100)

session_allow

Answer a pending permission of a session; a question of its agent (AskUserQuestion, its options in session_status): answers {question text: the label chosen, several joined by ", "} (behavior deny: declined).

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
request_idstringrequest id (empty: the oldest one)
behaviorstringallow | always | deny
answersobjectAskUserQuestion: {question text: answer}

session_set_mode

Permission mode of a session.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
mode (required)stringauto | manual | acceptEdits | plan | dontAsk | bypassPermissions

session_set_model

Model and / or thinking effort of a session (the same conversation goes on); none given: its current ones and the choices of its backend. Under the policy of the user (models_policy): a forbidden one is refused with the reason; a costly one (opus, xhigh...) returns {asked}: the user answers Allow / Deny in their interface and the result comes back to you as a message.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
modelstringa model of its provider (opus, sonnet, claude-opus-5-5, an Ollama model...)
effortstringdefault | low | medium | high | xhigh | max (claude); minimal... (codex, opencode)

session_interrupt

Stop the running turn of a session.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session

session_close

Close a session: it goes to the trash, restorable with session_restore.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session

session_restore

Restore a closed session from the trash (with its conversation).

ParameterTypeDescription
session (required)stringid or name in the trash

session_trash

Closed sessions that can still be restored.

No parameter.

session_purge

Delete for good a session of the trash (its conversation and history), "*" for the whole trash. Irreversible: only when the user asked it.

ParameterTypeDescription
session (required)stringid or name in the trash, or *

session_rename

Rename a session.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
name (required)stringnew name

session_continue

A session goes on where it stopped (interrupted, an error of the API or of the connection): "continue" sent in the same conversation; a turn waiting for a retry of the API: stopped and asked again at once.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session

session_describe

Give a session its short description (a few words: what it works on, holds; shown under its name, the trash too, to find it again), its category (ONE word: bugfix, feature, docs, refactor, research, ops...) and its tags (several short words: the topic, the project, the kind of work), the way to find and group sessions (session_list filters, search "#tag"). Set them when you spawn or route a session and keep them true as its topic moves; reuse the ones already in session_list. A text given: kept; empty: claude-cluster writes it again; no text: untouched. category "" removes it; tags replaces all of them, add_tags / remove_tags change some. The user can edit them too; no model is called.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
textstringa few words, empty: written again; leave out to keep it
categorystringone word, "" removes it
tagsstring[]all its tags (replaces them)
add_tagsstring[]tags to add
remove_tagsstring[]tags to remove

session_cd

Move a session to another project folder (a new conversation there, same name).

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
cwd (required)stringfolder

session_fanout

A request on several sessions / projects at once (a group): a task each, sent as many at once as the parallel sessions allow (the others wait in the task queue); you are woken ONCE with their answers as [group fN ...] to merge them - end your turn after it, never poll. tasks: [{session or cwd, prompt (else the common prompt), after: [indexes of tasks of this group it builds on: their answers given to it]}]; match: {under: folder, has: a file marking a project (default: a git repository), name: part of its name, max} for every project found (its session reused, else created: shown to the user first, then confirmed: true); wait: {mode: all | first | count, count, timeout_minutes (then woken with what came), stop_others (the wait met: the others stopped)}; retry (a failed task tried once more, default true); merge: here (you) | session (a big merge by a session of its own, its answer to you); table: a comparison table asked too.

ParameterTypeDescription
label (required)stringwhat the group does, a few words
promptstringthe common prompt
tasksobject[][{session | cwd, prompt, after: [index]}]
matchobject{under, has, name, max}
waitobject{mode: all | first | count, count, timeout_minutes, stop_others}
retryboolean
mergestringhere | session
tableboolean
confirmedbooleanthe user agreed to the projects found (match)

group_status

The progress of a group (its tasks, their state and answers so far); none: every group of this run.

ParameterTypeDescription
groupstringfN

group_cancel

Stop a group: its tasks not started are cancelled, the running ones interrupted when interrupt is true.

ParameterTypeDescription
group (required)stringfN
interruptboolean

session_fork

A copy of a sub-session of Claude Code: a new sub-session with its conversation so far (its context), each one goes on apart. Only when the user allowed it (settings: Global session can fork).

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
namestringname of the copy

session_import

Open a conversation of another agent (external_conversations) as a sub-session resuming it: its transcript shown, the same conversation goes on here. fork (Claude Code): a copy, the original untouched - use it when it may still be open elsewhere.

ParameterTypeDescription
agent (required)stringclaude | codex | opencode | qwen
id (required)stringits id (a unique prefix is enough)
namestringname of the session
forkbooleana copy (Claude Code)

external_conversations

The conversations of the agents of this computer opened outside claude-cluster (Claude Code, Codex, opencode, Qwen Code): agent, id, title, folder, first prompt, age; the newest first. To open one here: session_import.

ParameterTypeDescription
agentstringclaude | codex | opencode | qwen (empty: all)
limitinteger30 by default

session_context

Give a context to a session as a prompt it keeps for its next requests (it answers "ok"): source = session:<id> (the conversation of another session), <agent>:<id> (a conversation of external_conversations), or a file path.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
source (required)stringsession:<id> | claude:<id> | codex:<id> | qwen:<id> | a file

session_transcript

The transcript of a session, whole entries (not cut like session_read): index, kind (user, assistant, tool, tool_result, system, display), text. from: the first index (negative: from the end, -50 by default), count (50, 500 max).

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
frominteger
countinteger

session_messages

The real conversation of a sub-session of Claude Code (what its model sees): its messages with index, role, text, tools. To rewrite it: session_edit.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session

session_edit

Rewrite the conversation of a sub-session of Claude Code (indexes of session_messages): replace texts, delete messages (a tool call and its result go together), keep only the first N; written as a new conversation (the old one kept), the session started again on it, its transcript shown again. Only when it is idle and the user allowed it (settings: Global session can edit).

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
replaceany[][{index, text}]
deleteany[][index, ...]
keepintegerkeep the first N messages

Full-text search in the history of every session, and in their categories and tags ("#bugfix": the sessions with that category or tag only).

ParameterTypeDescription
text (required)stringtext to find

export

Export the conversation of a session as Markdown (to a file when path is given: a .md / .txt out of the hidden folders).

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
pathstringfile (optional)

taxonomy

The tree of the categories and tags of the sessions: each node (a category or a tag) has an optional parent, none: it hangs under the root "global"; a session hangs under its category, else its first tag. The graph and the grouped list show it nested, session_list filters work on the descendants. action list (default): {parents: {node: parent}, labels: {label: sessions}}; set_parent (node, parent; none or global: the root; a cycle is refused); rename (node, to: also on every session); merge (node, to: the node it joins); delete (node: its children go to its parent; strip: the label also removed from the sessions). Build it as the sessions come: group the tags you reuse (api, ui, db) under one broader node (backend, frontend), not one node per session. Only when the user allowed it (settings: Global session can edit the taxonomy); they edit it by hand too.

ParameterTypeDescription
actionstringdefault list
nodestringthe category / tag to change
parentstringset_parent: its parent node (none or global: under the root)
tostringrename: the new name; merge: the node it joins
stripbooleandelete: also remove the label from the sessions (default false)

session_list

Every session of the cluster: id, name, project folder, backend, state, category, tags, permission mode, tokens, context, cost, pending permissions. Filters: category, tag (one or several, all required), under (a node of the taxonomy: every session below it), state (open: the live ones, default | archived: the trash | all | working, idle...). A category / tag also matches the sessions under the labels below it in the taxonomy (descendants: false: itself only).

ParamètreTypeDescription
categorystringonly this category (and the ones below it in the taxonomy)
tagstringonly the sessions with this tag (several: separated by commas; the tags below each included)
understringevery session under this category / tag node of the taxonomy
descendantsbooleanfalse: category / tag match themselves only, not the labels below them (default true)
statestringopen (default) | archived (the trash) | all | a state: working, idle, waiting...

session_status

Details of one session and its last 20 messages (skills loaded, files modified).

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session

session_read

Same as session_status: the last messages of a session.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session

session_spawn

Start a new session in a project folder. backend: <provider>[/<model>] (claude, ollama/<model>, openai/<model>, opencode/<provider>/<model>, codex...). For a one-off task set one_shot: true, the session is then archived by itself when it is done.

ParamètreTypeDescription
cwd (requis)stringproject folder (~ allowed), or the name of a project of machine.md (its git repositories: the closest by its name)
namestringname of the session (default: the folder name)
backendstringprovider[/model], default from the config
modestringauto | manual | acceptEdits | plan | dontAsk | bypassPermissions
profilestringprofile of the config
promptstringfirst prompt
replybooleanthe answer to the first prompt (and later wake-up turns) sent back to you as "[reply from ...]" (default true)
one_shotbooleanthis session is for ONE precise task, never to be reused: closed to the trash (restorable) once its answer is relayed to you (needs reply, and the setting Archive one-shot sessions on; kept when the user typed in it, looks at it or it waits for them). Never for the session of a project you will talk to again (default false)
effortstringthinking effort: default | low | medium | high | xhigh | max
contextstringits context at most, compacted past it: 100k to 1M (200k, 500k) or auto (the setting Context at most of the sessions). Size it to the task: a small fix needs far less than a long refactor; every turn and a wake-up after its cache expired cost what it holds

session_send

Send a prompt to a session (queued when it is working). By default (reply: true) its answer comes back to you as a message "[reply from <name> (<id>)] ..." when it is done: go on with something else or end your turn, never poll it with session_read / session_status. A local command of claude-cluster (/clear, /model <m>, /mode <m>, /rename, /cd, /close, /cost, /context, /export...) runs at once, as typed in its prompt (no reply): /clear starts a new conversation for the session.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
text (requis)stringthe prompt
replybooleanits answer sent back to you when done (default true)
attachmentsstring[]paths of local files to attach to the prompt (images as pictures, the others as @path): inside the project folder of the session or the home of the user only, no hidden folder; the number is limited by a setting

session_wait

Wait until a session is done (up to timeout seconds, 110 max) and get only its last answer (not its context); its outcome tells how its last turn ended - finished, cancelled (interrupted before it finished), error, closed: only finished is done, never take the others as finished: when you need the answer now to go on. A permission waiting is told.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
timeoutintegerseconds (default 100)

session_allow

Answer a pending permission of a session; a question of its agent (AskUserQuestion, its options in session_status): answers {question text: the label chosen, several joined by ", "} (behavior deny: declined).

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
request_idstringrequest id (empty: the oldest one)
behaviorstringallow | always | deny
answersobjectAskUserQuestion: {question text: answer}

session_set_mode

Permission mode of a session.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
mode (requis)stringauto | manual | acceptEdits | plan | dontAsk | bypassPermissions

session_set_model

Model and / or thinking effort of a session (the same conversation goes on); none given: its current ones and the choices of its backend. Under the policy of the user (models_policy): a forbidden one is refused with the reason; a costly one (opus, xhigh...) returns {asked}: the user answers Allow / Deny in their interface and the result comes back to you as a message.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
modelstringa model of its provider (opus, sonnet, claude-opus-5-5, an Ollama model...)
effortstringdefault | low | medium | high | xhigh | max (claude); minimal... (codex, opencode)

session_interrupt

Stop the running turn of a session.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session

session_close

Close a session: it goes to the trash, restorable with session_restore.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session

session_restore

Restore a closed session from the trash (with its conversation).

ParamètreTypeDescription
session (requis)stringid or name in the trash

session_trash

Closed sessions that can still be restored.

Aucun paramètre.

session_purge

Delete for good a session of the trash (its conversation and history), "*" for the whole trash. Irreversible: only when the user asked it.

ParamètreTypeDescription
session (requis)stringid or name in the trash, or *

session_rename

Rename a session.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
name (requis)stringnew name

session_continue

A session goes on where it stopped (interrupted, an error of the API or of the connection): "continue" sent in the same conversation; a turn waiting for a retry of the API: stopped and asked again at once.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session

session_describe

Give a session its short description (a few words: what it works on, holds; shown under its name, the trash too, to find it again), its category (ONE word: bugfix, feature, docs, refactor, research, ops...) and its tags (several short words: the topic, the project, the kind of work), the way to find and group sessions (session_list filters, search "#tag"). Set them when you spawn or route a session and keep them true as its topic moves; reuse the ones already in session_list. A text given: kept; empty: claude-cluster writes it again; no text: untouched. category "" removes it; tags replaces all of them, add_tags / remove_tags change some. The user can edit them too; no model is called.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
textstringa few words, empty: written again; leave out to keep it
categorystringone word, "" removes it
tagsstring[]all its tags (replaces them)
add_tagsstring[]tags to add
remove_tagsstring[]tags to remove

session_cd

Move a session to another project folder (a new conversation there, same name).

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
cwd (requis)stringfolder

session_fanout

A request on several sessions / projects at once (a group): a task each, sent as many at once as the parallel sessions allow (the others wait in the task queue); you are woken ONCE with their answers as [group fN ...] to merge them - end your turn after it, never poll. tasks: [{session or cwd, prompt (else the common prompt), after: [indexes of tasks of this group it builds on: their answers given to it]}]; match: {under: folder, has: a file marking a project (default: a git repository), name: part of its name, max} for every project found (its session reused, else created: shown to the user first, then confirmed: true); wait: {mode: all | first | count, count, timeout_minutes (then woken with what came), stop_others (the wait met: the others stopped)}; retry (a failed task tried once more, default true); merge: here (you) | session (a big merge by a session of its own, its answer to you); table: a comparison table asked too.

ParamètreTypeDescription
label (requis)stringwhat the group does, a few words
promptstringthe common prompt
tasksobject[][{session | cwd, prompt, after: [index]}]
matchobject{under, has, name, max}
waitobject{mode: all | first | count, count, timeout_minutes, stop_others}
retryboolean
mergestringhere | session
tableboolean
confirmedbooleanthe user agreed to the projects found (match)

group_status

The progress of a group (its tasks, their state and answers so far); none: every group of this run.

ParamètreTypeDescription
groupstringfN

group_cancel

Stop a group: its tasks not started are cancelled, the running ones interrupted when interrupt is true.

ParamètreTypeDescription
group (requis)stringfN
interruptboolean

session_fork

A copy of a sub-session of Claude Code: a new sub-session with its conversation so far (its context), each one goes on apart. Only when the user allowed it (settings: Global session can fork).

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
namestringname of the copy

session_import

Open a conversation of another agent (external_conversations) as a sub-session resuming it: its transcript shown, the same conversation goes on here. fork (Claude Code): a copy, the original untouched - use it when it may still be open elsewhere.

ParamètreTypeDescription
agent (requis)stringclaude | codex | opencode | qwen
id (requis)stringits id (a unique prefix is enough)
namestringname of the session
forkbooleana copy (Claude Code)

external_conversations

The conversations of the agents of this computer opened outside claude-cluster (Claude Code, Codex, opencode, Qwen Code): agent, id, title, folder, first prompt, age; the newest first. To open one here: session_import.

ParamètreTypeDescription
agentstringclaude | codex | opencode | qwen (empty: all)
limitinteger30 by default

session_context

Give a context to a session as a prompt it keeps for its next requests (it answers "ok"): source = session:<id> (the conversation of another session), <agent>:<id> (a conversation of external_conversations), or a file path.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
source (requis)stringsession:<id> | claude:<id> | codex:<id> | qwen:<id> | a file

session_transcript

The transcript of a session, whole entries (not cut like session_read): index, kind (user, assistant, tool, tool_result, system, display), text. from: the first index (negative: from the end, -50 by default), count (50, 500 max).

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
frominteger
countinteger

session_messages

The real conversation of a sub-session of Claude Code (what its model sees): its messages with index, role, text, tools. To rewrite it: session_edit.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session

session_edit

Rewrite the conversation of a sub-session of Claude Code (indexes of session_messages): replace texts, delete messages (a tool call and its result go together), keep only the first N; written as a new conversation (the old one kept), the session started again on it, its transcript shown again. Only when it is idle and the user allowed it (settings: Global session can edit).

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
replaceany[][{index, text}]
deleteany[][index, ...]
keepintegerkeep the first N messages

Full-text search in the history of every session, and in their categories and tags ("#bugfix": the sessions with that category or tag only).

ParamètreTypeDescription
text (requis)stringtext to find

export

Export the conversation of a session as Markdown (to a file when path is given: a .md / .txt out of the hidden folders).

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
pathstringfile (optional)

taxonomy

The tree of the categories and tags of the sessions: each node (a category or a tag) has an optional parent, none: it hangs under the root "global"; a session hangs under its category, else its first tag. The graph and the grouped list show it nested, session_list filters work on the descendants. action list (default): {parents: {node: parent}, labels: {label: sessions}}; set_parent (node, parent; none or global: the root; a cycle is refused); rename (node, to: also on every session); merge (node, to: the node it joins); delete (node: its children go to its parent; strip: the label also removed from the sessions). Build it as the sessions come: group the tags you reuse (api, ui, db) under one broader node (backend, frontend), not one node per session. Only when the user allowed it (settings: Global session can edit the taxonomy); they edit it by hand too.

ParamètreTypeDescription
actionstringdefault list
nodestringthe category / tag to change
parentstringset_parent: its parent node (none or global: under the root)
tostringrename: the new name; merge: the node it joins
stripbooleandelete: also remove the label from the sessions (default false)

2. Tasks, schedules and notificationsTâches, planifications et notifications

task_add

Queue a task for a free session (target = session id / name, a project folder, or empty: any idle one). Runs when its triggers are met (after: task ids; after_sessions: sessions idle; on_event) and a place is free (max_parallel). The result (its answer, capped) stays in task_list; "{{t3.result}}" in a prompt is replaced by the result of t3 (a chain: t3 runs first). A task is cheaper than a session: no new context.

ParameterTypeDescription
prompt (required)stringthe task
targetstringsession or folder (optional)
afterstring[]task ids to finish first
after_sessionsstring[]sessions (id / name) that must be idle first
on_eventobjectwait for {type: session_idle (session) | git_push (repo, branch: a commit pushed) | command (command; met when it exits 0, or code: N; and its output: stdout exactly / contains / regex; every: seconds or 'constantly' (default 30); fail_after: N failures in a row = the task fails and you are told, 1 = the first, 0 = never) | file (path, changed: true = modified, not only present)}
spawnobjectits own session instead of looking for one: {cwd, name, backend, mode, effort, profile, one_shot (closed to the trash after it)}
priorityintegerhigher first (default 0)
timeout_minutesintegerstopped when running longer
retryintegertried again this many times after an error
retry_delay_minutesintegerwait before a new try
max_concurrencyintegerat most this many tasks of its lane running
lanestringthe group max_concurrency counts in
max_costnumberstopped when its session costs more (USD)
max_tokensintegerstopped past this many tokens
expectstringoutput asked: compact, or a file path it writes (the result is then the file)
notifybooleana desktop notification at its end
replybooleanits end told to you as a message (default true)

task_list

Tasks of the queue and their status, result, retries (a failed one: its reason in "error"; the finished ones are archived after 30 minutes: archived: true lists them too).

ParameterTypeDescription
archivedbooleanalso the archived tasks (default false)
statusstringonly this status: queued | running | done | failed | cancelled
idstringone task

task_act

Act on a task: cancel | delete | archive | unarchive | force (started now, past the limit of parallel sessions) | retry (a failed one again) | set (change priority, timeout_minutes, retry, max_cost, max_tokens, notify, prompt of one not ended).

ParameterTypeDescription
id (required)stringtask id (task_list)
action (required)stringcancel | delete | archive | unarchive | force | retry | set
reasonstringwhy (optional)
priorityintegerset
timeout_minutesintegerset
retryintegerset
max_costnumber
max_tokensintegerset
notifybooleanset

task_cancel

Cancel a task.

ParameterTypeDescription
id (required)stringtask id (t1...)

schedule_add

Do something at a time or on a rule, while claude-cluster runs. action: prompt (default: to session, you by default - a wake up / reminder "[scheduled wN] text") | notify (desktop) | spawn (a session, options.cwd, text = its prompt) | task (queue a task with options) | command (options.command run locally, NO model: only its output, when not empty, is sent to session / notified - 0 token). When: when (+30m, HH:MM, YYYY-MM-DD HH:MM) once, every (minutes), cron ("min hour day month weekday"), reset (5h | 7d: at each reset of that limit window); limited by days (mon-fri), window ("09:00-18:00"), quiet ("22:00-07:00"), tz (Europe/Paris), until, max_runs. Condition if: {session_idle, command (exits 0), file_changed, usage: "5h>80" | "7d<30"}; not met: that run is skipped. ack: asked again every nag minutes until schedule_act ack. dry_run: only shows when it would fire.

ParameterTypeDescription
whenstring+30m, +2h, +1d, HH:MM (today, else tomorrow), YYYY-MM-DD HH:MM (in tz)
text (required)stringthe prompt / the notification / the task
actionstringprompt (default) | notify | spawn | task | command
sessionstringthe session of a prompt / of the output (default: g, you)
everyintegerminutes between two (0 / missing: once)
cronstringmin hour day-of-month month weekday: */15 9-17 * * mon-fri
daysstringonly these days: mon-fri, mon,wed, weekdays, weekend
windowstringonly inside: HH:MM-HH:MM[,HH:MM-HH:MM]
quietstringnever inside: HH:MM-HH:MM
tzstringtimezone of the above (default: this computer's)
untilstringended after this time (when's formats)
max_runsintegerended after this many runs
resetstring5h | 7d
ackbooleanasked again until acknowledged
nagintegerminutes between asks (default 10)
ifobject{session_idle, command (+ code, stdout / contains / regex: what it must return; fail_after: failures in a row before the schedule is cancelled), file_changed, usage}
optionsobjectspawn: {cwd, name, backend, mode, effort, profile, one_shot}; task: the options of task_add (target, priority, retry...); command: {command, output: prompt | notify, cwd, timeout_seconds}
dry_runbooleannothing made: the next times it would fire

schedule_list

The schedules: id, status, next time and the next ones, rules, conditions, runs, skipped, last runs (history), note.

ParameterTypeDescription
archivedbooleanalso the archived
idstringone schedule

schedule_edit

Change a schedule not ended: any field of schedule_add (when, text, every, cron, days, window, quiet, tz, until, max_runs, if, options...), pause: true / false.

ParameterTypeDescription
id (required)stringschedule id (w1...)
whenstringa new time
textstring
everyintegerminutes
cronstring
daysstring
windowstring
quietstring
tzstring
untilstring
max_runsinteger
pausebooleanpaused / resumed
ifobject
optionsobject

schedule_act

Act on a schedule: pause | resume | snooze (minutes: pushed back, default 30) | ack (stops the asks of an ack reminder) | trigger (run now, its conditions skipped) | cancel | delete | archive | unarchive.

ParameterTypeDescription
id (required)stringschedule id
action (required)stringpause | resume | snooze | ack | trigger | cancel | delete | archive | unarchive
minutesintegersnooze
reasonstringwhy (optional)

schedule_cancel

Cancel a schedule.

ParameterTypeDescription
id (required)stringschedule id (w1...)

notify

A desktop notification to the user now (something done, something needing them); off when the user turned them off.

ParameterTypeDescription
text (required)stringthe message
titlestringits title (default: claude-cluster)
urgentbooleanstays on screen

task_add

Queue a task for a free session (target = session id / name, a project folder, or empty: any idle one). Runs when its triggers are met (after: task ids; after_sessions: sessions idle; on_event) and a place is free (max_parallel). The result (its answer, capped) stays in task_list; "{{t3.result}}" in a prompt is replaced by the result of t3 (a chain: t3 runs first). A task is cheaper than a session: no new context.

ParamètreTypeDescription
prompt (requis)stringthe task
targetstringsession or folder (optional)
afterstring[]task ids to finish first
after_sessionsstring[]sessions (id / name) that must be idle first
on_eventobjectwait for {type: session_idle (session) | git_push (repo, branch: a commit pushed) | command (command; met when it exits 0, or code: N; and its output: stdout exactly / contains / regex; every: seconds or 'constantly' (default 30); fail_after: N failures in a row = the task fails and you are told, 1 = the first, 0 = never) | file (path, changed: true = modified, not only present)}
spawnobjectits own session instead of looking for one: {cwd, name, backend, mode, effort, profile, one_shot (closed to the trash after it)}
priorityintegerhigher first (default 0)
timeout_minutesintegerstopped when running longer
retryintegertried again this many times after an error
retry_delay_minutesintegerwait before a new try
max_concurrencyintegerat most this many tasks of its lane running
lanestringthe group max_concurrency counts in
max_costnumberstopped when its session costs more (USD)
max_tokensintegerstopped past this many tokens
expectstringoutput asked: compact, or a file path it writes (the result is then the file)
notifybooleana desktop notification at its end
replybooleanits end told to you as a message (default true)

task_list

Tasks of the queue and their status, result, retries (a failed one: its reason in "error"; the finished ones are archived after 30 minutes: archived: true lists them too).

ParamètreTypeDescription
archivedbooleanalso the archived tasks (default false)
statusstringonly this status: queued | running | done | failed | cancelled
idstringone task

task_act

Act on a task: cancel | delete | archive | unarchive | force (started now, past the limit of parallel sessions) | retry (a failed one again) | set (change priority, timeout_minutes, retry, max_cost, max_tokens, notify, prompt of one not ended).

ParamètreTypeDescription
id (requis)stringtask id (task_list)
action (requis)stringcancel | delete | archive | unarchive | force | retry | set
reasonstringwhy (optional)
priorityintegerset
timeout_minutesintegerset
retryintegerset
max_costnumber
max_tokensintegerset
notifybooleanset

task_cancel

Cancel a task.

ParamètreTypeDescription
id (requis)stringtask id (t1...)

schedule_add

Do something at a time or on a rule, while claude-cluster runs. action: prompt (default: to session, you by default - a wake up / reminder "[scheduled wN] text") | notify (desktop) | spawn (a session, options.cwd, text = its prompt) | task (queue a task with options) | command (options.command run locally, NO model: only its output, when not empty, is sent to session / notified - 0 token). When: when (+30m, HH:MM, YYYY-MM-DD HH:MM) once, every (minutes), cron ("min hour day month weekday"), reset (5h | 7d: at each reset of that limit window); limited by days (mon-fri), window ("09:00-18:00"), quiet ("22:00-07:00"), tz (Europe/Paris), until, max_runs. Condition if: {session_idle, command (exits 0), file_changed, usage: "5h>80" | "7d<30"}; not met: that run is skipped. ack: asked again every nag minutes until schedule_act ack. dry_run: only shows when it would fire.

ParamètreTypeDescription
whenstring+30m, +2h, +1d, HH:MM (today, else tomorrow), YYYY-MM-DD HH:MM (in tz)
text (requis)stringthe prompt / the notification / the task
actionstringprompt (default) | notify | spawn | task | command
sessionstringthe session of a prompt / of the output (default: g, you)
everyintegerminutes between two (0 / missing: once)
cronstringmin hour day-of-month month weekday: */15 9-17 * * mon-fri
daysstringonly these days: mon-fri, mon,wed, weekdays, weekend
windowstringonly inside: HH:MM-HH:MM[,HH:MM-HH:MM]
quietstringnever inside: HH:MM-HH:MM
tzstringtimezone of the above (default: this computer's)
untilstringended after this time (when's formats)
max_runsintegerended after this many runs
resetstring5h | 7d
ackbooleanasked again until acknowledged
nagintegerminutes between asks (default 10)
ifobject{session_idle, command (+ code, stdout / contains / regex: what it must return; fail_after: failures in a row before the schedule is cancelled), file_changed, usage}
optionsobjectspawn: {cwd, name, backend, mode, effort, profile, one_shot}; task: the options of task_add (target, priority, retry...); command: {command, output: prompt | notify, cwd, timeout_seconds}
dry_runbooleannothing made: the next times it would fire

schedule_list

The schedules: id, status, next time and the next ones, rules, conditions, runs, skipped, last runs (history), note.

ParamètreTypeDescription
archivedbooleanalso the archived
idstringone schedule

schedule_edit

Change a schedule not ended: any field of schedule_add (when, text, every, cron, days, window, quiet, tz, until, max_runs, if, options...), pause: true / false.

ParamètreTypeDescription
id (requis)stringschedule id (w1...)
whenstringa new time
textstring
everyintegerminutes
cronstring
daysstring
windowstring
quietstring
tzstring
untilstring
max_runsinteger
pausebooleanpaused / resumed
ifobject
optionsobject

schedule_act

Act on a schedule: pause | resume | snooze (minutes: pushed back, default 30) | ack (stops the asks of an ack reminder) | trigger (run now, its conditions skipped) | cancel | delete | archive | unarchive.

ParamètreTypeDescription
id (requis)stringschedule id
action (requis)stringpause | resume | snooze | ack | trigger | cancel | delete | archive | unarchive
minutesintegersnooze
reasonstringwhy (optional)

schedule_cancel

Cancel a schedule.

ParamètreTypeDescription
id (requis)stringschedule id (w1...)

notify

A desktop notification to the user now (something done, something needing them); off when the user turned them off.

ParamètreTypeDescription
text (requis)stringthe message
titlestringits title (default: claude-cluster)
urgentbooleanstays on screen

3. Displays and pinsAffichages et épingles

session_display

Show something in the transcript of a session (any sub-session, or g: yours) without a prompt: its agent never sees it, the user does (terminal, window, web page). display = {type, title?, ...}: (the catalogue of display types: see Rich displays). Or only text (markdown). For the user: a summary table, a chart of numbers, a diagram of an architecture, an image file, a drawing (SVG), a callout, a progress bar.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
displayobject{type, ...}
textstringmarkdown (when no display)
titlestringits title

session_display_update

Replace a display you put (its id, given back by session_display): the steps of a long work, a progress, a checklist, a table that changes. The user sees it change in place.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
id (required)stringits id
display (required)object{type, ...}

session_display_get

A display of a session as it is now: the items the user ticked (checklist), the buttons clicked (actions), the values sent (form, they also come to you as a message).

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
id (required)stringits id

session_pin

Pin something at the bottom of the view of a session (above its prompt, always visible whatever the scroll; one pin per session, a new one replaces it): a task list / checklist / steps / form the user needs to keep seeing, a table, a note. A live display stays live while pinned (session_display_update). Give display (the id of a display, or a block {type, ...} put in the transcript and pinned at once) or index (an entry of session_transcript: a display or a message). Only when the user allowed it (settings: Global session can pin); they can unpin by hand.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
displayanyid of a display (session_display), or a block {type, ...}
indexintegeran entry of the transcript (negative: from the end)
titlestringits title

session_unpin

Remove the pin of a session (its item stays in the transcript).

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session

session_pin_get

What is pinned on a session: {kind, id, title, by}, or nothing.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session

session_display

Show something in the transcript of a session (any sub-session, or g: yours) without a prompt: its agent never sees it, the user does (terminal, window, web page). display = {type, title?, ...}: (the catalogue of display types: see Rich displays). Or only text (markdown). For the user: a summary table, a chart of numbers, a diagram of an architecture, an image file, a drawing (SVG), a callout, a progress bar.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
displayobject{type, ...}
textstringmarkdown (when no display)
titlestringits title

session_display_update

Replace a display you put (its id, given back by session_display): the steps of a long work, a progress, a checklist, a table that changes. The user sees it change in place.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
id (requis)stringits id
display (requis)object{type, ...}

session_display_get

A display of a session as it is now: the items the user ticked (checklist), the buttons clicked (actions), the values sent (form, they also come to you as a message).

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
id (requis)stringits id

session_pin

Pin something at the bottom of the view of a session (above its prompt, always visible whatever the scroll; one pin per session, a new one replaces it): a task list / checklist / steps / form the user needs to keep seeing, a table, a note. A live display stays live while pinned (session_display_update). Give display (the id of a display, or a block {type, ...} put in the transcript and pinned at once) or index (an entry of session_transcript: a display or a message). Only when the user allowed it (settings: Global session can pin); they can unpin by hand.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
displayanyid of a display (session_display), or a block {type, ...}
indexintegeran entry of the transcript (negative: from the end)
titlestringits title

session_unpin

Remove the pin of a session (its item stays in the transcript).

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session

session_pin_get

What is pinned on a session: {kind, id, title, by}, or nothing.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session

4. Orchestrator and heavy jobsOrchestrateur et travaux lourds

heavy_run

Run a HEAVY command (a build, the tests, a container / media job, a local model) through the resource orchestrator of this computer: it waits in the queue for a free slot, then runs in the low profile (nice, ionice, the parallelism lowered to the share granted), and its result comes back HERE: finished (exit code, duration, tail of its output), failed, killed (by whom), or - when it waits or runs longer than the timeout - waiting (position, ETA, what it waits for) / running: then go on with something else and ask job_status (cheap) or job_wait, never poll in a loop. Use it instead of running heavy commands yourself, or cluster-run -- <cmd> in your own shell. Light commands (ls, grep, git status...) never go through it.

ParameterTypeDescription
command (required)stringthe shell command
classstringbuild | tests | container | gpu | custom (default: guessed from the command)
priointeger-10..10, higher first (default 0)
namestringa short name shown in the queue
cwdstringfolder it runs in (default: the one of claude-cluster)
timeout_minutesintegerkilled when it runs longer
ram_mbintegermemory it needs, when not the usual of its class
timeoutintegerseconds to wait here (default 100, 110 max): then the job is told waiting / running and goes on, follow it with job_status / job_wait

jobs_add

Queue a heavy command WITHOUT waiting for it: you get its id and position at once, and are woken up with a message [job jN finished|failed|killed] (exit code, duration, tail of the output; killed: by whom) when it ends, so end your turn instead of polling. Same queue and low profile as heavy_run.

ParameterTypeDescription
command (required)stringthe shell command
classstringbuild | tests | container | gpu | custom (default: guessed from the command)
priointeger-10..10, higher first (default 0)
namestringa short name shown in the queue
cwdstringfolder it runs in (default: the one of claude-cluster)
timeout_minutesintegerkilled when it runs longer
ram_mbintegermemory it needs, when not the usual of its class
callbackbooleanyou are woken up with a message [job jN ...] (exit code, duration, tail) when it ends or is killed (default true)
sessionstringthe session the job belongs to and to wake up (global session only; default: you)

jobs_list

The jobs of the orchestrator: running, waiting (position, what they wait for), stopped; state all adds the finished ones. A sub-session sees its own jobs (the user's settings may show it the others).

ParameterTypeDescription
statestringactive (default: running, waiting, stopped) | all | waiting | running | stopped | finished | failed | killed
sessionstringonly this session (the global session)

job_status

One job, cheap: its state - finished (exit code, duration, tail), killed (by whom: user / global / pressure / archived), failed, waiting (position, ETA, what it waits for), running, stopped (partial: stopped by the user or the pressure of the computer, resumed later) - and the end of its output.

ParameterTypeDescription
id (required)stringjob id (j3)

job_wait

Wait for a job to end (up to timeout seconds, 110 max) and get the same answer as job_status; when it is still waiting / running, wait again or end your turn (a job added by jobs_add wakes you up).

ParameterTypeDescription
id (required)stringjob id (j3)
timeoutintegerseconds (default 100)

job_kill

Kill a job: removed from the queue when it waits, its process group terminated when it runs. The owner is told who did it.

ParameterTypeDescription
id (required)stringjob id (j3)
reasonstringwhy

job_stop

Stop a running job (SIGSTOP of its process group: it keeps its memory, uses no CPU) until job_resume; its slot is free for the next one.

ParameterTypeDescription
id (required)stringjob id (j3)

job_resume

Resume a stopped job (by you, or by the pressure of the computer).

ParameterTypeDescription
id (required)stringjob id (j3)

job_prio

Change the priority of a job (-10..10, higher first): it passes the others in the queue.

ParameterTypeDescription
id (required)stringjob id (j3)
prio (required)integer-10..10

hardware_scan

Scan this computer again (cores / threads, RAM, swap, disk, GPU, power, temperature), saved with the version of the scan; also tells the live load, memory, swap and pressure the limits of the orchestrator follow.

No parameter.

orchestrator_config

The settings of the orchestrator ([orchestrator]: profile low | normal | max, max_jobs, max_per_session, reserved CPU / RAM, threads per job, per class limits, thresholds, session priorities / quotas, what a sub-session may do) with the limits they give now. action get (default) | set (key, value) | enable | disable.

ParameterTypeDescription
actionstringget | set | enable | disable
keystringa key of [orchestrator] (get lists them)
valuestringits new value

heavy_run

Run a HEAVY command (a build, the tests, a container / media job, a local model) through the resource orchestrator of this computer: it waits in the queue for a free slot, then runs in the low profile (nice, ionice, the parallelism lowered to the share granted), and its result comes back HERE: finished (exit code, duration, tail of its output), failed, killed (by whom), or - when it waits or runs longer than the timeout - waiting (position, ETA, what it waits for) / running: then go on with something else and ask job_status (cheap) or job_wait, never poll in a loop. Use it instead of running heavy commands yourself, or cluster-run -- <cmd> in your own shell. Light commands (ls, grep, git status...) never go through it.

ParamètreTypeDescription
command (requis)stringthe shell command
classstringbuild | tests | container | gpu | custom (default: guessed from the command)
priointeger-10..10, higher first (default 0)
namestringa short name shown in the queue
cwdstringfolder it runs in (default: the one of claude-cluster)
timeout_minutesintegerkilled when it runs longer
ram_mbintegermemory it needs, when not the usual of its class
timeoutintegerseconds to wait here (default 100, 110 max): then the job is told waiting / running and goes on, follow it with job_status / job_wait

jobs_add

Queue a heavy command WITHOUT waiting for it: you get its id and position at once, and are woken up with a message [job jN finished|failed|killed] (exit code, duration, tail of the output; killed: by whom) when it ends, so end your turn instead of polling. Same queue and low profile as heavy_run.

ParamètreTypeDescription
command (requis)stringthe shell command
classstringbuild | tests | container | gpu | custom (default: guessed from the command)
priointeger-10..10, higher first (default 0)
namestringa short name shown in the queue
cwdstringfolder it runs in (default: the one of claude-cluster)
timeout_minutesintegerkilled when it runs longer
ram_mbintegermemory it needs, when not the usual of its class
callbackbooleanyou are woken up with a message [job jN ...] (exit code, duration, tail) when it ends or is killed (default true)
sessionstringthe session the job belongs to and to wake up (global session only; default: you)

jobs_list

The jobs of the orchestrator: running, waiting (position, what they wait for), stopped; state all adds the finished ones. A sub-session sees its own jobs (the user's settings may show it the others).

ParamètreTypeDescription
statestringactive (default: running, waiting, stopped) | all | waiting | running | stopped | finished | failed | killed
sessionstringonly this session (the global session)

job_status

One job, cheap: its state - finished (exit code, duration, tail), killed (by whom: user / global / pressure / archived), failed, waiting (position, ETA, what it waits for), running, stopped (partial: stopped by the user or the pressure of the computer, resumed later) - and the end of its output.

ParamètreTypeDescription
id (requis)stringjob id (j3)

job_wait

Wait for a job to end (up to timeout seconds, 110 max) and get the same answer as job_status; when it is still waiting / running, wait again or end your turn (a job added by jobs_add wakes you up).

ParamètreTypeDescription
id (requis)stringjob id (j3)
timeoutintegerseconds (default 100)

job_kill

Kill a job: removed from the queue when it waits, its process group terminated when it runs. The owner is told who did it.

ParamètreTypeDescription
id (requis)stringjob id (j3)
reasonstringwhy

job_stop

Stop a running job (SIGSTOP of its process group: it keeps its memory, uses no CPU) until job_resume; its slot is free for the next one.

ParamètreTypeDescription
id (requis)stringjob id (j3)

job_resume

Resume a stopped job (by you, or by the pressure of the computer).

ParamètreTypeDescription
id (requis)stringjob id (j3)

job_prio

Change the priority of a job (-10..10, higher first): it passes the others in the queue.

ParamètreTypeDescription
id (requis)stringjob id (j3)
prio (requis)integer-10..10

hardware_scan

Scan this computer again (cores / threads, RAM, swap, disk, GPU, power, temperature), saved with the version of the scan; also tells the live load, memory, swap and pressure the limits of the orchestrator follow.

Aucun paramètre.

orchestrator_config

The settings of the orchestrator ([orchestrator]: profile low | normal | max, max_jobs, max_per_session, reserved CPU / RAM, threads per job, per class limits, thresholds, session priorities / quotas, what a sub-session may do) with the limits they give now. action get (default) | set (key, value) | enable | disable.

ParamètreTypeDescription
actionstringget | set | enable | disable
keystringa key of [orchestrator] (get lists them)
valuestringits new value

5. InterfaceInterface

ui_state

What the interface of claude-cluster shows: the session shown, the layout, the style, Remote Control, vim; the choices.

No parameter.

ui_focus

Show a session in the interface (a sub-session, or g: you again), while you go on talking.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session

ui_layout

Layout of the interface: list (the list + one session), grid (every session at once), tabs (window / web page only: the terminal shows the list).

ParameterTypeDescription
layout (required)stringlist | grid | tabs

ui_style

Colors of the interface (ui_state: the styles).

ParameterTypeDescription
style (required)stringa style name

ui_panel

Show / hide a panel of a session: skills, tokens, context, cost, git, diff, tools, files.

ParameterTypeDescription
session (required)stringid (s1, g) or name of the session
panel (required)stringskills | tokens | context | cost | git | diff | tools | files

ui_state

What the interface of claude-cluster shows: the session shown, the layout, the style, Remote Control, vim; the choices.

Aucun paramètre.

ui_focus

Show a session in the interface (a sub-session, or g: you again), while you go on talking.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session

ui_layout

Layout of the interface: list (the list + one session), grid (every session at once), tabs (window / web page only: the terminal shows the list).

ParamètreTypeDescription
layout (requis)stringlist | grid | tabs

ui_style

Colors of the interface (ui_state: the styles).

ParamètreTypeDescription
style (requis)stringa style name

ui_panel

Show / hide a panel of a session: skills, tokens, context, cost, git, diff, tools, files.

ParamètreTypeDescription
session (requis)stringid (s1, g) or name of the session
panel (requis)stringskills | tokens | context | cost | git | diff | tools | files

6. Settings, policy and the computerRéglages, politique et ordinateur

settings_get

The settings of claude-cluster (the settings page): section, key, value, choices, help. section: one section only.

ParameterTypeDescription
sectionstringui | agent | commands | global | sessions | voice | service (optional)

settings_set

Change one setting of claude-cluster (written in its config.toml, applied live except the ones marked at_next_start).

ParameterTypeDescription
section (required)stringsection of the option
key (required)stringits key (settings_get)
value (required)stringthe new value (true / false, a number, a choice, a text)
confirmedstring"true" only when the user explicitly asked for this value: a dangerous one is refused without it - ask the user first. The protected ones (a shell or the web open wider, the permissions of the agents, the programs run, the MCP servers and tools) are refused anyway: the user changes them in the settings page

config_files

The editable files of claude-cluster: your own system prompt, the one of the sub-sessions, the vocabulary and the words of the voice, config.toml, the map of this computer (read only); their path, what they hold, when a change is taken.

No parameter.

config_read

The content of one of them (config_files).

ParameterTypeDescription
name (required)stringglobal_prompt | sessions_prompt | vocabulary | voice_words | config | machine_map

config_write

Replace one of them with this content: read it first (config_read) and keep what the user did not ask to change. config is checked (TOML) before it is written, its protected settings stay the user's; the system prompts only when the user allowed it (settings: Global session can rewrite its own system prompt / the system prompt of the sub-sessions, one each), else give them the text; your own system prompt: you are started again on it after this turn.

ParameterTypeDescription
name (required)stringglobal_prompt | sessions_prompt | vocabulary | voice_words | config
content (required)stringthe whole new content

cluster_info

Everything about this claude-cluster in one call, instead of searching its files: version, binary, the paths of its files (config, logs, history, usage, prompts, vocabulary, voice words, map of this computer), the global session, the agents and their commands, the voice (speech model, models installed, what is missing), the service, the interface, counts.

No parameter.

models_policy

The model / thinking policy of the user: the default model and effort, whether they are advised or forced, the allowed ones, the costly ones (the user is asked first), and the model of the global session. Read it before choosing the model of a sub-session.

No parameter.

work_method

The work method of the user (how they like the work organised: a task list then a review repeated until good, one task at a time, plan first, free): read it (default) to split the requests accordingly. Only the user changes the setting. Detection (when the user turned it on; a spawn result tells work_method_due): action sample = counts and a few of their prompts read from the transcripts (no model; cheap, once), then action propose (preset, text, reason in one sentence) ONLY when their habits clearly differ from the current method - the user answers Allow / Deny in a popup, the answer comes back to you as a message; never apply or repeat a refused one.

ParameterTypeDescription
actionstringread (default) | sample | propose
presetstringpropose: free | list-review | one-task | plan-first | custom
textstringpropose: the user's words added to the preset (short; alone with custom)
reasonstringpropose: why, one sentence shown to the user
maxintegersample: prompts shown (10, 20 at most)

usage

Tokens and cost used per vendor (anthropic, ollama, openai...) over every session: today, the last 7 days, lifetime; the 5 h / 7 d limits left when the vendor tells them.

ParameterTypeDescription
vendorstringone vendor (empty: all)

providers

Providers / backends and whether they are ready (logged in, key stored, server up).

No parameter.

voice_engines

The engines of the voice: speech to text ([voice] listen_model) and text to speech ([voice] say_engine), local or free-tier APIs: what each one handles (languages), its strengths and limits against the others, its free use, its voices, its links, ready (installed / API key stored), used. To change one: settings_set; a key: the user runs claude-cluster auth login <provider>.

No parameter.

web_access

The web access of claude-cluster on this LAN (a browser of the same network drives it after a 6-digit code, one at a time): its address, code and the browser connected; action on / off (this run), kick (the browser out, a new code), pin (a new code). Give the user the address and the code when they ask to open it.

ParameterTypeDescription
actionstringempty: the state only

remote_control

Remote Control of the global session (you): on, the user can go on with you from claude.ai / the Claude app (live both ways); off.

ParameterTypeDescription
on (required)booleantrue: on, false: off

machine_sync

Ask the user to map this computer again (when asked to, or the map is clearly outdated): its question is shown in the interface (yes / no), the scan then runs as started by hand.

No parameter.

docs

The documentation of claude-cluster itself (its sessions, tools, settings, keys, interfaces, security), embedded in the program: action search (default) finds the pages, settings, tools and keys that answer a question (typos are tolerated); page gives the page of a screen of the app or a page name; open shows it to the user in their browser. Use it to answer a question about how claude-cluster works instead of guessing.

ParameterTypeDescription
actionstringsearch (default) | page | open
querystringwhat to look for (search)
pagestringa page (settings, orchestrator, taxonomy...) or a screen of the app (settings, question, graph...) (page, open)
langstringen (default) | fr

settings_get

The settings of claude-cluster (the settings page): section, key, value, choices, help. section: one section only.

ParamètreTypeDescription
sectionstringui | agent | commands | global | sessions | voice | service (optional)

settings_set

Change one setting of claude-cluster (written in its config.toml, applied live except the ones marked at_next_start).

ParamètreTypeDescription
section (requis)stringsection of the option
key (requis)stringits key (settings_get)
value (requis)stringthe new value (true / false, a number, a choice, a text)
confirmedstring"true" only when the user explicitly asked for this value: a dangerous one is refused without it - ask the user first. The protected ones (a shell or the web open wider, the permissions of the agents, the programs run, the MCP servers and tools) are refused anyway: the user changes them in the settings page

config_files

The editable files of claude-cluster: your own system prompt, the one of the sub-sessions, the vocabulary and the words of the voice, config.toml, the map of this computer (read only); their path, what they hold, when a change is taken.

Aucun paramètre.

config_read

The content of one of them (config_files).

ParamètreTypeDescription
name (requis)stringglobal_prompt | sessions_prompt | vocabulary | voice_words | config | machine_map

config_write

Replace one of them with this content: read it first (config_read) and keep what the user did not ask to change. config is checked (TOML) before it is written, its protected settings stay the user's; the system prompts only when the user allowed it (settings: Global session can rewrite its own system prompt / the system prompt of the sub-sessions, one each), else give them the text; your own system prompt: you are started again on it after this turn.

ParamètreTypeDescription
name (requis)stringglobal_prompt | sessions_prompt | vocabulary | voice_words | config
content (requis)stringthe whole new content

cluster_info

Everything about this claude-cluster in one call, instead of searching its files: version, binary, the paths of its files (config, logs, history, usage, prompts, vocabulary, voice words, map of this computer), the global session, the agents and their commands, the voice (speech model, models installed, what is missing), the service, the interface, counts.

Aucun paramètre.

models_policy

The model / thinking policy of the user: the default model and effort, whether they are advised or forced, the allowed ones, the costly ones (the user is asked first), and the model of the global session. Read it before choosing the model of a sub-session.

Aucun paramètre.

work_method

The work method of the user (how they like the work organised: a task list then a review repeated until good, one task at a time, plan first, free): read it (default) to split the requests accordingly. Only the user changes the setting. Detection (when the user turned it on; a spawn result tells work_method_due): action sample = counts and a few of their prompts read from the transcripts (no model; cheap, once), then action propose (preset, text, reason in one sentence) ONLY when their habits clearly differ from the current method - the user answers Allow / Deny in a popup, the answer comes back to you as a message; never apply or repeat a refused one.

ParamètreTypeDescription
actionstringread (default) | sample | propose
presetstringpropose: free | list-review | one-task | plan-first | custom
textstringpropose: the user's words added to the preset (short; alone with custom)
reasonstringpropose: why, one sentence shown to the user
maxintegersample: prompts shown (10, 20 at most)

usage

Tokens and cost used per vendor (anthropic, ollama, openai...) over every session: today, the last 7 days, lifetime; the 5 h / 7 d limits left when the vendor tells them.

ParamètreTypeDescription
vendorstringone vendor (empty: all)

providers

Providers / backends and whether they are ready (logged in, key stored, server up).

Aucun paramètre.

voice_engines

The engines of the voice: speech to text ([voice] listen_model) and text to speech ([voice] say_engine), local or free-tier APIs: what each one handles (languages), its strengths and limits against the others, its free use, its voices, its links, ready (installed / API key stored), used. To change one: settings_set; a key: the user runs claude-cluster auth login <provider>.

Aucun paramètre.

web_access

The web access of claude-cluster on this LAN (a browser of the same network drives it after a 6-digit code, one at a time): its address, code and the browser connected; action on / off (this run), kick (the browser out, a new code), pin (a new code). Give the user the address and the code when they ask to open it.

ParamètreTypeDescription
actionstringempty: the state only

remote_control

Remote Control of the global session (you): on, the user can go on with you from claude.ai / the Claude app (live both ways); off.

ParamètreTypeDescription
on (requis)booleantrue: on, false: off

machine_sync

Ask the user to map this computer again (when asked to, or the map is clearly outdated): its question is shown in the interface (yes / no), the scan then runs as started by hand.

Aucun paramètre.

docs

The documentation of claude-cluster itself (its sessions, tools, settings, keys, interfaces, security), embedded in the program: action search (default) finds the pages, settings, tools and keys that answer a question (typos are tolerated); page gives the page of a screen of the app or a page name; open shows it to the user in their browser. Use it to answer a question about how claude-cluster works instead of guessing.

ParamètreTypeDescription
actionstringsearch (default) | page | open
querystringwhat to look for (search)
pagestringa page (settings, orchestrator, taxonomy...) or a screen of the app (settings, question, graph...) (page, open)
langstringen (default) | fr

7. Other toolsAutres outils

report_status

A sub-session tells whoever follows it (the global session, the session whose task it runs) something now, without ending its turn: "[status from <name> (<id>)] text". Your final message reaches them by itself: this is only for what cannot wait for it. One every 30 s, each one costs them a turn.

report_status

A sub-session tells whoever follows it (the global session, the session whose task it runs) something now, without ending its turn: "[status from <name> (<id>)] text". Your final message reaches them by itself: this is only for what cannot wait for it. One every 30 s, each one costs them a turn.