@sideboard-ai/cli 0.1.103 → 0.1.107

package/README.md

@@ -8,6 +8,7 @@ npm i -g @sideboard-ai/cli
 sideboard ls
 sideboard send <thread> "…"
 sideboard mcp          # MCP stdio server
+sideboard schedule ls  # local jobs that trigger orchestration chats
 ```
 
 Also installs `side` as a short alias. The MCP server is available as `sideboard mcp`, or via `@sideboard-ai/core`'s `sideboard-mcp` bin.
@@ -20,3 +21,5 @@ sideboard slack listen
 ```
 
 How to connect and address Personal / Work Macs: [README — Slack](../../README.md#slack).
+
+Schedules (Settings, CLI, or MCP `create_schedule`) fire only while Sideboard.app is running. Overnight: Settings → Advanced → Caffeinate while schedules are enabled. Details: [README — Scheduled orchestration](../../README.md#scheduled-orchestration).

package/dist/index.js

@@ -30,7 +30,15 @@ import {
   disconnectLinear,
   runSlackListen,
   SLACK_OAUTH_REDIRECT,
-  LINEAR_OAUTH_REDIRECT
+  LINEAR_OAUTH_REDIRECT,
+  createSchedule,
+  deleteSchedule,
+  fireSchedule,
+  formatScheduleWhen,
+  getSchedule,
+  listSchedules,
+  resolveScheduleThreadId,
+  updateSchedule
 } from "@sideboard-ai/core";
 var VERSION = "0.1.0";
 async function printUpgradeHint() {
@@ -504,6 +512,96 @@ ${preview.diffStat}`);
   program.command("mcp").description("Run the Sideboard MCP stdio server").action(async () => {
     await startMcpServer();
   });
+  const scheduleCmd = program.command("schedule").description(
+    "Local jobs that trigger orchestration chats (Sideboard.app must be running to fire)"
+  );
+  scheduleCmd.command("ls").description("List schedules").action(() => {
+    const rows = listSchedules();
+    if (rows.length === 0) {
+      console.log(chalk.dim("No schedules"));
+      return;
+    }
+    for (const row of rows) {
+      const target = row.threadId ? row.threadId.slice(0, 8) : "new chat";
+      const on = row.enabled ? chalk.green("on ") : chalk.dim("off");
+      console.log(
+        `${row.id.slice(0, 8)}  ${on}  ${formatScheduleWhen(row.when)}  next ${row.nextRunAt}  ${target}  ${row.name}`
+      );
+      if (row.lastError) console.log(chalk.red(`         ${row.lastError}`));
+    }
+  });
+  scheduleCmd.command("add").requiredOption("--prompt <text>", "prompt / goal queued when the job fires").option("--name <name>", "short label").option("--at <iso>", "one-shot ISO datetime").option("--every <duration>", "interval (15m, 1h, 6h, 1d)").option("--cron <expr>", "5-field cron").option("--tz <iana>", "timezone for cron").option(
+    "--thread <id>",
+    "existing orchestration chat (or self). Omit to create a new Global chat each run"
+  ).option("--agent <agent>", "claude|cursor|codex|opencode (new chats only)").action((opts) => {
+    const cadence = [opts.at, opts.every, opts.cron].filter(Boolean);
+    if (cadence.length !== 1) {
+      throw new Error("Pass exactly one of --at, --every, or --cron");
+    }
+    const when = opts.at ? { kind: "once", at: String(opts.at) } : opts.every ? { kind: "every", every: String(opts.every) } : {
+      kind: "cron",
+      expr: String(opts.cron),
+      tz: opts.tz ? String(opts.tz) : void 0
+    };
+    const threadId = resolveScheduleThreadId(
+      opts.thread ? String(opts.thread) : void 0
+    );
+    if (String(opts.thread ?? "").trim().toLowerCase() === "self" && !threadId) {
+      throw new Error("--thread self needs SIDEBOARD_ORCHESTRATOR_THREAD_ID");
+    }
+    const agent = opts.agent ? parseAgent(String(opts.agent)) : void 0;
+    if (agent === "brightsy") {
+      throw new Error("schedules cannot use brightsy \u2014 pick claude, cursor, codex, or opencode");
+    }
+    const row = createSchedule({
+      name: opts.name,
+      prompt: String(opts.prompt),
+      when,
+      threadId,
+      agent,
+      createdBy: "cli"
+    });
+    if (!row.threadId && row.when.kind !== "once") {
+      console.log(
+        chalk.yellow(
+          "Recurring schedule has no --thread: each run opens a new orchestration chat."
+        )
+      );
+    }
+    console.log(
+      chalk.green(
+        `Scheduled ${row.id.slice(0, 8)}  ${formatScheduleWhen(row.when)}  next ${row.nextRunAt}`
+      )
+    );
+    console.log(chalk.dim("Fires while Sideboard.app is running on this Mac."));
+  });
+  scheduleCmd.command("enable").argument("<id>", "schedule id").action((id) => {
+    const row = updateSchedule(id, { enabled: true });
+    console.log(chalk.green(`Enabled ${row.id.slice(0, 8)}`));
+  });
+  scheduleCmd.command("disable").argument("<id>", "schedule id").action((id) => {
+    const row = updateSchedule(id, { enabled: false });
+    console.log(chalk.yellow(`Disabled ${row.id.slice(0, 8)}`));
+  });
+  scheduleCmd.command("rm").argument("<id>", "schedule id").action((id) => {
+    const row = getSchedule(id);
+    if (!row) throw new Error(`Schedule not found: ${id}`);
+    deleteSchedule(row.id);
+    console.log(chalk.yellow(`Removed ${row.id.slice(0, 8)}`));
+  });
+  scheduleCmd.command("run").argument("<id>", "schedule id").description("Fire now").action(async (id) => {
+    const row = await fireSchedule(id);
+    if (row.lastError) {
+      console.error(chalk.red(row.lastError));
+      process.exitCode = 1;
+      return;
+    }
+    console.log(
+      chalk.green(
+        `Fired ${row.id.slice(0, 8)} \u2192 ${row.lastThreadId?.slice(0, 8) ?? "thread"}`
+      )
+    );
+  });
   const brightsyCmd = program.command("brightsy").description(
     "Brightsy team helpers (wraps `brightsy teams` + Sideboard multi-team MCP state)"
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sideboard-ai/cli",
-  "version": "0.1.103",
+  "version": "0.1.107",
   "description": "Sideboard CLI — agent-agnostic worktree orchestration (includes `sideboard mcp`)",
   "license": "Apache-2.0",
   "type": "module",
@@ -16,7 +16,7 @@
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
     "ora": "^8.2.0",
-    "@sideboard-ai/core": "0.1.103"
+    "@sideboard-ai/core": "0.1.107"
   },
   "devDependencies": {
     "@types/node": "^22.13.10",