@wirecat/cli-core 0.568.0 → 0.569.0

package/CHANGELOG.md

@@ -7,6 +7,20 @@ shape of this file.
 
 ## Unreleased
 
+## 0.569.0 — 05.11.2026
+
+### Changed — may break callers
+
+- **A claude agent schedule runs on Sonnet and starts lean.** `schedule agent` takes `--model <model>` (an alias such
+  as `sonnet` or `opus`, a model id, or `""` for the harness's own default). Without it, a claude schedule runs on
+  `sonnet` and a codex schedule on codex's own default; a host's config file may change either
+  (`schedule_model_claude`, `schedule_model_codex` in `SCHEDULE_SETTINGS`): flag, then config file, then default.
+  A new claude schedule also starts with `--tools Bash --strict-mcp-config --disable-slash-commands
+  --setting-sources ""`: none of the owner's MCP servers, skills, settings or CLAUDE.md, while `--permission-mode
+  dontAsk` and `--allowedTools` still hold. A "say ok" run measured $0.152 and 37,925 input tokens before, $0.019 and
+  4,740 after. `schedule_lean_start: false` keeps the owner's setup. Both are read when the schedule is added; an
+  existing schedule keeps its argv until it is added again. `ScheduleLimits` gains `models` and `leanStart`.
+
 ## 0.568.0 — 05.11.2026
 
 ### Changed — may break callers

package/dist/cli/schedule/schedule-command.d.ts

@@ -4,6 +4,8 @@ import { type MailWaiting } from "../../mail/marks.js";
 import { type AppIdentity } from "../../ports/app.js";
 import { type AnswerOutput } from "../envelope.js";
 import type { DeclaredSetting } from "../setting-defaults.js";
+declare const HARNESSES: readonly ["claude", "codex"];
+type Harness = (typeof HARNESSES)[number];
 export interface ScheduleHost {
     app: AppIdentity;
     context(command: Command, resolving?: {
@@ -17,7 +19,7 @@ export interface ScheduleHost {
      * then runs only once enough of it waits, or the oldest has waited long enough.
      */
     newMail?: (command: Command, holder: string) => Promise<MailWaiting>;
-    /** The config file's limits for agent schedules; a schedule's own flags win, `SCHEDULE_DEFAULTS` fill the rest. */
+    /** The config file's settings for agent schedules; a schedule's own flags win, the defaults fill the rest. */
     limits?: (command: Command) => ScheduleLimits;
     /**
      * Other CLIs the scheduled agent may run besides this one, each under its own `<PREFIX>_READ_ONLY`: memo's mail
@@ -25,14 +27,20 @@ export interface ScheduleHost {
      */
     agentRuns?: readonly AgentCli[];
 }
-export type ScheduleLimits = Partial<Pick<Schedule, "mailWaitMinutes" | "mailBatch" | "maxCostPerDay">>;
-/** The agent-schedule limits a host with `newMail` writes into its config file's top level (WC-CMD-30). */
+export type ScheduleLimits = Partial<Pick<Schedule, "mailWaitMinutes" | "mailBatch" | "maxCostPerDay"> & {
+    models: Partial<Record<Harness, string>>;
+    leanStart: boolean;
+}>;
+/** The agent-schedule settings a host with `newMail` writes into its config file's top level (WC-CMD-30). */
 export declare const SCHEDULE_SETTINGS: readonly DeclaredSetting[];
 /** `SCHEDULE_SETTINGS` as the config file gives them; a missing or unusable value is left to the default. */
 export declare const scheduleLimitsOf: (config: {
     schedule_mail_wait?: unknown;
     schedule_mail_batch?: unknown;
     schedule_max_cost_per_day?: unknown;
+    schedule_model_claude?: unknown;
+    schedule_model_codex?: unknown;
+    schedule_lean_start?: unknown;
 }) => ScheduleLimits;
 /**
  * Runs the CLI's own commands, or an agent, later or on a timer — through systemd (Linux), launchd
@@ -40,3 +48,4 @@ export declare const scheduleLimitsOf: (config: {
  * the rest, so what runs and with which variables is the same on all three.
  */
 export declare const scheduleCommandFor: ({ app, context: contextOf, newMail, limits: configured, agentRuns, }: ScheduleHost) => Command;
+export {};

package/dist/cli/schedule/schedule-command.js

@@ -23,6 +23,15 @@ const AGENT_MINIMUM_MINUTES = 60;
 const GATED_AGENT_MINIMUM_MINUTES = 5;
 const COMMAND_MINIMUM_MINUTES = 1;
 const HARNESSES = ["claude", "codex"];
+/** A mid-tier model by default; codex has no alias of that tier, so it takes its own default. Empty: the harness's own. */
+const AGENT_MODELS = { claude: "sonnet", codex: "" };
+/** An alias or a model id; a leading dash would read as the harness's next flag. */
+const isModel = (model) => /^([A-Za-z0-9][\w.:/@[\]-]*)?$/.test(model);
+/**
+ * Claude starts without the owner's MCP servers, skills, settings and CLAUDE.md: a run reads its instructions
+ * through the CLI, and the rest was most of its starting context. Auth, `--permission-mode` and `--allowedTools` hold.
+ */
+const LEAN_CLAUDE = ["--tools", "Bash", "--strict-mcp-config", "--disable-slash-commands", "--setting-sources", ""];
 const whenOf = ({ every, at, atTime }, minimum) => {
     if ([every ?? at, atTime].filter(Boolean).length !== 1) {
         throw new CliError("validation_error", "say when: --every <30m|2h|1d>, --at HH:MM (daily), or --at-time <30m|2d|ISO time>");
@@ -76,7 +85,7 @@ const withWhen = (command) => command
 const promptExample = (app) => app.messenger === false
     ? `summarize what came in during the last day: ${app.command} personal search messages 'date>1d' --newest --limit 20`
     : `run the daily follow-up review: ${app.command} skill show follow-ups`;
-/** The agent-schedule limits a host with `newMail` writes into its config file's top level (WC-CMD-30). */
+/** The agent-schedule settings a host with `newMail` writes into its config file's top level (WC-CMD-30). */
 export const SCHEDULE_SETTINGS = [
     {
         key: "schedule_mail_wait",
@@ -93,11 +102,32 @@ export const SCHEDULE_SETTINGS = [
         default: SCHEDULE_DEFAULTS.maxCostPerDay,
         description: "US dollars an agent schedule's runs may cost in a day before it waits for the next; 0 for no cap",
     },
+    {
+        key: "schedule_model_claude",
+        default: AGENT_MODELS.claude,
+        description: "the model a new claude agent schedule runs on, unless --model names one; empty for claude's own default",
+    },
+    {
+        key: "schedule_model_codex",
+        default: AGENT_MODELS.codex,
+        description: "the model a new codex agent schedule runs on, unless --model names one; empty for codex's own default",
+    },
+    {
+        key: "schedule_lean_start",
+        default: true,
+        description: "a new claude agent schedule starts without your MCP servers, skills, settings and CLAUDE.md; false loads them",
+    },
 ];
 /** `SCHEDULE_SETTINGS` as the config file gives them; a missing or unusable value is left to the default. */
 export const scheduleLimitsOf = (config) => {
     const { schedule_mail_wait: wait, schedule_mail_batch: batch, schedule_max_cost_per_day: cap } = config;
+    const models = Object.fromEntries(HARNESSES.flatMap((harness) => {
+        const model = config[`schedule_model_${harness}`];
+        return typeof model === "string" && isModel(model.trim()) ? [[harness, model.trim()]] : [];
+    }));
     return {
+        ...(Object.keys(models).length ? { models } : {}),
+        ...(typeof config.schedule_lean_start === "boolean" ? { leanStart: config.schedule_lean_start } : {}),
         ...(typeof wait === "string"
             ? { mailWaitMinutes: Math.ceil(parseDuration(wait, "schedule_mail_wait") / 60_000) }
             : {}),
@@ -106,6 +136,7 @@ export const scheduleLimitsOf = (config) => {
     };
 };
 const given = (limits) => Object.fromEntries(Object.entries(limits).filter(([, value]) => value !== undefined));
+const shown = (argv) => argv.map((arg) => (arg === "" ? '""' : arg)).join(" ");
 const usd = (value) => `$${value.toFixed(2)}`;
 /**
  * Runs the CLI's own commands, or an agent, later or on a timer — through systemd (Linux), launchd
@@ -143,7 +174,7 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
             await timer().install(schedule, [...system.entry, "schedule", "exec", file]);
             say(scheduleAnswer(schedule, { file, timer: timer().where(schedule.name), replaced }), [
                 `${replaced ? "Replaced" : "Added"} ${schedule.name}: ${describeWhen(schedule.when)}.`,
-                `It runs: ${schedule.kind === "agent" ? schedule.argv.join(" ") : `${app.command} ${schedule.argv.join(" ")}`}`,
+                `It runs: ${schedule.kind === "agent" ? shown(schedule.argv) : `${app.command} ${shown(schedule.argv)}`}`,
                 `Output: ${join(dirname(file), "runs")} · now: ${lineOf(self, `schedule run ${schedule.name}`)} · stop: ${lineOf(self, `schedule remove ${schedule.name}`)}`,
             ]);
         };
@@ -216,12 +247,14 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
         examples: [
             `${app.command} personal schedule agent review claude "review what came in overnight and draft replies" --at 08:30`,
             `${app.command} personal schedule agent triage codex "list what needs an answer today" --every 2h --max-cost 1`,
+            `${app.command} personal schedule agent weekly claude "review the week's open threads" --at 09:00 --model opus`,
         ],
     }))
         .description(`start an agent (claude or codex) with a prompt on a timer; it runs with ${agentClis.map((one) => `${one.envPrefix}_READ_ONLY=1`).join(" and ")}, so it reads and drafts and cannot send — its answer is kept and you are notified`)
         .argument("<name>", "lowercase letters, digits and dashes")
         .addArgument(new Argument("<harness>", "the agent to start").choices(HARNESSES))
         .argument("<prompt>", `what to do, e.g. "${promptExample(app)}"`)
+        .option("--model <model>", `the model it runs on: an alias such as sonnet, or a model id; "" for the harness's default (default sonnet for claude, codex's own for codex, or the config file's)`)
         .addOption(new Option("--max-cost <usd>", "claude only: stop a run that costs more than this, in US dollars").argParser(Number))
         .addOption(new Option("--max-cost-per-day <usd>", `claude only: start no run for the rest of the day once its runs cost this much, in US dollars; 0 for no cap (default ${SCHEDULE_DEFAULTS.maxCostPerDay}, or the config file's)`).argParser(Number))).action(async function (name, harness, prompt) {
         const { context, system, environment, save } = prepare(this);
@@ -236,6 +269,11 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
         if (mailBatch !== undefined && !(Number.isSafeInteger(mailBatch) && mailBatch >= 1))
             throw new CliError("validation_error", "--mail-batch takes a count of emails, 1 or more");
         const mailWaitMinutes = options.mailWait === undefined ? undefined : Math.ceil(parseDuration(options.mailWait, "--mail-wait") / 60_000);
+        if (options.model !== undefined && !isModel(options.model))
+            throw new CliError("validation_error", `--model takes an alias such as sonnet or a model id, not "${options.model}"`);
+        const settings = configured?.(this) ?? {};
+        const model = options.model ?? settings.models?.[harness] ?? AGENT_MODELS[harness];
+        const modelFlag = model ? ["--model", model] : [];
         const program = findProgram(harness, context.env, system.platform);
         if (!program)
             throw new CliError("not_found", `${harness} is not on PATH`);
@@ -254,6 +292,8 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
                 "--allowedTools",
                 ...agentClis.map((one) => `Bash(${one.command}:*)`),
                 "--no-session-persistence",
+                ...modelFlag,
+                ...((settings.leanStart ?? true) ? LEAN_CLAUDE : []),
                 ...(options.maxCost ? ["--max-budget-usd", String(options.maxCost)] : []),
             ]
             : [
@@ -266,6 +306,7 @@ export const scheduleCommandFor = ({ app, context: contextOf, newMail, limits: c
                 // The CLIs reach their provider and write the store and their own state, and nothing else.
                 "-c",
                 "sandbox_workspace_write.network_access=true",
+                ...modelFlag,
                 ...[dirname(storePath(context.env)), ...folders].flatMap((dir) => ["--add-dir", dir]),
                 prompt,
             ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.568.0",
+  "version": "0.569.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",

package/parity.json

@@ -3972,6 +3972,12 @@
           "planned": {
             "wa": "wa backlog: mount the shared schedule command"
           }
+        },
+        "--model": {
+          "in": ["max", "tg"],
+          "planned": {
+            "wa": "wa backlog: mount the shared schedule command"
+          }
         }
       }
     },