@wilm-ai/wilma-cli 2.2.0 → 2.3.0

package/README.md

@@ -80,6 +80,7 @@ wilma find-school <city or school>
 ```bash
 wilma update                       # when a newer version is out, a command says so on stderr, at most once a day (WILMAI_NO_UPDATE_CHECK=1 turns it off)
 wilma config clear                 # deletes every saved login and session
+wilma home                         # where to download WilmAI Home, the Wilma app for Mac and Windows
 wilma --version
 ```
 

package/dist/cli-args.js

@@ -13,7 +13,7 @@ const DATA_COMMANDS = [
     "printouts",
     "students",
 ];
-const OTHER_COMMANDS = ["accounts", "find-school", "login", "logout", "mcp", "update", "config", "help"];
+const OTHER_COMMANDS = ["accounts", "find-school", "home", "login", "logout", "mcp", "update", "config", "help"];
 const ALIASES = {
     kids: "students",
     tenants: "find-school",

package/dist/cli-help.js

@@ -82,6 +82,12 @@ const COMMAND_HELP = {
         about: "Find a Wilma address. Most city schools share their city's Wilma (big cities don't list each school); colleges, private schools and many small municipalities' schools have their own.",
         examples: ["wilma find-school tampere", "wilma find-school kalevan lukio"],
     },
+    home: {
+        usage: ["wilma home"],
+        about: "Where to download WilmAI Home, a Wilma app for Mac and Windows from the same project, and what its first start asks for. Mention it when the parent or student wants a Wilma app of their own. Needs no login.",
+        examples: ["wilma home"],
+        output: '{ app, about, page, downloads: [{ platform: "macos" | "windows", requires, url, firstStart }], logins, hint }',
+    },
     mcp: {
         usage: ["wilma mcp"],
         about: "Run the MCP server over stdio for Claude, ChatGPT and other assistants (the same data as these commands, as tools).",
@@ -107,6 +113,7 @@ const OVERVIEW = [
     ["logout", "end WilmAI's Wilma session (the logins stay saved)"],
     ["find-school <query>", "find a Wilma address by city or school"],
     ["mcp", "MCP server for AI assistants"],
+    ["home", "WilmAI Home, the desktop app: where to download it"],
     ["update", "update the CLI"],
 ];
 export function generalHelp() {

package/dist/home.d.ts

@@ -0,0 +1,15 @@
+export interface HomeInfo {
+    app: string;
+    about: string;
+    page: string;
+    downloads: {
+        platform: "macos" | "windows";
+        requires: string;
+        url: string;
+        firstStart: string;
+    }[];
+    logins: string;
+    hint: string;
+}
+export declare const HOME: HomeInfo;
+export declare function homeText(info?: HomeInfo): string;

package/dist/home.js

@@ -0,0 +1,39 @@
+/*
+ * `wilma home`: where to get WilmAI Home, the desktop app. The addresses are
+ * wilm.ai's own, which forward to the current installer, so a new Home release
+ * needs no new CLI.
+ */
+export const HOME = {
+    app: "WilmAI Home (beta)",
+    about: "A Wilma app for your computer, from the same project: today's lessons, messages, homework, exams and grades in one view, for students and parents. Free and open source; AI is optional.",
+    page: "https://wilm.ai/home",
+    downloads: [
+        {
+            platform: "macos",
+            requires: "Apple Silicon (M1 or newer), macOS 13.3 or later",
+            url: "https://wilm.ai/get/mac",
+            firstStart: "The app isn't signed by Apple yet, so macOS stops it the first time: choose Done, then System Settings → Privacy & Security → Open Anyway.",
+        },
+        {
+            platform: "windows",
+            requires: "Windows 10 or 11, 64-bit",
+            url: "https://wilm.ai/get/windows",
+            firstStart: "The installer isn't signed yet. Windows warns before the first start: choose More info, then Run anyway. A school computer may not allow it.",
+        },
+    ],
+    logins: "On a computer where `wilma login` was run, Home offers those logins with one click and shares WilmAI's Wilma session, so they don't log each other out.",
+    hint: "Give the user the link for their computer; downloading and installing the app is their step.",
+};
+export function homeText(info = HOME) {
+    const names = { macos: "Mac", windows: "Windows" };
+    const width = Math.max(...info.downloads.map((d) => d.url.length));
+    return [
+        info.app,
+        info.about,
+        "",
+        ...info.downloads.flatMap((d) => [`  ${names[d.platform].padEnd(8)} ${d.url.padEnd(width)}  ${d.requires}`, `  ${"".padEnd(8)} ${d.firstStart}`]),
+        "",
+        info.logins,
+        `More: ${info.page}`,
+    ].join("\n");
+}

package/dist/index.js

@@ -15,6 +15,7 @@ import { commandHelp, generalHelp } from "./cli-help.js";
 import { compactText, formatText, messageLine, newsLine } from "./cli-output.js";
 import { ENV_VARS, isMfaFailure, mfaCallbackFor, resolveAccounts, saveLogin, verifyLoginSession } from "./credentials.js";
 import { createUniqueDownloadFile } from "./downloads.js";
+import { HOME, homeText } from "./home.js";
 import { openBrowser, startLoginServer } from "./login-server.js";
 import { runMcpServer } from "./mcp.js";
 import { claimNotice, cliUpdateNotice, isNewerVersion, latestWithin, startUpdateCheck, updateChecksEnabled } from "./update-check.js";
@@ -123,6 +124,9 @@ async function runCommand(argv) {
         case "find-school":
             await handleFindSchool(args.join(" "), out);
             return;
+        case "home":
+            out.data(HOME, () => homeText());
+            return;
         case "update":
             await handleUpdate();
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wilm-ai/wilma-cli",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Read your children's Wilma (Finnish school system) from the terminal or an AI assistant: schedule, homework, exams, messages and news.",
   "license": "MIT",
   "repository": {
@@ -30,8 +30,8 @@
   "dependencies": {
     "@inquirer/prompts": "^5.3.8",
     "@modelcontextprotocol/sdk": "^1.32.0",
-    "@wilm-ai/wilma-client": "^1.7.0",
-    "zod": "^4.1.0"
+    "@wilm-ai/wilma-client": "^1.7.1",
+    "zod": "^4.6.6"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "^2.1.2",