@ricsam/r5dctl 0.0.104 → 0.0.106

package/README.md

@@ -57,14 +57,14 @@ r5dctl -p <project> get branches
 r5dctl -p <project> describe branch <branch>
 r5dctl -p <project> create branch <branch> --source worktree:<branch> [--working-tree carry|clean] [--worker <label>]
 r5dctl -p <project> describe branch-operation <operation-id>
-r5dctl -p <project> delete branch <branch>              # preview the sessions that would be deleted, exit 1
-r5dctl -p <project> delete branch <branch> --confirm    # delete the branch and its sessions through the platform
+r5dctl -p <project> delete branch <branch> [<branch>...]            # preview the sessions that would be deleted, exit 1
+r5dctl -p <project> delete branch <branch> [<branch>...] --confirm  # delete the branches and their sessions through the platform
 r5dctl -p <project> get envs
 r5dctl -p <project> get envs --show-values
 r5dctl -p <project> get env API_KEY
 r5dctl -p <project> set envs --from-env-file ~/.env --only-missing
 r5dctl -p <project> set envs -e API_KEY=value --description "API credential"
-r5dctl -p <project> get sessions --branch <branch>
+r5dctl -p <project> get sessions --branch <branch>              # each session's live state and last activity
 r5dctl -p <project> create session -b <branch> --name "Spec session"
 r5dctl describe session <session-id>
 r5dctl -s <session-id> update session --name "Renamed session"
@@ -125,12 +125,16 @@ pull requests.
 
 `create branch` creates a linked worktree branch through the platform from an existing branch's checkout, with the same `--source worktree:<branch>` and `--working-tree carry|clean` semantics as `session start --new-worktree` (carry is the default) and no session prompt. `--worker <label>` selects the connected worker that cuts the checkout; omitted, the platform chooses one, and an r5d worker shell's temporary credential is always bound to its own worker. The command returns as soon as the operation is accepted and prints its id; `describe branch-operation <operation-id>` reports `provisioning`, `ready`, or `failed` with the worker and any error. Neither prints a commit hash: read the branch with git in its checkout once it is ready.
 
-`delete branch` removes a branch and every session on it through the platform, which is the only supported way to remove a linked worktree: the platform owns those checkouts, so never run `git worktree remove`, `git worktree prune`, or `git branch -D` inside a project checkout. Without `--confirm` it prints the branch and its sessions and exits non-zero without deleting anything. The primary branch `main` is refused, as is a branch with a running agent or active process (stop them first). On a server that predates the route, the command explains that the server does not support `delete branch` yet instead of reporting a missing branch.
+`delete branch` removes one or more branches and every session on them through the platform, which is the only supported way to remove a linked worktree: the platform owns those checkouts, so never run `git worktree remove`, `git worktree prune`, or `git branch -D` inside a project checkout. Without `--confirm` it prints each branch and its sessions and exits non-zero without deleting anything. With `--confirm` the branches are deleted one after another, each prints its own result line, a failure does not stop the remaining deletions, and the exit status is non-zero if any branch failed. The primary branch `main` is refused before anything is deleted, as is a branch with a running agent or active process (stop them first). A worker that is still applying a configuration refresh makes a deletion wait on the server for up to 45 seconds; if the refresh is still running after that, the result line says so and the branch can be retried. On a server that predates the route, the command explains that the server does not support `delete branch` yet instead of reporting a missing branch.
 
 `get branches` lists every branch the project knows about, including managed branches without sessions. A worker whose workspace sync found a configured branch's checkout directory missing, or present but not a linked worktree of the project, skips that branch and reports it; the listing then shows `checkout=missing on <worker>` or `checkout=not_a_worktree on <worker>`, and `workspace status` prints a `Missing checkouts on <worker>` line. Recover either by deleting the branch with `delete branch <branch> --confirm` or by reconnecting that worker, which recreates the checkout without snapshotting the project's other checkouts.
 
 `session start` creates an ordinary agent-mode chat on an explicitly selected existing worktree, or creates a named linked worktree from an explicit `worktree:<branch>` source. A new worktree is cut from the source branch's current commit; `--working-tree carry` (the default, `git switch -c` semantics) also copies the source checkout's uncommitted changes into it, while `--working-tree clean` checks out that commit only. The new session's first message states which mode applies, and the start output prints `Source` and `Working tree` lines. A clean request fails with a clear error when the selected worker predates the option, because such a worker would silently carry instead. It requires project, worker, model, and prompt and never infers them from the current shell. Start returns a durable `provisioning` handle immediately; workspace synchronization, linked-worktree creation, and prompt enqueue continue in the background and are visible through `session status`. Idempotent request retries return the same handle. Prompts return after durable enqueue. Task specialization belongs in the prompt; there are no predefined debug, explore, research, or test agents. `session stop` returns as soon as the agent run is stopped; the stopped worktree's workspace Git synchronization finishes asynchronously behind the response.
 
+`get sessions` lists a project's sessions, newest first, and appends each session's live state (`running`, `stopping`, `paused`, `provisioning`, `queued`, or `idle`) and how long ago its conversation last advanced (`running, last active 12s ago`). Several sessions can work in the same branch checkout at once (task chips, shared-mode sub-agents, sessions the user starts), so run it with `--branch` before relying on a working tree or reviewing what changed in it. A server that predates the fields prints the id, branch, and name only.
+
+`session stop` also stops every sub-agent session the stopped session started, directly or through its own children, and `session status` prints `Child sessions: <active> active of <total>` for a session that launched sub-agents.
+
 `session status` reports the run lifecycle and the launch-time `Source` and `Working tree` facts only. It deliberately prints no commit hash for the worktree, not even the launch baseline: a hash would be stale by the time a caller acts on it, because commits can land between the read and the action. Find the base and the branch's commits with git in the worker checkout instead, for example `git merge-base <your-branch> <branch>`, `git log --oneline <your-branch>..<branch>`, and `git status` in the branch folder, as the `Branch state` line reminds you. While a new worktree is still provisioning, a `Provisioning` line reports where its creation stands in the worker's operation queue and since when (`Provisioning: queued behind 3 worker operations since 2026-09-03T11:41:30Z`); a worker that predates operation receipts leaves that line out.
 
 `session process-log` prints a shell run's stored stdout and stderr from the server, where r5d keeps every run's full output; the `logPath` in tool results names that server-side store, not a file on the worker. Without flags it prints the whole log, `--tail <n>` keeps the last n lines, and `--grep <pattern>` keeps the lines matching a JavaScript regular expression (combine both for the last n matches). Each stream is capped at 512 KB per call and printed under a `==> stdout <==` or `==> stderr <==` header; a one-line summary with byte totals, the selection, and any truncation goes to stderr so stdout stays clean for `grep`, `head`, and `tail`. Inside an r5d worker shell the temporary credential can only read runs on that shell's worker.

package/dist/cjs/cli.cjs

@@ -30,9 +30,12 @@ var cli_exports = {};
 __export(cli_exports, {
   advanceTransientDevicePollBackoff: () => advanceTransientDevicePollBackoff,
   branchDeletionConfirmationMessage: () => branchDeletionConfirmationMessage,
+  branchDeletionsConfirmationMessage: () => branchDeletionsConfirmationMessage,
+  branchDeletionsFailureMessage: () => branchDeletionsFailureMessage,
   collectK8sUsage: () => collectK8sUsage,
   createBranchThroughPlatform: () => createBranchThroughPlatform,
   deleteBranchThroughPlatform: () => deleteBranchThroughPlatform,
+  deleteBranchesThroughPlatform: () => deleteBranchesThroughPlatform,
   dispatchSessionRunCommand: () => dispatchSessionRunCommand,
   followR5dctlSession: () => followR5dctlSession,
   formatK8sCpu: () => formatK8sCpu,
@@ -70,6 +73,7 @@ __export(cli_exports, {
   readDotenvFile: () => readDotenvFile,
   renderBranchDeletion: () => renderBranchDeletion,
   renderBranchDeletionPreview: () => renderBranchDeletionPreview,
+  renderBranchDeletionResult: () => renderBranchDeletionResult,
   renderBranchList: () => renderBranchList,
   renderBranchOperation: () => renderBranchOperation,
   renderConversationForkResponse: () => renderConversationForkResponse,
@@ -85,6 +89,7 @@ __export(cli_exports, {
   renderProcessInspection: () => renderProcessInspection,
   renderProcessList: () => renderProcessList,
   renderProcessLog: () => renderProcessLog,
+  renderSessionList: () => renderSessionList,
   renderSessionRunStart: () => renderSessionRunStart,
   renderSessionRunStatus: () => renderSessionRunStatus,
   renderWorkspaceStatus: () => renderWorkspaceStatus,
@@ -221,8 +226,8 @@ const SHARED_HELP_ENTRIES = [
   },
   {
     section: "branches",
-    usage: "-p <project> delete branch <branch> [--confirm]",
-    description: "Delete a branch and its sessions through the platform; without --confirm, only preview what would be deleted."
+    usage: "-p <project> delete branch <branch> [<branch>...] [--confirm]",
+    description: "Delete one or more branches and their sessions through the platform; without --confirm, only preview what would be deleted."
   },
   {
     section: "envs",
@@ -610,15 +615,18 @@ function parseBranchCreateArgs(args) {
   };
 }
 function parseBranchDeleteArgs(args) {
+  const branchNames = [];
   let confirmed = false;
   for (const arg of args) {
     if (arg === "--confirm") {
       confirmed = true;
       continue;
     }
-    throw new Error(arg.startsWith("-") ? `Unknown delete branch flag: ${arg}` : `Unexpected delete branch argument: ${arg}`);
+    if (arg.startsWith("-")) throw new Error(`Unknown delete branch flag: ${arg}`);
+    if (branchNames.includes(arg)) throw new Error(`Branch ${arg} was given more than once`);
+    branchNames.push(arg);
   }
-  return { confirmed };
+  return { branchNames, confirmed };
 }
 const PRIMARY_BRANCH_NAME = "main";
 function isUnsupportedServerRoute(error) {
@@ -653,6 +661,50 @@ async function deleteBranchThroughPlatform(client, projectRef, branchName, optio
   const result = await requireServerRouteSupport("delete branch", () => client.projects.branches.delete(projectRef, branchName));
   return { kind: "deleted", result };
 }
+async function deleteBranchesThroughPlatform(client, projectRef, branchNames, options) {
+  if (branchNames.length === 0) throw new Error("Missing branch name");
+  for (const branchName of branchNames) {
+    if (branchName === PRIMARY_BRANCH_NAME) throw new Error(`The primary branch ${branchName} cannot be deleted`);
+  }
+  if (!options.confirmed) {
+    const branches = [];
+    for (const branchName of branchNames) {
+      branches.push(await client.projects.branches.describe(projectRef, branchName));
+    }
+    return { kind: "preview", branches };
+  }
+  const results = [];
+  for (const branchName of branchNames) {
+    let result;
+    try {
+      const deletion = await deleteBranchThroughPlatform(client, projectRef, branchName, { confirmed: true });
+      if (deletion.kind !== "deleted") throw new Error(`Branch ${branchName} was only previewed`);
+      result = { branchName, deleted: true, deletedSessionIds: deletion.result.deletedSessionIds };
+    } catch (error) {
+      result = {
+        branchName,
+        deleted: false,
+        error: error instanceof import_r5d_api.R5dctlApiError ? extractApiErrorMessage(error) : error instanceof Error ? error.message : String(error)
+      };
+    }
+    results.push(result);
+    options.onResult?.(result);
+  }
+  return { kind: "deleted", results };
+}
+function renderBranchDeletionResult(result) {
+  return result.deleted ? renderBranchDeletion(result) : `Failed to delete branch ${result.branchName}: ${result.error}
+`;
+}
+function branchDeletionsConfirmationMessage(branches) {
+  const [only] = branches;
+  if (branches.length === 1 && only) return branchDeletionConfirmationMessage(only);
+  const sessionCount = branches.reduce((count, branch) => count + branch.sessions.length, 0);
+  return `Nothing was deleted. Re-run with --confirm to delete ${branches.length} branches and their ${sessionCount} session(s).`;
+}
+function branchDeletionsFailureMessage(results) {
+  return `Failed to delete ${results.filter((result) => !result.deleted).length} of ${results.length} branch(es).`;
+}
 function renderBranchDeletionPreview(branch) {
   const count = branch.sessions.length;
   const lines = [
@@ -1584,11 +1636,15 @@ function renderProjectList(projects) {
   Mode: ${project.mode}`).join("\n\n")}
 `;
 }
-function renderSessionList(sessions) {
+function formatSessionActivity(session, nowMs) {
+  if (!session.runState) return void 0;
+  return session.lastActivityAt ? `${session.runState}, last active ${formatProcessAge(session.lastActivityAt, nowMs)} ago` : session.runState;
+}
+function renderSessionList(sessions, nowMs = Date.now()) {
   if (sessions.length === 0) {
     return "No sessions found.\n";
   }
-  return `${sessions.map((session) => `${session.id}  ${session.branchName}  ${session.name ?? "(unnamed)"}`).join("\n")}
+  return `${sessions.map((session) => [session.id, session.branchName, formatSessionActivity(session, nowMs), session.name ?? "(unnamed)"].filter(Boolean).join("  ")).join("\n")}
 `;
 }
 function renderRecentSessionList(sessions) {
@@ -2079,6 +2135,13 @@ function formatProvisioningQueueLine(session) {
   if (position === 0) return `Provisioning: worker started the branch operation at ${since}`;
   return `Provisioning: queued behind ${position} worker operation${position === 1 ? "" : "s"} since ${since}`;
 }
+function formatChildSessionsLine(session) {
+  const children = session.childSessions;
+  if (!children || typeof children !== "object") return void 0;
+  const { total, active } = children;
+  if (!Number.isInteger(total) || !Number.isInteger(active) || total <= 0 || active < 0) return void 0;
+  return `Child sessions: ${active} active of ${total}`;
+}
 function renderSessionRunStatus(session) {
   const status = formatStatusValue(session.status) ?? "unknown";
   const lines = [`Session: ${responseString(session, "sessionId") ?? "(unknown)"}`, `Status: ${status}`];
@@ -2099,6 +2162,8 @@ function renderSessionRunStatus(session) {
     const value = responseString(session, key);
     if (value) lines.push(`${label}: ${value}`);
   }
+  const childSessions = formatChildSessionsLine(session);
+  if (childSessions) lines.push(childSessions);
   lines.push(`Branch state: ${formatBranchStateHint(branch)}`);
   const error = responseString(session, "error");
   if (error) lines.push(`Error: ${error}`);
@@ -2846,13 +2911,20 @@ Sessions: ${result.sessions.length}
   if (first === "projects" && second === "branches" && third === "delete" || first === "delete" && second === "branch") {
     const offset = first === "delete" ? 2 : 3;
     const projectRef = requireValue(args[offset], "Missing project reference");
-    const branchName = requireValue(args[offset + 1], "Missing branch name");
-    const deletion = await deleteBranchThroughPlatform(client, projectRef, branchName, parseBranchDeleteArgs(args.slice(offset + 2)));
+    const { branchNames, confirmed } = parseBranchDeleteArgs(args.slice(offset + 1));
+    const deletion = await deleteBranchesThroughPlatform(client, projectRef, branchNames, {
+      confirmed,
+      // Each deletion is its own round trip, so a reader sees results as they land.
+      onResult: (result) => {
+        if (!json) process.stdout.write(renderBranchDeletionResult(result));
+      }
+    });
     if (deletion.kind === "preview") {
-      write({ ...deletion.branch, confirmed: false }, renderBranchDeletionPreview(deletion.branch));
-      throw new Error(branchDeletionConfirmationMessage(deletion.branch));
+      write({ branches: deletion.branches, confirmed: false }, deletion.branches.map(renderBranchDeletionPreview).join("\n"));
+      throw new Error(branchDeletionsConfirmationMessage(deletion.branches));
     }
-    write(deletion.result, renderBranchDeletion(deletion.result));
+    if (json) write({ results: deletion.results }, "");
+    if (deletion.results.some((result) => !result.deleted)) throw new Error(branchDeletionsFailureMessage(deletion.results));
     return;
   }
   if (first === "get" && second === "envs") {
@@ -3387,17 +3459,14 @@ function resolveCommandExecution(options, rest) {
       if (!options.project) {
         throw new Error("--project/-p is required for `delete branch`");
       }
-      const rawArgs = commandArgs.slice(1);
-      const positionalBranch = rawArgs[0] && !rawArgs[0].startsWith("-") ? rawArgs[0] : void 0;
-      const branch = positionalBranch ?? options.branch;
-      if (!branch) {
+      const parsed = parseBranchDeleteArgs(commandArgs.slice(1));
+      const branchNames = parsed.branchNames.length > 0 ? parsed.branchNames : options.branch ? [options.branch] : [];
+      if (branchNames.length === 0) {
         throw new Error("Branch name is required for `delete branch`");
       }
-      const flagArgs = positionalBranch ? rawArgs.slice(1) : rawArgs;
-      parseBranchDeleteArgs(flagArgs);
       return {
         kind: "plugin",
-        pluginArgs: ["delete", "branch", options.project, branch, ...flagArgs]
+        pluginArgs: ["delete", "branch", options.project, ...branchNames, ...parsed.confirmed ? ["--confirm"] : []]
       };
     }
     throw new Error("Unknown delete command");
@@ -3628,9 +3697,12 @@ async function main(argv = process.argv.slice(2)) {
 0 && (module.exports = {
   advanceTransientDevicePollBackoff,
   branchDeletionConfirmationMessage,
+  branchDeletionsConfirmationMessage,
+  branchDeletionsFailureMessage,
   collectK8sUsage,
   createBranchThroughPlatform,
   deleteBranchThroughPlatform,
+  deleteBranchesThroughPlatform,
   dispatchSessionRunCommand,
   followR5dctlSession,
   formatK8sCpu,
@@ -3668,6 +3740,7 @@ async function main(argv = process.argv.slice(2)) {
   readDotenvFile,
   renderBranchDeletion,
   renderBranchDeletionPreview,
+  renderBranchDeletionResult,
   renderBranchList,
   renderBranchOperation,
   renderConversationForkResponse,
@@ -3683,6 +3756,7 @@ async function main(argv = process.argv.slice(2)) {
   renderProcessInspection,
   renderProcessList,
   renderProcessLog,
+  renderSessionList,
   renderSessionRunStart,
   renderSessionRunStatus,
   renderWorkspaceStatus,

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.104",
+  "version": "0.0.106",
   "type": "commonjs"
 }

package/dist/mjs/cli.mjs

@@ -126,8 +126,8 @@ const SHARED_HELP_ENTRIES = [
   },
   {
     section: "branches",
-    usage: "-p <project> delete branch <branch> [--confirm]",
-    description: "Delete a branch and its sessions through the platform; without --confirm, only preview what would be deleted."
+    usage: "-p <project> delete branch <branch> [<branch>...] [--confirm]",
+    description: "Delete one or more branches and their sessions through the platform; without --confirm, only preview what would be deleted."
   },
   {
     section: "envs",
@@ -515,15 +515,18 @@ function parseBranchCreateArgs(args) {
   };
 }
 function parseBranchDeleteArgs(args) {
+  const branchNames = [];
   let confirmed = false;
   for (const arg of args) {
     if (arg === "--confirm") {
       confirmed = true;
       continue;
     }
-    throw new Error(arg.startsWith("-") ? `Unknown delete branch flag: ${arg}` : `Unexpected delete branch argument: ${arg}`);
+    if (arg.startsWith("-")) throw new Error(`Unknown delete branch flag: ${arg}`);
+    if (branchNames.includes(arg)) throw new Error(`Branch ${arg} was given more than once`);
+    branchNames.push(arg);
   }
-  return { confirmed };
+  return { branchNames, confirmed };
 }
 const PRIMARY_BRANCH_NAME = "main";
 function isUnsupportedServerRoute(error) {
@@ -558,6 +561,50 @@ async function deleteBranchThroughPlatform(client, projectRef, branchName, optio
   const result = await requireServerRouteSupport("delete branch", () => client.projects.branches.delete(projectRef, branchName));
   return { kind: "deleted", result };
 }
+async function deleteBranchesThroughPlatform(client, projectRef, branchNames, options) {
+  if (branchNames.length === 0) throw new Error("Missing branch name");
+  for (const branchName of branchNames) {
+    if (branchName === PRIMARY_BRANCH_NAME) throw new Error(`The primary branch ${branchName} cannot be deleted`);
+  }
+  if (!options.confirmed) {
+    const branches = [];
+    for (const branchName of branchNames) {
+      branches.push(await client.projects.branches.describe(projectRef, branchName));
+    }
+    return { kind: "preview", branches };
+  }
+  const results = [];
+  for (const branchName of branchNames) {
+    let result;
+    try {
+      const deletion = await deleteBranchThroughPlatform(client, projectRef, branchName, { confirmed: true });
+      if (deletion.kind !== "deleted") throw new Error(`Branch ${branchName} was only previewed`);
+      result = { branchName, deleted: true, deletedSessionIds: deletion.result.deletedSessionIds };
+    } catch (error) {
+      result = {
+        branchName,
+        deleted: false,
+        error: error instanceof R5dctlApiError ? extractApiErrorMessage(error) : error instanceof Error ? error.message : String(error)
+      };
+    }
+    results.push(result);
+    options.onResult?.(result);
+  }
+  return { kind: "deleted", results };
+}
+function renderBranchDeletionResult(result) {
+  return result.deleted ? renderBranchDeletion(result) : `Failed to delete branch ${result.branchName}: ${result.error}
+`;
+}
+function branchDeletionsConfirmationMessage(branches) {
+  const [only] = branches;
+  if (branches.length === 1 && only) return branchDeletionConfirmationMessage(only);
+  const sessionCount = branches.reduce((count, branch) => count + branch.sessions.length, 0);
+  return `Nothing was deleted. Re-run with --confirm to delete ${branches.length} branches and their ${sessionCount} session(s).`;
+}
+function branchDeletionsFailureMessage(results) {
+  return `Failed to delete ${results.filter((result) => !result.deleted).length} of ${results.length} branch(es).`;
+}
 function renderBranchDeletionPreview(branch) {
   const count = branch.sessions.length;
   const lines = [
@@ -1489,11 +1536,15 @@ function renderProjectList(projects) {
   Mode: ${project.mode}`).join("\n\n")}
 `;
 }
-function renderSessionList(sessions) {
+function formatSessionActivity(session, nowMs) {
+  if (!session.runState) return void 0;
+  return session.lastActivityAt ? `${session.runState}, last active ${formatProcessAge(session.lastActivityAt, nowMs)} ago` : session.runState;
+}
+function renderSessionList(sessions, nowMs = Date.now()) {
   if (sessions.length === 0) {
     return "No sessions found.\n";
   }
-  return `${sessions.map((session) => `${session.id}  ${session.branchName}  ${session.name ?? "(unnamed)"}`).join("\n")}
+  return `${sessions.map((session) => [session.id, session.branchName, formatSessionActivity(session, nowMs), session.name ?? "(unnamed)"].filter(Boolean).join("  ")).join("\n")}
 `;
 }
 function renderRecentSessionList(sessions) {
@@ -1984,6 +2035,13 @@ function formatProvisioningQueueLine(session) {
   if (position === 0) return `Provisioning: worker started the branch operation at ${since}`;
   return `Provisioning: queued behind ${position} worker operation${position === 1 ? "" : "s"} since ${since}`;
 }
+function formatChildSessionsLine(session) {
+  const children = session.childSessions;
+  if (!children || typeof children !== "object") return void 0;
+  const { total, active } = children;
+  if (!Number.isInteger(total) || !Number.isInteger(active) || total <= 0 || active < 0) return void 0;
+  return `Child sessions: ${active} active of ${total}`;
+}
 function renderSessionRunStatus(session) {
   const status = formatStatusValue(session.status) ?? "unknown";
   const lines = [`Session: ${responseString(session, "sessionId") ?? "(unknown)"}`, `Status: ${status}`];
@@ -2004,6 +2062,8 @@ function renderSessionRunStatus(session) {
     const value = responseString(session, key);
     if (value) lines.push(`${label}: ${value}`);
   }
+  const childSessions = formatChildSessionsLine(session);
+  if (childSessions) lines.push(childSessions);
   lines.push(`Branch state: ${formatBranchStateHint(branch)}`);
   const error = responseString(session, "error");
   if (error) lines.push(`Error: ${error}`);
@@ -2751,13 +2811,20 @@ Sessions: ${result.sessions.length}
   if (first === "projects" && second === "branches" && third === "delete" || first === "delete" && second === "branch") {
     const offset = first === "delete" ? 2 : 3;
     const projectRef = requireValue(args[offset], "Missing project reference");
-    const branchName = requireValue(args[offset + 1], "Missing branch name");
-    const deletion = await deleteBranchThroughPlatform(client, projectRef, branchName, parseBranchDeleteArgs(args.slice(offset + 2)));
+    const { branchNames, confirmed } = parseBranchDeleteArgs(args.slice(offset + 1));
+    const deletion = await deleteBranchesThroughPlatform(client, projectRef, branchNames, {
+      confirmed,
+      // Each deletion is its own round trip, so a reader sees results as they land.
+      onResult: (result) => {
+        if (!json) process.stdout.write(renderBranchDeletionResult(result));
+      }
+    });
     if (deletion.kind === "preview") {
-      write({ ...deletion.branch, confirmed: false }, renderBranchDeletionPreview(deletion.branch));
-      throw new Error(branchDeletionConfirmationMessage(deletion.branch));
+      write({ branches: deletion.branches, confirmed: false }, deletion.branches.map(renderBranchDeletionPreview).join("\n"));
+      throw new Error(branchDeletionsConfirmationMessage(deletion.branches));
     }
-    write(deletion.result, renderBranchDeletion(deletion.result));
+    if (json) write({ results: deletion.results }, "");
+    if (deletion.results.some((result) => !result.deleted)) throw new Error(branchDeletionsFailureMessage(deletion.results));
     return;
   }
   if (first === "get" && second === "envs") {
@@ -3292,17 +3359,14 @@ function resolveCommandExecution(options, rest) {
       if (!options.project) {
         throw new Error("--project/-p is required for `delete branch`");
       }
-      const rawArgs = commandArgs.slice(1);
-      const positionalBranch = rawArgs[0] && !rawArgs[0].startsWith("-") ? rawArgs[0] : void 0;
-      const branch = positionalBranch ?? options.branch;
-      if (!branch) {
+      const parsed = parseBranchDeleteArgs(commandArgs.slice(1));
+      const branchNames = parsed.branchNames.length > 0 ? parsed.branchNames : options.branch ? [options.branch] : [];
+      if (branchNames.length === 0) {
         throw new Error("Branch name is required for `delete branch`");
       }
-      const flagArgs = positionalBranch ? rawArgs.slice(1) : rawArgs;
-      parseBranchDeleteArgs(flagArgs);
       return {
         kind: "plugin",
-        pluginArgs: ["delete", "branch", options.project, branch, ...flagArgs]
+        pluginArgs: ["delete", "branch", options.project, ...branchNames, ...parsed.confirmed ? ["--confirm"] : []]
       };
     }
     throw new Error("Unknown delete command");
@@ -3532,9 +3596,12 @@ async function main(argv = process.argv.slice(2)) {
 export {
   advanceTransientDevicePollBackoff,
   branchDeletionConfirmationMessage,
+  branchDeletionsConfirmationMessage,
+  branchDeletionsFailureMessage,
   collectK8sUsage,
   createBranchThroughPlatform,
   deleteBranchThroughPlatform,
+  deleteBranchesThroughPlatform,
   dispatchSessionRunCommand,
   followR5dctlSession,
   formatK8sCpu,
@@ -3572,6 +3639,7 @@ export {
   readDotenvFile,
   renderBranchDeletion,
   renderBranchDeletionPreview,
+  renderBranchDeletionResult,
   renderBranchList,
   renderBranchOperation,
   renderConversationForkResponse,
@@ -3587,6 +3655,7 @@ export {
   renderProcessInspection,
   renderProcessList,
   renderProcessLog,
+  renderSessionList,
   renderSessionRunStart,
   renderSessionRunStatus,
   renderWorkspaceStatus,

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.104",
+  "version": "0.0.106",
   "type": "module"
 }

package/dist/types/cli.d.ts

@@ -1,4 +1,4 @@
-import { R5dctlApiError, R5dctlClient, type R5dctlConversationForkResponse, type R5dctlConversationHeadResponse, type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type R5dctlConversationNodeResponse, type R5dctlConversationOverviewResponse, type R5dctlConversationWorkDetail, type R5dctlConversationWorkResponse, type R5dctlEnvData, type R5dctlK8sResourceHistory, type R5dctlK8sUsage, type R5dctlK8sWorkload, type R5dctlProcessInspection, type R5dctlProcessListInput, type R5dctlProcessLog, type R5dctlProcessRun, type R5dctlBranch, type R5dctlBranchDeleteResponse, type R5dctlBranchDescription, type R5dctlBranchOperation, type R5dctlSessionEvent, type R5dctlSessionStartInput, type R5dctlWorkspaceStatus, type R5dctlWorkspaceSyncResult, type R5dctlWorkingTreeMode, type R5dctlWorktreeSource, type R5dctlSessionMode, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
+import { R5dctlApiError, R5dctlClient, type R5dctlConversationForkResponse, type R5dctlConversationHeadResponse, type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type R5dctlConversationNodeResponse, type R5dctlConversationOverviewResponse, type R5dctlConversationWorkDetail, type R5dctlConversationWorkResponse, type R5dctlEnvData, type R5dctlK8sResourceHistory, type R5dctlK8sUsage, type R5dctlK8sWorkload, type R5dctlProcessInspection, type R5dctlProcessListInput, type R5dctlProcessLog, type R5dctlProcessRun, type R5dctlBranch, type R5dctlBranchDeleteResponse, type R5dctlBranchDescription, type R5dctlBranchOperation, type R5dctlSessionSummary, type R5dctlSessionEvent, type R5dctlSessionStartInput, type R5dctlWorkspaceStatus, type R5dctlWorkspaceSyncResult, type R5dctlWorkingTreeMode, type R5dctlWorktreeSource, type R5dctlSessionMode, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
 export type GlobalOptions = {
     baseUrl?: string;
     json: boolean;
@@ -86,6 +86,7 @@ export type R5dctlBranchCreateArgs = {
 };
 export declare function parseBranchCreateArgs(args: string[]): R5dctlBranchCreateArgs;
 export declare function parseBranchDeleteArgs(args: string[]): {
+    branchNames: string[];
     confirmed: boolean;
 };
 /** An older server strips unknown routes and answers with this generic 404; a route's own not-found carries a specific message. */
@@ -103,6 +104,35 @@ export type R5dctlBranchDeletionOutcome = {
 export declare function deleteBranchThroughPlatform(client: R5dctlClient, projectRef: string, branchName: string, options: {
     confirmed: boolean;
 }): Promise<R5dctlBranchDeletionOutcome>;
+export type R5dctlBranchDeletionResult = {
+    branchName: string;
+    deleted: true;
+    deletedSessionIds: string[];
+} | {
+    branchName: string;
+    deleted: false;
+    error: string;
+};
+export type R5dctlBranchDeletionsOutcome = {
+    kind: "preview";
+    branches: R5dctlBranchDescription[];
+} | {
+    kind: "deleted";
+    results: R5dctlBranchDeletionResult[];
+};
+/**
+ * Delete several branches one request at a time: the server route stays
+ * one-branch-per-request. Every name is checked before the first request, a
+ * preview describes each branch, and a confirmed run continues past a failed
+ * branch so one refused deletion does not strand the rest of the list.
+ */
+export declare function deleteBranchesThroughPlatform(client: R5dctlClient, projectRef: string, branchNames: readonly string[], options: {
+    confirmed: boolean;
+    onResult?: (result: R5dctlBranchDeletionResult) => void;
+}): Promise<R5dctlBranchDeletionsOutcome>;
+export declare function renderBranchDeletionResult(result: R5dctlBranchDeletionResult): string;
+export declare function branchDeletionsConfirmationMessage(branches: readonly R5dctlBranchDescription[]): string;
+export declare function branchDeletionsFailureMessage(results: readonly R5dctlBranchDeletionResult[]): string;
 export declare function renderBranchDeletionPreview(branch: R5dctlBranchDescription): string;
 export declare function branchDeletionConfirmationMessage(branch: R5dctlBranchDescription): string;
 export declare function renderBranchDeletion(result: R5dctlBranchDeleteResponse): string;
@@ -174,6 +204,7 @@ export declare function advanceTransientDevicePollBackoff(intervalMs: number, tr
     nextBackoffMs: number;
 };
 export declare function handleAuthLogin(client: R5dctlClient, options: GlobalOptions, commandArgs: string[], config: R5dctlConfig): Promise<void>;
+export declare function renderSessionList(sessions: R5dctlSessionSummary[], nowMs?: number): string;
 export declare function renderWorkspaceStatus(status: R5dctlWorkspaceStatus): string;
 export declare function renderBranchList(branches: R5dctlBranch[]): string;
 export declare function renderWorkspaceSync(result: R5dctlWorkspaceSyncResult): string;
@@ -254,6 +285,11 @@ export type R5dctlCommandResponse = {
     error?: string;
     summary?: string;
     diffSummary?: string;
+    /** Sub-agent sessions this session launched; older servers omit it. */
+    childSessions?: {
+        total: number;
+        active: number;
+    };
 };
 export type R5dctlSessionRunClient = {
     projects: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.104",
+  "version": "0.0.106",
   "type": "module",
   "main": "./dist/cjs/cli.cjs",
   "module": "./dist/mjs/cli.mjs",
@@ -26,7 +26,7 @@
     "r5dctl": "dist/cjs/main.cjs"
   },
   "dependencies": {
-    "@ricsam/r5d-api": "^0.0.104",
+    "@ricsam/r5d-api": "^0.0.106",
     "dotenv": "^17",
     "qrcode": "^1.5.4",
     "ws": "^8.18.3"