kimal3 0.9.2 → 0.9.3

package/coach/de/kimal3-coach.md

@@ -182,7 +182,7 @@ Das Board in der App zeigt nur, was du meldest: Wer nicht meldet, lässt eine Ka
   6. **`/k3plan`:** Specs gegen den Code prüfen und jede Abweichung einzeln melden — dort steht, wie. **Prüfen ist Arbeit:** Eine Story mit offenen Gegenproben (Spalte „Claude-Test offen“), die du gegen den Code prüfst, meldest du vorher als „in Arbeit“, mit `"pruefen":true` — so kommt die Karte dabei nicht ins Gespräch. Stories in „Dein Test“ oder „Fertig“ meldest du beim Abgleich nicht neu.
   7. **Feierabend:** den Tag abgleichen — dort steht, wie.
 
-  🔑 **Bleibt eine Story unfertig, wenn du aufhörst** (am Ende von `/k3plan` oder im Feierabend), meldest du sie mit `--ohne-sitzung` (`kimal3 plan melde --ohne-sitzung`): Ihr Plan-Stand bleibt `in_arbeit`, aber der Punkt am Projekt leuchtet nicht weiter, obwohl das Fenster offen bleibt — auf dem Board steht sie dann in „Offen“ als angefangen.
+  🔑 **Bleibt eine Story unfertig, wenn du aufhörst** (am Ende von `/k3plan` oder im Feierabend), meldest du sie mit `--ohne-sitzung` (`kimal3 plan melde --ohne-sitzung`): Ihr Plan-Stand bleibt `in_arbeit`, aber der Punkt am Projekt leuchtet nicht weiter, obwohl das Fenster offen bleibt — auf dem Board steht sie dann in „Plan“ als angefangen.
 
   „Gebaut“ meldest du erst nach einer Gegenprobe, die in dieser Sitzung gelaufen ist, nie aus dem Gedächtnis.
 - **Subagenten melden nie.** Der Mod erinnert nur dich, nicht sie: Du meldest „in Arbeit“ **vor** dem Auftrag an einen Subagenten, der

package/coach/en/kimal3-coach.md

@@ -181,7 +181,7 @@ The board in the app shows only what you report: if you don't, a card sits in "P
   6. **`/k3plan`:** check the specs against the code and report every deviation individually — it says how. **Checking is work:** a story with pending counter-checks (column "Claude test pending") that you check against the code, you report as "in progress" beforehand, with `"pruefen":true` — so the card doesn't come into discussion meanwhile. Stories under "Your test" or "Done" you do not report again during the reconciliation.
   7. **Wrap-up:** reconcile the day — it says how.
 
-  🔑 **If a story stays unfinished when you stop** (at the end of `/k3plan` or in the wrap-up), you report it with `--no-session` (`kimal3 plan report --no-session`): its plan state stays `in_arbeit`, but the dot at the project stops glowing although the window stays open — on the board it then sits under "Open" as started.
+  🔑 **If a story stays unfinished when you stop** (at the end of `/k3plan` or in the wrap-up), you report it with `--no-session` (`kimal3 plan report --no-session`): its plan state stays `in_arbeit`, but the dot at the project stops glowing although the window stays open — on the board it then sits in "Plan" as started.
 
   You report "built" only after a counter-check that ran in this session, never from memory.
 - **Subagents never report.** The mod reminds only you, not them: you report "in progress" **before** the job to a subagent that

package/dist/befehle/zeigen-einrichten.js

@@ -1,7 +1,8 @@
 import { existsSync } from "node:fs";
-import { dirname, win32 } from "node:path";
+import { platform } from "node:os";
+import { dirname, posix, win32 } from "node:path";
 import { zerlege } from "../argumente.js";
-import { AUFNEHMER_FASSUNG, aufnehmerArgumente, einrichtPlan, teileAus, uvEinrichtung, } from "../zeigen-rechnung.js";
+import { AUFNEHMER_FASSUNG, aufnehmerArgumente, aufnehmerOrte, einrichtPlan, teileAus, uvEinrichtung, } from "../zeigen-rechnung.js";
 import { LESEN_MS, aufnehmerPython, findeUv, rufeWerkzeug, stillAusfuehren, uvBinOrdner } from "../zeigen-umgebung.js";
 import { vorab } from "./zeigen.js";
 /**
@@ -21,19 +22,34 @@ const ZEIT_MODELL = 60 * MINUTE;
 /** Was jetzt da ist: uv (Suchpfad + bekannte Orte), und vom Aufnehmer selbst, was er hat. */
 function bestand() {
     const p = aufnehmerPython();
-    return { teile: teileAus(findeUv()?.uv ?? null, p === null ? null : rufeWerkzeug(p, ["teile"], null, LESEN_MS)), umgebungDa: p !== null };
+    return { teile: teileAus(findeUv()?.uv ?? null, p === null ? null : rufeWerkzeug(p, ["teile"], null, LESEN_MS), platform()), umgebungDa: p !== null };
+}
+/** Der Paketmanager fuer uv: Windows winget; Mac das erste brew, das antwortet (Apple-Silicon-, Intel-Ort, Suchpfad). */
+function paketmanager() {
+    if (platform() === "win32")
+        return stillAusfuehren("winget", ["--version"], LESEN_MS) ? "winget" : null; // kein-anzeigetext: Befehl
+    // kein-anzeigetext: Befehl
+    return ["/opt/homebrew/bin/brew", "/usr/local/bin/brew", "brew"].find((brew) => stillAusfuehren(brew, ["--version"], LESEN_MS)) ?? null;
 }
 function richteUvEin() {
-    const { befehl, argumente } = uvEinrichtung(stillAusfuehren("winget", ["--version"], LESEN_MS)); // kein-anzeigetext: Befehl
-    stillAusfuehren(befehl, argumente, ZEIT_UV);
+    const pm = paketmanager();
+    const { befehl, argumente, umgebung } = uvEinrichtung(platform(), pm);
+    stillAusfuehren(befehl, argumente, ZEIT_UV, umgebung);
     // Der Suchpfad dieser Sitzung ist noch der alte: findeUv sieht auch an den bekannten Orten nach.
+    if (findeUv() !== null)
+        return true;
+    // Mac: brew gescheitert (kein Schreibrecht, kein Netz fuer die Formel) -> einmal der offizielle Installer.
+    if (pm === null || platform() !== "darwin")
+        return false;
+    const ersatz = uvEinrichtung("darwin", null);
+    stillAusfuehren(ersatz.befehl, ersatz.argumente, ZEIT_UV, ersatz.umgebung);
     return findeUv() !== null;
 }
 function richteAufnehmerEin(umgebungDa) {
     const uv = findeUv();
     if (uv === null)
         return false;
-    stillAusfuehren(uv.uv, aufnehmerArgumente(umgebungDa), ZEIT_AUFNEHMER);
+    stillAusfuehren(uv.uv, aufnehmerArgumente(umgebungDa, platform()), ZEIT_AUFNEHMER);
     return bestand().teile.aufnehmer === AUFNEHMER_FASSUNG;
 }
 function richteFfmpegEin() {
@@ -42,9 +58,13 @@ function richteFfmpegEin() {
     if (uv === null || p === null)
         return false;
     const bin = uvBinOrdner(uv.uv);
-    // `capture.exe` liegt im Programmordner von uv und neben dem Python des Aufnehmers; der erste, den es gibt.
-    const capture = [bin === null ? null : win32.join(bin, "capture.exe"), win32.join(dirname(p.python), "capture.exe")] // kein-anzeigetext: Dateiname
-        .find((d) => d !== null && existsSync(d));
+    // `capture` liegt im Programmordner von uv und neben dem Python des Aufnehmers; der erste, den es gibt.
+    const system = platform();
+    const pfad = system === "win32" ? win32 : posix;
+    const namen = aufnehmerOrte(system, null, process.env, "").at(0)?.captureNamen ?? []; // Namen sind vom Ort unabhaengig
+    const capture = [bin, dirname(p.python)]
+        .flatMap((ordner) => (ordner === null ? [] : namen.map((n) => pfad.join(ordner, n))))
+        .find((d) => existsSync(d));
     if (capture === undefined)
         return false;
     stillAusfuehren(capture, ["install-ffmpeg"], ZEIT_FFMPEG); // kein-anzeigetext: Befehl

package/dist/befehle/zeigen-pruefen.js

@@ -0,0 +1,56 @@
+import { spawnSync } from "node:child_process";
+import { platform } from "node:os";
+import { zerlege } from "../argumente.js";
+import { EINSTELLUNGS_SEITE, freigabeApp, freigabeAus, freigabenAusgang } from "../zeigen-freigaben.js";
+import { LESEN_MS, aufnehmerPython, rufeWerkzeug } from "../zeigen-umgebung.js";
+import { freigabenZeilen } from "../texte/zeigen.js";
+import { vorab } from "./zeigen.js";
+/**
+ * `kimal3 zeigen pruefen` / `kimal3 show check` (Spec 2026-10-24-k3zeigen-mac-design.md, US-M3): welche der vier
+ * macOS-Freigaben fehlen. `--anfragen` laesst macOS fragen, `--oeffnen` oeffnet die Seite der Systemeinstellungen.
+ * 🔴 Vom Werkzeug werden nur Wahrheitswerte gelesen (`freigabenAusgang`); keine Zeile gibt etwas Fremdes weiter.
+ */
+const ANFRAGE_MS = 90_000; // macOS wartet auf den Klick des Menschen
+export async function zeigenPruefen(rest) {
+    const lage = vorab(rest, (t) => t.helpPruefen);
+    if (typeof lage === "number")
+        return lage;
+    const { s, t } = lage;
+    if (platform() === "win32") {
+        console.log(t.freigabenUnnoetig);
+        return 0;
+    }
+    const z = zerlege(rest, ["oeffnen", "anfragen"], s);
+    const oeffnen = z.ok ? z.werte.optionen.oeffnen : undefined;
+    const anfragen = z.ok ? z.werte.optionen.anfragen : undefined;
+    const oeffnenF = freigabeAus(oeffnen);
+    const anfragenF = freigabeAus(anfragen);
+    // Unbekannter Wert, beide Schalter zugleich oder ein Zerlegefehler: die Hilfe, nichts wird getan.
+    if (!z.ok || (oeffnen !== undefined && oeffnenF === null) || (anfragen !== undefined && anfragenF === null)
+        || (oeffnen !== undefined && anfragen !== undefined)) {
+        console.error(`${z.ok ? "" : `${z.meldung}\n`}${t.helpPruefen}`);
+        return 1;
+    }
+    // Oeffnen braucht den Aufnehmer nicht und prueft danach nicht.
+    if (oeffnenF !== null) {
+        const r = spawnSync("open", [EINSTELLUNGS_SEITE[oeffnenF]], { stdio: "ignore" }); // kein-anzeigetext: macOS-Programm
+        if (r.error !== undefined || r.status !== 0) {
+            console.error(t.freigabeNichtGeoeffnet);
+            return 1;
+        }
+        console.log(t.freigabeGeoeffnet(t.freigabeName[oeffnenF]));
+        return 0;
+    }
+    const p = aufnehmerPython();
+    if (p === null) {
+        console.error(t.nichtEingerichtet);
+        return 1;
+    }
+    const antwort = anfragenF === null
+        ? rufeWerkzeug(p, ["freigaben"], null, LESEN_MS)
+        : rufeWerkzeug(p, ["freigaben", "--anfragen", anfragenF], null, ANFRAGE_MS);
+    const { stand } = freigabenAusgang(antwort);
+    const { zeilen, code } = freigabenZeilen(t, freigabeApp(process.env), stand);
+    (code === 0 ? console.log : console.error)(zeilen.join("\n"));
+    return code;
+}

package/dist/befehle/zeigen-start.js

@@ -1,9 +1,11 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { platform } from "node:os";
 import { join } from "node:path";
 import { trenneNamenUndOptionen, zerlege } from "../argumente.js";
-import { einrichtPlan, fehlerGrund } from "../zeigen-rechnung.js";
+import { nenntProtokoll } from "../zeigen-freigaben.js";
+import { einrichtPlan, fehlerGrund, teileAus } from "../zeigen-rechnung.js";
 import { LESEN_MS, aufnehmerPython, leseStarter, rufeWerkzeug, schreibeNotiz, starteStarter, starterFakt, uvFassung } from "../zeigen-umgebung.js";
-import { ermittleZustand, grundSatz, gueltigeFassung, ortHier, uhrzeit, vorab, zeigeOrdner } from "./zeigen.js";
+import { ermittleZustand, grundSatz, ortHier, uhrzeit, vorab, zeigeOrdner } from "./zeigen.js";
 /**
  * `kimal3 zeigen start "<Satz>" [--hoechstens N]` (Spec US-3, US-4, US-5). Reihenfolge: Ort -> laeuft schon etwas? ->
  * eingerichtet? -> Ordner -> Starter abgehaengt -> warten, bis er "laeuft, Sitzung …" meldet.
@@ -81,12 +83,8 @@ export async function zeigenStart(rest) {
         }
     }
     const teile = p === null ? null : rufeWerkzeug(p, ["teile"], null, LESEN_MS);
-    const fehlt = !teile?.ok || einrichtPlan({
-        uv: uvFassung(),
-        aufnehmer: gueltigeFassung(teile.daten.aufnehmer),
-        ffmpeg: teile.daten.ffmpeg === true,
-        modell: teile.daten.modell === true,
-    }).length > 0;
+    // teileAus: auf dem Mac zaehlt ein Aufnehmer ohne AVFoundation als nicht eingerichtet (Spec US-M2)
+    const fehlt = !teile?.ok || einrichtPlan(teileAus(uvFassung(), teile, platform())).length > 0;
     if (p === null || fehlt) {
         console.error(t.nichtEingerichtet);
         return 1;
@@ -125,8 +123,8 @@ export async function zeigenStart(rest) {
         /* ohne Bremse meldet unten "nicht bestaetigt" */
     }
     bericht = await warteAufStarter(ordner, WARTEN_ENDE_MS, (f) => f !== null && !laeuftNoch(f.zustand));
-    const grund = bericht?.grund ?? fehlerGrund(liesProtokoll(protokoll));
-    console.error(t.nichtGestartet(grundSatz(t, grund), protokoll));
+    const grund = bericht?.grund ?? fehlerGrund(liesProtokoll(protokoll), platform());
+    console.error(nenntProtokoll(grund) ? t.nichtGestartet(grundSatz(t, grund), protokoll) : t.nichtGestartetOhneProtokoll(grundSatz(t, grund)));
     // Ohne Bericht (Starter nie angelaufen) ist das Ende genauso wenig bestaetigt wie bei "laeuft noch".
     if (bericht === null || laeuftNoch(bericht.zustand) || bericht.grund === "nicht-beendet")
         console.error(t.endeUnbestaetigt);

package/dist/befehle/zeigen.js

@@ -1,10 +1,11 @@
 import { existsSync } from "node:fs";
-import { platform } from "node:os";
+import { platform, release } from "node:os";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { schalterOhneWert, trenneNamenUndOptionen, zerlege } from "../argumente.js";
 import { sprache } from "../sprache.js";
+import { freigabeApp } from "../zeigen-freigaben.js";
 import { ZEIGEN_TEXTE } from "../texte/zeigen.js";
-import { AUFNEHMER_FASSUNG, aufnahmeOrt, aufnahmeZustand, bildName, dauerText, gueltigeFassung, starterLebt, stoppAusgang, zeitAusText, zustandOhneAufnehmer, } from "../zeigen-rechnung.js";
+import { AUFNEHMER_FASSUNG, aufnahmeOrt, aufnahmeZustand, bildName, dauerText, gueltigeFassung, macosFassung, starterLebt, stoppAusgang, teileAus, zeitAusText, zustandOhneAufnehmer, } from "../zeigen-rechnung.js";
 import { LESEN_MS, STOPPEN_MS, aufnehmerPython, juengsterOrdner, leseNotiz, leseStarter, loescheNotiz, rufeWerkzeug, starterFakt, uvFassung, } from "../zeigen-umgebung.js";
 /** `--help` (auch auf dem Mac), dann die Plattform. Eine Zahl = fertig, sonst die Lage fuer den Befehl. */
 export function vorab(rest, hilfe) {
@@ -14,8 +15,17 @@ export function vorab(rest, hilfe) {
         console.log(hilfe(t));
         return 0;
     }
-    if (platform() !== "win32") {
-        console.error(t.nurWindows);
+    const system = platform();
+    if (system === "win32")
+        return { s, t };
+    if (system !== "darwin") {
+        console.error(t.nurWindowsUndMac);
+        return 1;
+    }
+    // Mindestens macOS 13 (Darwin-Kern 22); ist die Fassung nicht lesbar, sagt der Satz es ohne Zahl und lehnt ab.
+    const mac = macosFassung(release());
+    if (mac === null || mac < 13) {
+        console.error(t.macZuAlt(mac));
         return 1;
     }
     return { s, t };
@@ -38,8 +48,6 @@ export function uhrzeit(sek) {
 export function grundSatz(t, code) {
     return typeof code === "string" && Object.hasOwn(t.gruende, code) ? t.gruende[code] : t.gruende.unbekannt;
 }
-/** Wohnt seit Task 5 in `zeigen-rechnung.ts` (auch `einrichten` braucht sie); hier weitergereicht fuer `start`. */
-export { gueltigeFassung };
 const istZahl = (w) => typeof w === "number" && Number.isFinite(w);
 const istZaehlung = (w) => istZahl(w) && Number.isInteger(w) && w >= 0;
 /**
@@ -95,8 +103,10 @@ export async function zeigenStatus(rest) {
         zeilen.push(t.teilUnbekannt("aufnehmer"), t.teilUnbekannt("ffmpeg"), t.teilUnbekannt("modell"));
     else {
         const roh = teile.daten.aufnehmer;
-        const f = gueltigeFassung(roh);
-        zeilen.push(roh === null ? t.aufnehmerFehlt
+        // Ueber teileAus: Auf dem Mac gilt ein Aufnehmer ohne AVFoundation als nicht eingerichtet (Spec US-M2) -> "fehlt".
+        // Unter Windows ist f genau gueltigeFassung(roh), die Ausgabe also wie bisher.
+        const f = teileAus(null, teile, platform()).aufnehmer;
+        zeilen.push(roh === null || (f === null && gueltigeFassung(roh) !== null) ? t.aufnehmerFehlt
             : f === null ? t.teilUnbekannt("aufnehmer")
                 : f === AUFNEHMER_FASSUNG ? t.aufnehmerDa(f) : t.aufnehmerAlt(f, AUFNEHMER_FASSUNG));
         zeilen.push(t.ffmpeg(teile.daten.ffmpeg === true), t.modell(teile.daten.modell === true));
@@ -127,6 +137,8 @@ export async function zeigenStatus(rest) {
         if (ordner !== null && zustand.letzte === "abgebrochen")
             zeilen.push(t.letzteAbgebrochen(zeigeOrdner(ordner, ort)));
     }
+    if (platform() === "darwin")
+        zeilen.push(t.freigabenGehenAn(freigabeApp(process.env)));
     if (ort.art === "ort")
         zeilen.push(t.ortHier(ort.aufnahmen));
     else

package/dist/befehle-katalog-en.js

@@ -158,7 +158,7 @@ export const BEFEHLE_EN = {
         ],
     },
     "kimal3 zeigen start": {
-        stempel: "35a185f9",
+        stempel: "39dd03bd",
         befehl: "kimal3 show start",
         tippen: "/k3show",
         terminal: 'kimal3 show start "Send the open quotes to my boss every Monday"',
@@ -168,11 +168,11 @@ export const BEFEHLE_EN = {
             "You do a task once on screen and say out loud what you are doing and why. Claude guides you through it: first the briefing on what gets recorded, then the recording, then the evaluation on your computer.",
             "All screens, sound, clicks and keys are recorded — so don't type a password. The recording lies in the project under material/aufnahmen/ and never ends up in Git; it stops by itself after 15 minutes at the latest.",
             "Claude asks you before reading any of it: only after your yes does the timeline go to Anthropic. At the end the task is written down in the project's plan folder, and Claude suggests deleting the recording.",
-            "Windows-only for now.",
+            "Windows and Mac (macOS 13 or later). On the Mac, Claude first checks the four macOS permissions.",
         ],
     },
     "kimal3 zeigen status": {
-        stempel: "7ebd2b8f",
+        stempel: "5d79830b",
         befehl: "kimal3 show status",
         tippen: "! kimal3 show status",
         terminal: "kimal3 show status",
@@ -181,7 +181,7 @@ export const BEFEHLE_EN = {
         details: [
             "Shows two blocks: what is set up (uv, recorder, FFmpeg, speech model) and whether a recording of your screen is running — with start time, folder and the time at which it stops by itself at the latest.",
             "If it can't tell whether something is being recorded, it says exactly that, with exit code 1 — it then never claims that nothing is running.",
-            "It only reads and changes nothing. Windows-only for now.",
+            "It only reads and changes nothing. Windows and Mac (macOS 13 or later).",
         ],
     },
     "kimal3 wache": {

package/dist/befehle-katalog.js

@@ -222,7 +222,7 @@ export const BEFEHLE = [
             "Du machst eine Aufgabe einmal am Bildschirm vor und sagst dabei laut, was du tust und warum. Claude führt dich durch: vorher die Ansage, was aufgenommen wird, dann die Aufnahme, danach das Auswerten auf deinem Rechner.",
             "Aufgenommen werden alle Bildschirme, Ton, Klicks und Tasten — tippe deshalb kein Passwort. Die Aufnahme liegt im Projekt unter material/aufnahmen/ und landet nie in Git; spätestens nach 15 Minuten stoppt sie von selbst.",
             "Bevor Claude etwas davon liest, fragt er dich: Erst nach deinem Ja geht die Zeitleiste an Anthropic. Am Ende steht die Aufgabe in plan/aufgabe-vorgefuehrt.md, und Claude schlägt vor, die Aufnahme zu löschen.",
-            "Gibt es bisher nur unter Windows.",
+            "Für Windows und den Mac (ab macOS 13). Auf dem Mac prüft Claude vorher die vier Freigaben von macOS.",
         ],
     },
     {
@@ -235,7 +235,7 @@ export const BEFEHLE = [
         details: [
             "Zeigt zwei Blöcke: was eingerichtet ist (uv, Aufnehmer, FFmpeg, Sprachmodell) und ob gerade eine Aufnahme von deinem Bildschirm läuft — mit Startzeit, Ordner und der Uhrzeit, zu der sie spätestens von selbst stoppt.",
             "Kann es nicht feststellen, ob aufgenommen wird, sagt es genau das, mit Rückgabewert 1 — es behauptet dann nie, dass nichts läuft.",
-            "Es liest nur und ändert nichts. Gibt es bisher nur unter Windows.",
+            "Es liest nur und ändert nichts. Für Windows und den Mac (ab macOS 13).",
         ],
     },
     /*

package/dist/befehlswoerter.js

@@ -29,6 +29,7 @@ export const BEFEHLSWOERTER = {
     "zeigen auswerten": { de: "zeigen auswerten", en: "show evaluate" }, // kein-anzeigetext: Befehlswörter (Spec k3zeigen)
     "zeigen bild": { de: "zeigen bild", en: "show picture" }, // kein-anzeigetext: Befehlswörter (Spec k3zeigen)
     "zeigen status": { de: "zeigen status", en: "show status" }, // kein-anzeigetext: Befehlswörter (Spec k3zeigen)
+    "zeigen pruefen": { de: "zeigen pruefen", en: "show check" }, // kein-anzeigetext: Befehlswörter (Spec k3zeigen-mac)
 };
 /**
  * Welcher Befehl steht vorne in `argv` -- und was bleibt dahinter?
@@ -78,6 +79,9 @@ export const SCHALTER_EN = {
     "at-most": "hoechstens",
     language: "sprache",
     "without-typed": "ohne-getipptes",
+    // `kimal3 show check` (Spec 2026-10-24-k3zeigen-mac-design.md)
+    open: "oeffnen",
+    ask: "anfragen",
     // `kimal3 plan upload` (Spec 2026-10-21-projektseite-planung, US-11); `--overwrite` steht schon oben.
     "dry-run": "probe",
     // `kimal3 project connect` (Board in Echtzeit, Task 7)

package/dist/kimal3.js

@@ -45,6 +45,7 @@ import { projektVerbinden } from "./befehle/projekt-verbinden.js";
 import { skillDatei, skillInstallBefehl } from "./befehle/skill-install.js";
 import { wache, wacheSchalten } from "./befehle/wache.js";
 import { zeigenAuswerten, zeigenBild, zeigenStatus, zeigenStopp } from "./befehle/zeigen.js";
+import { zeigenPruefen } from "./befehle/zeigen-pruefen.js";
 import { zeigenStart } from "./befehle/zeigen-start.js";
 import { zeigenEinrichten } from "./befehle/zeigen-einrichten.js";
 /** Eine Meldung pro Programmlauf -- s. "Einmal-Riegel" im Block darunter. */
@@ -527,6 +528,7 @@ async function fuehreAus(name, rest) {
         case "zeigen auswerten": return zeigenAuswerten(rest);
         case "zeigen bild": return zeigenBild(rest);
         case "zeigen status": return zeigenStatus(rest);
+        case "zeigen pruefen": return zeigenPruefen(rest);
         case "wache an": return allein ? wacheSchalten(true) : null;
         case "wache aus": return allein ? wacheSchalten(false) : null;
         case "wache":

package/dist/texte/zeigen.js

@@ -1,15 +1,21 @@
+import { FREIGABEN } from "../zeigen-freigaben.js";
 const TEIL_DE = { aufnehmer: "Aufnehmer", ffmpeg: "FFmpeg", modell: "Sprachmodell" };
 const TEIL_EN = { aufnehmer: "Recorder", ffmpeg: "FFmpeg", modell: "Speech model" };
 const SCHRITT_DE = { uv: "uv", ...TEIL_DE };
 const SCHRITT_EN = { uv: "uv", aufnehmer: "recorder", ffmpeg: "FFmpeg", modell: "speech model" };
 const mehrzahl = (n, eins, viele) => `${n} ${n === 1 ? eins : viele}`;
 const de = {
-    nurWindows: "`kimal3 zeigen` gibt es bisher nur unter Windows; der Mac folgt.",
+    nurWindowsUndMac: "`kimal3 zeigen` gibt es für Windows und den Mac.",
+    macZuAlt: (n) => `Für Aufnahmen braucht es macOS 13 oder neuer${n === null ? "" : ` — dieser Mac hat macOS ${n}`}.`,
+    freigabenGehenAn: (app) => `Freigaben gehen an: ${app.art === "claude-app" ? "Claude (Desktop-App)"
+        : app.art === "ssh" ? "niemanden — über SSH kann macOS keine Freigaben geben"
+            : app.art === "terminal" && app.name !== null ? app.name : "die App, aus der du Claude gestartet hast"}`,
     helpStatus: "\n  kimal3 zeigen status\n\n  Zeigt, ob der Aufnehmer eingerichtet ist und ob gerade aufgenommen wird.\n  Liest nur, ändert nichts.\n",
     helpStart: "\n  kimal3 zeigen start \"<deine Aufgabe in einem Satz>\" [--hoechstens <minuten>]\n\n  Startet eine Aufnahme von Bildschirm, Ton, Klicks und Tasten im Ordner\n  material/aufnahmen/ deines Projekts. Sie stoppt spätestens nach 15 Minuten\n  von selbst (--hoechstens: weniger, 1 bis 15).\n",
     helpStopp: "\n  kimal3 zeigen stopp\n\n  Stoppt die laufende Aufnahme und nennt nur Zahlen: Dauer, Klicks, Tasten, Ton.\n",
     helpAuswerten: "\n  kimal3 zeigen auswerten [<ordner>] [--sprache de|en] [--ohne-getipptes]\n\n  Macht aus der Aufnahme auf diesem Rechner eine Zeitleiste (zeitleiste.md):\n  was gesagt, geklickt und getippt wurde. Ohne Ordner: die jüngste Aufnahme\n  des Projekts. --ohne-getipptes lässt alles Getippte aus.\n",
     helpBild: "\n  kimal3 zeigen bild <m:ss> [<ordner>]\n\n  Legt ein Bildschirmfoto der Aufnahme zu diesem Zeitpunkt in bilder/ ab\n  (höchstens 1600 Pixel breit). Ohne Ordner: die jüngste Aufnahme des Projekts.\n",
+    helpPruefen: "\n  kimal3 zeigen pruefen\n  kimal3 zeigen pruefen --anfragen <bildschirm|eingabe|bedienungshilfen|mikrofon>\n  kimal3 zeigen pruefen --oeffnen <bildschirm|eingabe|bedienungshilfen|mikrofon>\n\n  Nur auf dem Mac: zeigt, welche der vier Freigaben für Aufnahmen da sind.\n  --anfragen lässt macOS nach einer Freigabe fragen, --oeffnen öffnet ihre Seite\n  in den Systemeinstellungen. Unter Windows braucht es keine.\n",
     helpEinrichten: "\n  kimal3 zeigen einrichten\n\n  Richtet einmal ein, was für Aufnahmen fehlt: uv, den Aufnehmer, FFmpeg und das\n  Sprachmodell (zusammen etwa 2,1 GB). Nur in deinem Benutzerordner, ohne\n  Adminrechte. Was schon da ist, wird nicht noch einmal geladen.\n",
     schrittUv: "uv wird eingerichtet …",
     schrittAufnehmer: (fassung) => `Aufnehmer ${fassung} wird eingerichtet …`,
@@ -48,6 +54,7 @@ const de = {
     ordnerNichtAnlegbar: (ordner) => `Den Aufnahmeordner kann ich nicht anlegen: ${ordner}`,
     laeuftJetzt: (ordner, ende) => `Die Aufnahme läuft (Ordner \`${ordner}\`), stoppt spätestens um ${ende}.`,
     nichtGestartet: (grund, protokoll) => `Die Aufnahme ist nicht gestartet: ${grund}. Protokoll: ${protokoll}`,
+    nichtGestartetOhneProtokoll: (grund) => `Die Aufnahme ist nicht gestartet: ${grund}.`,
     endeUnbestaetigt: "Ob der Aufnehmer noch läuft, sagt `kimal3 zeigen status`.",
     keineAufnahmeLaeuft: "Es läuft keine Aufnahme.",
     zahlen: (dauer, klicks, tasten, ton) => `${dauer} Minuten, ${mehrzahl(klicks, "Klick", "Klicks")}, ${mehrzahl(tasten, "Taste", "Tasten")}, ${ton ? "Ton ist da" : "kein Ton"}.`,
@@ -74,6 +81,15 @@ const de = {
     zeitFalsch: (wert) => `„${wert}" verstehe ich nicht als Zeitpunkt — bitte so: 0:26 oder 1:02:05.`,
     bildFertig: (datei) => `Bild: ${datei}`,
     bildFehler: (grund) => `Das Bild ist nicht entstanden: ${grund}.`,
+    freigabenUnnoetig: "Unter Windows braucht es keine Freigaben.",
+    freigabeAppName: (app) => (app.art === "claude-app" || app.art === "terminal") && app.name !== null ? app.name : "diese App",
+    freigabenAlleDa: (app) => `Alle vier Freigaben für ${app} sind da.`,
+    freigabenKopf: (app) => `Freigaben für ${app}:`,
+    freigabeName: { bildschirm: "Bildschirm- & Systemaudioaufnahme", eingabe: "Eingabeüberwachung", bedienungshilfen: "Bedienungshilfen", mikrofon: "Mikrofon" },
+    freigabeStand: { da: "da", fehlt: "fehlt", unbekannt: "kann ich nicht feststellen" },
+    freigabenUnbekannt: "Ob die Freigaben da sind, kann ich nicht feststellen.",
+    freigabeGeoeffnet: (name) => `Ich habe ‚${name}' in den Systemeinstellungen geöffnet.`,
+    freigabeNichtGeoeffnet: "Die Systemeinstellungen ließen sich nicht öffnen.",
     gruende: {
         "ffmpeg-fehlt": "FFmpeg fehlt — `kimal3 zeigen einrichten` holt es",
         "kein-mikrofon": "ich finde kein Mikrofon",
@@ -92,16 +108,25 @@ const de = {
         unvollstaendig: "das Sprachmodell ist nicht vollständig angekommen",
         "ordner-fehlt": "der Aufnahmeordner fehlt",
         "schreiben-gescheitert": "die Zeitleiste ließ sich nicht schreiben",
+        "freigabe-bildschirm": "es fehlt die Freigabe Bildschirm- & Systemaudioaufnahme — `kimal3 zeigen pruefen` zeigt, was fehlt",
+        "freigabe-eingabe": "es fehlt die Freigabe Eingabeüberwachung — `kimal3 zeigen pruefen` zeigt, was fehlt",
+        "freigabe-bedienungshilfen": "es fehlt die Freigabe Bedienungshilfen — `kimal3 zeigen pruefen` zeigt, was fehlt",
+        "abgriff-abgeschaltet": "macOS hat das Mitlesen von Maus und Tastatur abgeschaltet — eine neue Aufnahme hilft meist",
         unbekannt: "den Grund kenne ich nicht",
     },
 };
 const en = {
-    nurWindows: "`kimal3 show` is Windows-only for now; the Mac follows.",
+    nurWindowsUndMac: "`kimal3 show` is available on Windows and the Mac.",
+    macZuAlt: (n) => `Recording needs macOS 13 or later${n === null ? "" : ` — this Mac has macOS ${n}`}.`,
+    freigabenGehenAn: (app) => `Permissions go to: ${app.art === "claude-app" ? "Claude (desktop app)"
+        : app.art === "ssh" ? "nobody — macOS can't grant permissions over SSH"
+            : app.art === "terminal" && app.name !== null ? app.name : "the app you started Claude from"}`,
     helpStatus: "\n  kimal3 show status\n\n  Shows whether the recorder is set up and whether a recording is running.\n  Only reads, changes nothing.\n",
     helpStart: "\n  kimal3 show start \"<your task in one sentence>\" [--at-most <minutes>]\n\n  Starts a recording of screen, sound, clicks and keys in your project's\n  material/aufnahmen/ folder. It stops by itself after 15 minutes at the latest\n  (--at-most: less, 1 to 15).\n",
     helpStopp: "\n  kimal3 show stop\n\n  Stops the running recording and reports numbers only: length, clicks, keys, sound.\n",
     helpAuswerten: "\n  kimal3 show evaluate [<folder>] [--language de|en] [--without-typed]\n\n  Turns the recording into a timeline on this computer (zeitleiste.md):\n  what was said, clicked and typed. Without a folder: the project's latest\n  recording. --without-typed leaves out everything typed.\n",
     helpBild: "\n  kimal3 show picture <m:ss> [<folder>]\n\n  Saves a screenshot of the recording at that moment in bilder/\n  (at most 1600 pixels wide). Without a folder: the project's latest recording.\n",
+    helpPruefen: "\n  kimal3 show check\n  kimal3 show check --ask <screen|input|accessibility|microphone>\n  kimal3 show check --open <screen|input|accessibility|microphone>\n\n  Mac only: shows which of the four permissions for recordings are in place.\n  --ask makes macOS ask for a permission, --open opens its page in System\n  Settings. Windows needs none.\n",
     helpEinrichten: "\n  kimal3 show setup\n\n  Sets up once what recordings still need: uv, the recorder, FFmpeg and the\n  speech model (about 2.1 GB together). Only in your user folder, no admin\n  rights. Whatever is already there isn't downloaded again.\n",
     schrittUv: "Setting up uv …",
     schrittAufnehmer: (fassung) => `Setting up recorder ${fassung} …`,
@@ -140,6 +165,7 @@ const en = {
     ordnerNichtAnlegbar: (ordner) => `I can't create the recording folder: ${ordner}`,
     laeuftJetzt: (ordner, ende) => `The recording is running (folder \`${ordner}\`), stops at ${ende} at the latest.`,
     nichtGestartet: (grund, protokoll) => `The recording didn't start: ${grund}. Log: ${protokoll}`,
+    nichtGestartetOhneProtokoll: (grund) => `The recording didn't start: ${grund}.`,
     endeUnbestaetigt: "Whether the recorder is still running: `kimal3 show status`.",
     keineAufnahmeLaeuft: "No recording is running.",
     zahlen: (dauer, klicks, tasten, ton) => `${dauer} minutes, ${klicks} ${klicks === 1 ? "click" : "clicks"}, ${tasten} ${tasten === 1 ? "key" : "keys"}, ${ton ? "audio present" : "no audio"}.`,
@@ -165,6 +191,15 @@ const en = {
     zeitFalsch: (wert) => `I don't understand “${wert}” as a point in time — please like this: 0:26 or 1:02:05.`,
     bildFertig: (datei) => `Picture: ${datei}`,
     bildFehler: (grund) => `The picture wasn't created: ${grund}.`,
+    freigabenUnnoetig: "Windows needs no permissions.",
+    freigabeAppName: (app) => (app.art === "claude-app" || app.art === "terminal") && app.name !== null ? app.name : "this app",
+    freigabenAlleDa: (app) => `All four permissions for ${app} are in place.`,
+    freigabenKopf: (app) => `Permissions for ${app}:`,
+    freigabeName: { bildschirm: "Screen & System Audio Recording", eingabe: "Input Monitoring", bedienungshilfen: "Accessibility", mikrofon: "Microphone" },
+    freigabeStand: { da: "in place", fehlt: "missing", unbekannt: "can't tell" },
+    freigabenUnbekannt: "I can't tell whether the permissions are in place.",
+    freigabeGeoeffnet: (name) => `I opened ‘${name}’ in System Settings.`,
+    freigabeNichtGeoeffnet: "System Settings couldn't be opened.",
     gruende: {
         "ffmpeg-fehlt": "FFmpeg is missing — `kimal3 show setup` gets it",
         "kein-mikrofon": "I can't find a microphone",
@@ -183,7 +218,24 @@ const en = {
         unvollstaendig: "the speech model didn't arrive completely",
         "ordner-fehlt": "the recording folder is missing",
         "schreiben-gescheitert": "the timeline could not be written",
+        "freigabe-bildschirm": "the Screen & System Audio Recording permission is missing — `kimal3 show check` shows what's missing",
+        "freigabe-eingabe": "the Input Monitoring permission is missing — `kimal3 show check` shows what's missing",
+        "freigabe-bedienungshilfen": "the Accessibility permission is missing — `kimal3 show check` shows what's missing",
+        "abgriff-abgeschaltet": "macOS switched off reading the mouse and keyboard — a new recording usually helps",
         unbekannt: "I don't know the reason",
     },
 };
 export const ZEIGEN_TEXTE = { de, en };
+/**
+ * Die Ausgabe von `kimal3 zeigen pruefen` ohne Schalter, rein aus Stand und Saetzen. `code` 0 nur, wenn alle vier da sind;
+ * "weiss nicht" (auch bei einzelnen) ist nie "da". Alle vier unbekannt -> ein Satz statt vier gleicher Zeilen.
+ */
+export function freigabenZeilen(t, app, stand) {
+    const name = t.freigabeAppName(app);
+    if (FREIGABEN.every((f) => stand[f] === "da"))
+        return { zeilen: [t.freigabenAlleDa(name)], code: 0 };
+    if (FREIGABEN.every((f) => stand[f] === "unbekannt"))
+        return { zeilen: [t.freigabenUnbekannt], code: 1 };
+    const breite = Math.max(...FREIGABEN.map((f) => t.freigabeName[f].length));
+    return { zeilen: [t.freigabenKopf(name), ...FREIGABEN.map((f) => `  ${t.freigabeName[f].padEnd(breite)}  ${t.freigabeStand[stand[f]]}`)], code: 1 };
+}

package/dist/zeigen-freigaben.js

@@ -0,0 +1,65 @@
+/** In dieser Reihenfolge werden sie geprueft und gezeigt. */
+export const FREIGABEN = ["bildschirm", "eingabe", "bedienungshilfen", "mikrofon"]; // kein-anzeigetext: Schluessel
+// Beide Wortsaetze gelten in beiden Sprachen (wie die Befehlswoerter: der Mensch soll nicht an der Sprache scheitern).
+const WERTE = {
+    bildschirm: "bildschirm", eingabe: "eingabe", bedienungshilfen: "bedienungshilfen", mikrofon: "mikrofon", // kein-anzeigetext: Schalterwerte
+    screen: "bildschirm", input: "eingabe", accessibility: "bedienungshilfen", microphone: "mikrofon", // kein-anzeigetext: Schalterwerte
+};
+/** Wert von `--oeffnen`/`--anfragen` -> Freigabe; unbekannt (auch "constructor") -> null. */
+export const freigabeAus = (w) => (w !== undefined && Object.hasOwn(WERTE, w) ? WERTE[w] : null);
+/** Nennt die Absage von `start` das Protokoll? Nicht bei einer fehlenden Freigabe: Die prueft der Starter, bevor er es anlegt. */
+export const nenntProtokoll = (grund) => !(typeof grund === "string" && grund.startsWith("freigabe-")); // kein-anzeigetext: Code-Anfang
+/**
+ * Die Antwort von `werkzeug.py freigaben` -> Stand je Freigabe. Nur ein echtes `true` heisst "da", nur ein echtes
+ * `false` "fehlt"; alles andere (null, Zahl, "ja", fehlender Schluessel, kaputte Antwort) heisst "weiss nicht" --
+ * nie "da" (Ein Fehlschlag sieht nie aus wie ein Erfolg).
+ */
+export function freigabenAusgang(antwort) {
+    const roh = antwort.ok ? antwort.daten.freigaben : undefined;
+    const quelle = roh !== null && typeof roh === "object" && !Array.isArray(roh) ? roh : {};
+    const von = (w) => (w === true ? "da" : w === false ? "fehlt" : "unbekannt");
+    const stand = {
+        bildschirm: von(quelle.bildschirm), eingabe: von(quelle.eingabe),
+        bedienungshilfen: von(quelle.bedienungshilfen), mikrofon: von(quelle.mikrofon),
+    };
+    return { stand, alleDa: FREIGABEN.every((f) => stand[f] === "da") };
+}
+const BUENDEL = {
+    "com.apple.Terminal": "Terminal", // kein-anzeigetext: App-Name
+    "com.googlecode.iterm2": "iTerm", // kein-anzeigetext: App-Name
+    "com.microsoft.VSCode": "Visual Studio Code", // kein-anzeigetext: App-Name
+    "com.todesktop.230313mzl4w4u92": "Cursor", // kein-anzeigetext: App-Name
+    "dev.warp.Warp-Stable": "Warp", // kein-anzeigetext: App-Name
+    "com.mitchellh.ghostty": "Ghostty", // kein-anzeigetext: App-Name
+};
+const TERM_PROGRAMM = {
+    Apple_Terminal: "Terminal", // kein-anzeigetext: App-Name
+    "iTerm.app": "iTerm", // kein-anzeigetext: App-Name
+    vscode: "Visual Studio Code", // kein-anzeigetext: App-Name
+    WarpTerminal: "Warp", // kein-anzeigetext: App-Name
+    ghostty: "Ghostty", // kein-anzeigetext: App-Name
+};
+const CLAUDE_APP = "com.anthropic.claudefordesktop"; // kein-anzeigetext: Bundle-ID
+/** Erkennt aus den Umgebungsvariablen, welches Programm die Freigabe braucht. Reihenfolge: Bundle-ID, SSH, TERM_PROGRAM, Claude-App. */
+export function freigabeApp(env) {
+    const buendel = env.__CFBundleIdentifier;
+    if (buendel === CLAUDE_APP)
+        return { art: "claude-app", name: "Claude" }; // kein-anzeigetext: App-Name
+    if (buendel !== undefined && Object.hasOwn(BUENDEL, buendel))
+        return { art: "terminal", name: BUENDEL[buendel] };
+    if (env.SSH_CONNECTION)
+        return { art: "ssh", name: null };
+    const term = env.TERM_PROGRAM;
+    if (term !== undefined && Object.hasOwn(TERM_PROGRAMM, term))
+        return { art: "terminal", name: TERM_PROGRAMM[term] };
+    if (env.CLAUDE_CODE_ENTRYPOINT === "claude-desktop")
+        return { art: "claude-app", name: "Claude" }; // kein-anzeigetext: App-Name
+    return { art: "unbekannt", name: null };
+}
+/** Die Seite der Systemeinstellungen, auf der man die Freigabe erteilt. */
+export const EINSTELLUNGS_SEITE = {
+    bildschirm: "x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenCapture", // kein-anzeigetext: Systemadresse
+    eingabe: "x-apple.systempreferences:com.apple.preference.security?Privacy_ListenEvent", // kein-anzeigetext: Systemadresse
+    bedienungshilfen: "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility", // kein-anzeigetext: Systemadresse
+    mikrofon: "x-apple.systempreferences:com.apple.preference.security?Privacy_Microphone", // kein-anzeigetext: Systemadresse
+};