claude-cluster docs1.10.1
Advanced conceptsConcepts avancés

Tasks and schedulesTâches et planifications

The task queue, todo lists and scheduled prompts: options, conditions, the Tasks session and who may do what.La file de tâches, les listes à faire et les prompts planifiés : options, conditions, la session Tasks et qui peut quoi.

1. The Tasks sessionLa session Tasks

☰ Tasks is the first entry of the list (/tasks, palette Tasks): it shows what the sessions do and what waits instead of a conversation.

  • Todo lists of each session (the checklists of its own TodoWrite tools).
  • Task queue: running, waiting, done, failed, cancelled, with who made each task, where it goes and why it was cancelled.
  • Scheduled: reminders and prompts at a time, waiting or run.
  • Jobs: the orchestrator queue, with gauges.

A click on a row opens its actions: start now (past the parallel limit), cancel or delete (a reason is asked and told to the session that made it), archive, open its session. Without the mouse: ↑↓ / j k, Tab, Enter. A closed session loses its waiting tasks and schedules.

☰ Tasks est la première entrée de la liste (/tasks, palette Tasks) : elle montre ce que font les sessions et ce qui attend, à la place d'une conversation.

  • Listes à faire de chaque session (les listes de ses propres outils TodoWrite).
  • File de tâches : en cours, en attente, faites, échouées, annulées, avec qui a créé chaque tâche, où elle va et pourquoi elle a été annulée.
  • Planifié : rappels et prompts à une heure, en attente ou exécutés.
  • Jobs : la file de l'orchestrateur, avec ses jauges.

Un clic sur une ligne ouvre ses actions : démarrer maintenant (au-delà de la limite de parallélisme), annuler ou supprimer (une raison est demandée et dite à la session qui l'a créée), archiver, ouvrir sa session. Sans souris : ↑↓ / j k, Tab, Entrée. Une session fermée perd ses tâches et planifications en attente.

2. TasksTâches

A task is a prompt queued for a session. claude-cluster task add [--target T] [--after t1,t2] <prompt>, task list, task cancel, or the MCP tool task_add. [sessions] max_parallel sub-sessions work at once and task_queue bounds how many wait.

task_add optionWhat it does
after, after_sessionswait for tasks to be done / sessions to be idle
on_eventsession_idle, git_push (a new commit on the remote), command, file (changed); checked in the background. A command is met when it exits 0 (or code) and prints what is asked (stdout exactly, contains, regex), run every N s (constantly = 2 s); fail_after: N gives up after N failures in a row (the task fails, its owner is told)
spawnthe task makes its own session (cwd, name, backend, mode, effort, profile, one_shot)
priority, max_concurrency + lanehigher first; at most N tasks of a lane at once
timeout_minutes, retry, max_cost, max_tokensstopped and reported when exceeded, tried again after an error
expect, notify, replya short answer or a file as the result; a notification at its end; whether the author is told

The answer is kept in the task (result, up to [sessions] task_result_chars) and {{t3.result}} in a prompt is replaced by that of task t3, which then runs first. task_act: cancel, delete, archive, retry, set, force. A task whose target does not exist, or whose dependency failed, fails with its reason, told to its author. Finished tasks are archived after 30 minutes.

Une tâche est un prompt mis en file pour une session. claude-cluster task add [--target T] [--after t1,t2] <prompt>, task list, task cancel, ou l'outil MCP task_add. [sessions] max_parallel sous-sessions travaillent en même temps et task_queue borne combien attendent.

Option de task_addEffet
after, after_sessionsattendre que des tâches soient faites / des sessions inactives
on_eventsession_idle, git_push (un nouveau commit sur le distant), command, file (modifié) ; surveillé en arrière-plan. Une command est remplie quand elle sort à 0 (ou code) et affiche ce qui est demandé (stdout exactement, contains, regex), lancée toutes les every s (constantly = 2 s) ; fail_after: N abandonne après N échecs d'affilée (la tâche échoue, son auteur est prévenu)
spawnla tâche crée sa propre session (cwd, name, backend, mode, effort, profile, one_shot)
priority, max_concurrency + laneles plus hautes d'abord ; au plus N tâches d'une voie à la fois
timeout_minutes, retry, max_cost, max_tokensarrêtée et signalée si dépassé, retentée après une erreur
expect, notify, replyune réponse courte ou un fichier comme résultat ; une notification à sa fin ; si l'auteur est prévenu

La réponse est gardée dans la tâche (result, jusqu'à [sessions] task_result_chars) et {{t3.result}} dans un prompt est remplacé par celle de la tâche t3, qui s'exécute alors d'abord. task_act : cancel, delete, archive, retry, set, force. Une tâche dont la cible n'existe pas, ou dont une dépendance a échoué, échoue avec sa raison, dite à son auteur. Les tâches finies sont archivées après 30 minutes.

3. SchedulesPlanifications

Schedule a prompt by hand, like the scheduled tasks of claude.ai: the palette's Schedule a prompt… or /schedule in any session asks, step by step in a popup (the same in the terminal, the window, the page and the app):

  1. to whom: the global session (the default, first), this session, another one, or a new session started then in a folder;
  2. when: once in some time (2h) or at a time (18:00, 2026-11-02 09:00), every N (30m, 2h, 1d), every day at, every weekday (Monday to Friday) at, every week at (fri 17:00), or a cron rule;
  3. the prompt to send.

A wrong time is refused at its step, before the prompt is typed. The schedule is then listed in the Tasks session (pause, edit, run now, cancel) like any other.

claude-cluster schedule add <when> <text> [--target s] [--every N] [--notify], schedule list, schedule cancel, or schedule_add, schedule_list, schedule_edit, schedule_act.

schedule_add optionWhat it does
when / every / cron / resetonce (+30m, HH:MM, YYYY-MM-DD HH:MM), every N minutes, a cron expression (*/15 9-17 * * mon-fri; 0 and 7 are Sunday, fri-sun is three days), or at each reset of the 5 h / 7 d limit window
days, window, quiet, tzonly on these days, inside / never inside these hours, in this timezone
until, max_runsended after a time or a number of runs
ifsession_idle, command (exits 0, or the code / stdout / contains / regex asked; fail_after: the schedule cancelled after N failures in a row), file_changed, usage (5h>80): not met, the run is skipped
actionprompt (default), notify, spawn, task, command (run locally with no model; only a non-empty output is sent or notified)
ack, nagasked again every nag minutes until acknowledged
dry_runnothing made: tells when it would fire

schedule_act: pause, resume, snooze, ack, trigger (run now), cancel, delete, archive.

Planifier un prompt à la main, comme les tâches planifiées de claude.ai : Schedule a prompt… dans la palette ou /schedule dans n'importe quelle session demande, étape par étape dans une popup (pareil dans le terminal, la fenêtre, la page et l'app) :

  1. à qui : la session globale (par défaut, en premier), cette session, une autre, ou une nouvelle session lancée à ce moment-là dans un dossier ;
  2. quand : une fois dans un délai (2h) ou à une heure (18:00, 2026-11-02 09:00), toutes les N (30m, 2h, 1d), tous les jours à, chaque jour de semaine (lundi au vendredi) à, chaque semaine à (fri 17:00), ou une règle cron ;
  3. le prompt à envoyer.

Une heure invalide est refusée à son étape, avant d'écrire le prompt. La planification apparaît ensuite dans la session Tasks (pause, modifier, lancer maintenant, annuler) comme les autres.

claude-cluster schedule add <quand> <texte> [--target s] [--every N] [--notify], schedule list, schedule cancel, ou schedule_add, schedule_list, schedule_edit, schedule_act.

Option de schedule_addEffet
when / every / cron / resetune fois (+30m, HH:MM, YYYY-MM-DD HH:MM), toutes les N minutes, une expression cron (*/15 9-17 * * mon-fri ; 0 et 7 sont dimanche, fri-sun fait trois jours), ou à chaque remise à zéro de la fenêtre de limite 5 h / 7 j
days, window, quiet, tzseulement ces jours, dans / jamais dans ces heures, dans ce fuseau
until, max_runsterminée après une heure ou un nombre d'exécutions
ifsession_idle, command (sort à 0, ou le code / stdout / contains / regex demandé ; fail_after : la planification annulée après N échecs d'affilée), file_changed, usage (5h>80) : non remplie, l'exécution est sautée
actionprompt (défaut), notify, spawn, task, command (lancée en local sans modèle ; seule une sortie non vide est envoyée ou notifiée)
ack, nagredemandée toutes les nag minutes jusqu'à acquittement
dry_runrien n'est fait : dit quand elle se déclencherait

schedule_act : pause, resume, snooze, ack, trigger (exécuter maintenant), cancel, delete, archive.

4. Who may do whatQui peut quoi

The global session manages everything. A sub-session of the claude driver gets its own small MCP (task_add, task_list, task_cancel, task_act, schedule_*), scoped to the tasks and schedules it made: its task runs for itself after its turn and its result comes back as [tasks] ..., a schedule wakes only itself, and local commands (command actions, if.command, on_event: command) and force are never its own. The [agent] settings: sub_read (on), sub_tasks (on), sub_schedules (off), sub_spawn (off), sub_spawn_cap (2).

La session globale gère tout. Une sous-session du pilote claude reçoit son propre petit MCP (task_add, task_list, task_cancel, task_act, schedule_*), limité aux tâches et planifications qu'elle a créées : sa tâche s'exécute pour elle après son tour et son résultat lui revient en [tasks] ..., une planification ne réveille qu'elle, et les commandes locales (actions command, if.command, on_event: command) et force ne sont jamais les siennes. Les réglages [agent] : sub_read (oui), sub_tasks (oui), sub_schedules (non), sub_spawn (non), sub_spawn_cap (2).