@groeponline/pi-wishcraft 0.21.0 → 0.22.0

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## [Unreleased]
 
+## [0.22.0] - 2026-08-20
+
+### Added
+- `/tps` overlay reads the same 1s/5s ring as the segment; `/usage` shows session / today / week from `wishcraft-usage.json`.
+- Rest of the tool-input repairs on custom tools: JSON-string arrays, `{}` placeholders, bare-string wrap, and path aliases.
+- README hook examples (bash-guard, write-audit, SessionStart git-status) plus `wishcraft.hooksEnabled` kill-switch docs.
+- Overlay type-to-filter uses substring on label, value, and description.
+- `wishcraft.tokenBudget.daily` colours the cost segment at 80%/100% and warns on welcome; it never blocks.
+
 ## [0.21.0] - 2026-08-20
 
 ### Added

package/README.md

@@ -248,6 +248,7 @@ Define your own preset in settings; it merges over built-ins and is selectable v
 Interactivity (Pi core renders the footer as static text, so live click is not possible; actions live in commands and a navigable overlay):
 
 - `/tps [value]`: show or set `POWERLINE_TPS`
+- `/usage`: today / week / session token overlay (same ledger as the cost segment)
 - `/open-ports`: list listening ports and pick one
 - `alt+p`: **powerline menu**: three overlays (Navigate, Configure, Status). Status drills down to ports, TPS, and toggle.
 - `alt+i`: **powerline info**: full open-ports list
@@ -474,6 +475,86 @@ Browse and insert your installed skills (`SKILL.md` files and `*.md`/`*.txt` pro
 
 The manager reuses the same skill discovery as inline `/command`/`$skill` triggers, so anything you can inline you can also browse and insert manually.
 
+## Hooks (harness)
+
+Wishcraft can run Command Code-style hooks on Pi's native events (`tool_call`, `tool_result`, `session_start`, `turn_end`). Each hook is a command that reads JSON on stdin. Set `wishcraft.hooksEnabled` to `false` to kill-switch every hook without deleting the config. Hook *definitions* are read from the global agent settings file only (project `.pi/settings.json` cannot install new commands).
+
+Put the scripts somewhere executable (example: `~/.pi/agent/hooks/`) and point settings at them:
+
+```json
+{
+  "wishcraft": {
+    "hooksEnabled": true,
+    "hooks": {
+      "preToolUse": [
+        {
+          "matcher": "bash",
+          "hooks": [{ "command": "~/.pi/agent/hooks/bash-guard.sh", "timeout": 5 }]
+        }
+      ],
+      "postToolUse": [
+        {
+          "matcher": "write",
+          "hooks": [{ "command": "~/.pi/agent/hooks/write-audit.sh", "timeout": 5 }]
+        }
+      ],
+      "sessionStart": [
+        {
+          "hooks": [{ "command": "~/.pi/agent/hooks/session-git-status.sh", "timeout": 10 }]
+        }
+      ]
+    }
+  }
+}
+```
+
+**1. bash-guard** — deny `rm -rf /` (and close variants) before bash runs. Exit 2 is deny; the first stderr line or `permissionDecisionReason` is what the model sees.
+
+```bash
+#!/usr/bin/env bash
+# ~/.pi/agent/hooks/bash-guard.sh
+payload=$(cat)
+cmd=$(printf '%s' "$payload" | python3 -c 'import json,sys; print(json.load(sys.stdin).get("tool_input",{}).get("command",""))')
+if printf '%s' "$cmd" | grep -Eq '(^|[[:space:]])rm[[:space:]]+(-[a-zA-Z]*[[:space:]]+)*-r[a-zA-Z]*f|-fr[a-zA-Z]*|[[:space:]]/[[:space:]]*$'; then
+  printf '%s\n' '{"hookSpecificOutput":{"permissionDecision":"deny","permissionDecisionReason":"blocked destructive rm"}}'
+  echo "blocked destructive rm" >&2
+  exit 2
+fi
+exit 0
+```
+
+**2. write-audit** — append-only log of write tool calls (does not block).
+
+```bash
+#!/usr/bin/env bash
+# ~/.pi/agent/hooks/write-audit.sh
+mkdir -p "$HOME/.pi/agent/logs"
+printf '%s\n' "$(date -Is) $1" >> "$HOME/.pi/agent/logs/write-audit.jsonl"
+cat >> "$HOME/.pi/agent/logs/write-audit.jsonl"
+```
+
+The hook receives the JSON payload on stdin; the snippet above stores the raw event. Trim or jq-filter as you like.
+
+**3. SessionStart git-status** — inject `git status --short` as extra context at session start.
+
+```bash
+#!/usr/bin/env bash
+# ~/.pi/agent/hooks/session-git-status.sh
+status=$(git status --short 2>/dev/null | head -n 40)
+CTX="$status" python3 - <<'PY'
+import json, os
+print(json.dumps({
+  "hookSpecificOutput": {
+    "additionalContext": "git status:\n" + os.environ.get("CTX", "")
+  }
+}))
+PY
+```
+
+Tool-input repairs (custom/extension tools only) run before hooks: null-for-optional, JSON-string arrays, `{}` → `[]` on array keys, bare-string wrap, path aliases, and markdown auto-link unwrap. `/repairs` shows the counters. Core tools (`bash`, `read`, `edit`, `write`, `grep`, `find`, `ls`) are never rewritten.
+
+`wishcraft.tokenBudget.daily` (token count) paints the cost segment warning/red at 80%/100% and notifies on welcome. It never blocks a turn. `/usage` shows session / today / week from `~/.pi/agent/wishcraft-usage.json`. `/tps` with no args opens the live ring overlay (same sampler as the segment).
+
 ## Working Vibes
 
 Transform boring "Working..." messages into themed phrases that match your style:

package/ROADMAP.md

@@ -89,10 +89,10 @@ Niet de fork. Niet de SaaS-agent.
   manager v2 UI gingen mee in #12, eerder dan deze sectie beloofde.
   Done = npm 0.19.2 live, `/skills` filtert, `$test` expandeert geen
   debris, verify-trio groen op de tag.
-- **0.20.0 — "Harness"**. Overlay-chrome + CHE-42 drill-down, Configure
-  uit `ctx.ui.select`, token-overlays, rest-repairs, README-hooks die
-  waar zijn. Done = drie README-hookvoorbeelden werken, repair-teller
-  zichtbaar, `alt+p` overlay-boom, `/tps` deelt de ring met het segment.
+- **0.20.0–0.22 — "Harness"** (0.20.0 + 0.21.0 op npm; leftovers in GRO-1414).
+  Overlay-chrome + CHE-42 drill-down, Configure als SelectList, token-overlays,
+  rest-repairs, README-hooks. Done = drie README-hookvoorbeelden, repair-teller,
+  `alt+p` overlay-boom, `/tps` deelt de ring met het segment.
 - **1.0 — "Cockpit"**. Skills-doctor/install, declaratieve policy,
   preset-editor, idee-review, stabiele ChefGroep-statuskeys,
   documentatie die waar is. Done = README dekt alles wat we shipten,
@@ -172,13 +172,9 @@ GRO-1061 (runner-queue) is ops, geen product-slice.
 
 ## 0.20.0 — Harness
 
-Vier stacked PRs. 0.19.2 staat op npm. Hooks, repairs-subset en
-skills-manager v2 UI zijn al op `main` (#12). Op `feat/complete-wishcraft-backlog`
-(reopen #13) landen nu de unieke 0.20-expansies bovenop CHE-42 (#19):
-`/powerline doctor` + `export`, queue-archive + retention (P1 single-clock),
-`customItems.auto`, fleet-SSH `openPorts.host`, what's-new welcome widget,
-cost-alert, bash editor-history split, `docs/` guides, custom-preset builder in
-Configure. Nog open: token-overlays, rest-repairs, README-hookvoorbeelden.
+Vier stacked PRs. 0.20.0 (#19) en 0.21.0 (#13) staan op npm. CHE-42
+Configure-overlay, doctor/export, queue-archive en `docs/` zijn geland.
+GRO-1414 sluit README-hooks, rest-repairs, `/tps`+`/usage`, substring-filter.
 
 Overlay-chrome kit, één keer, daarna hergebruiken: box + ronde hoeken,
 accent-kop, dim metadata, rechts uitgelijnde counts, `→` detail /
@@ -186,7 +182,7 @@ accent-kop, dim metadata, rechts uitgelijnde counts, `→` detail /
 skills v2; tweede = `/usage`; derde = queue/idea. Pure render-
 functies, geen `ctx.ui`-mock.
 
-### PR E — hooks — ✅ geland in `feat/wishcraft-0.19` (`src/extension/hooks/`, `/repairs` stats-command; README-voorbeelden volgen in de release-PR)
+### PR E — hooks — ✅ geland in `feat/wishcraft-0.19`; README-voorbeelden in GRO-1414
 
 Settings: `wishcraft.hooks` met events
 `preToolUse | postToolUse | sessionStart | turnEnd`. Per hook
@@ -201,7 +197,7 @@ Done: `parseHookOutput` unit-testen. README met drie werkende
 voorbeelden: bash-guard (`rm -rf /` blokkeren), write-audit
 (append-only log), SessionStart git-status injectie.
 
-### PR F — tool-input repairs — ✅ geland in `feat/wishcraft-0.19` (schema-loze subset: null-for-optional + auto-link unwrap; schema-afhankelijke repairs wachten op validator-issues in pi core)
+### PR F — tool-input repairs — ✅ schema-loze subset in 0.19; rest (JSON-array, `{}`, bare-wrap, path aliases) in GRO-1414. Core tools blijven met rust.
 
 `tool_call`-handler repareert bekende malformaties vóór executie
 (mutable input). Volgorde vast: json-parse vóór bare-wrap.
@@ -308,7 +304,8 @@ Pas na 0.20. Geen parallelle 1.0-tak.
 | GRO-1061 CI queue | Ops, niet deze roadmap. |
 | CHE-40 `/powerline` tab | Done (#18 / 0.19.2). |
 | CHE-41 per-segment detail | 1.0. Ticket hernoemd; geen tweede `alt+i`-pad. |
-| CHE-42 drill-down | In Progress. #19 = drie top-level overlays + Status. Configure-overlay volgt. |
+| CHE-42 drill-down | Done (#19 + Configure in #13). |
+| GRO-1414 0.20 leftovers | In Progress. Hooks docs, rest-repairs, `/tps` `/usage`, substring filter. |
 
 Oude `pi-powerline-footer`-projecttickets niet laten staan alsof
 die package nog leeft.
@@ -331,8 +328,8 @@ die package nog leeft.
 
 ## Residual risks
 
-- `SelectList.setFilter` matcht alleen prefix op `value`. 0.19
-  accepteert dat; 0.20 vervangt het.
+- `SelectList.setFilter` matcht alleen prefix op `value`. Overlay-chrome
+  filtert zelf op substring (GRO-1414). Skills-manager had dat al.
 - `npm deprecate` van de oude naam faalt tot de scope-owner het
   token verruimt. Gebruikers die `pi-powerline-footer` installeren
   blijven op 0.17.2.

package/docs/commands.md

@@ -96,7 +96,8 @@ Preset selection is saved under `powerline` in the agent settings file and resto
 
 Pi core renders the footer as static text, so live click is not possible; actions live in commands and a navigable overlay.
 
-- `/tps [value]`: show or set `POWERLINE_TPS`
+- `/tps`: overlay of the live 1s window (same ring as the segment). `/tps <value>` sets `POWERLINE_TPS`
+- `/usage`: session / today / week overlay from `~/.pi/agent/wishcraft-usage.json`
 - `/open-ports`: list listening ports and pick one
 - `/powerline doctor`: diagnostics overlay — settings file validity, unknown presets, Nerd Font detection, git polling, bash-mode status, and queue file health
 - `/powerline export`: export the current preset + effective layout + labels as a JSON snippet (Enter copies it to the clipboard)

package/docs/configuration.md

@@ -214,6 +214,24 @@ Set `powerline.costAlert` to a USD threshold to get a single warning notificatio
 }
 ```
 
+## Hooks and repairs
+
+Command hooks live under `wishcraft.hooks` in the **global** agent settings file. `wishcraft.hooksEnabled: false` is the kill-switch. See the README Hooks section for three copy-paste examples (bash-guard, write-audit, SessionStart git-status).
+
+Tool-input repairs apply to custom/extension tools only (`wishcraft.repairsEnabled`, default on). `/repairs` prints the counters.
+
+## Token budget
+
+`wishcraft.tokenBudget.daily` is a token count (input + output + cache). At 80% the cost segment turns warning-coloured; at 100% it turns red and welcome notifies. It never blocks a turn.
+
+```json
+{
+  "wishcraft": {
+    "tokenBudget": { "daily": 500000 }
+  }
+}
+```
+
 ## Custom layout
 
 Use `powerline.layout` to override segment order and grouping while keeping the selected preset's colors and segment options. Set `powerline.separator` when you want a separator style independent of the preset:

package/docs/index.md

@@ -5,8 +5,8 @@ The README stays a short landing page; everything below lives here.
 
 ## Guides
 
-- [Commands & interactivity](./commands.md) — `/powerline`, `/queue`, `/idea`, placement, presets, keybinds, and the navigable overlay.
-- [Configuration](./configuration.md) — custom items, custom segments, custom presets, labels, templates, layout, cost alert, and display formats.
+- [Commands & interactivity](./commands.md) — `/powerline`, `/tps`, `/usage`, `/queue`, `/idea`, placement, presets, keybinds, and the navigable overlay.
+- [Configuration](./configuration.md) — custom items, hooks, repairs, token budget, labels, templates, layout, cost alert, and display formats.
 - [Bash mode](./bash-mode.md) — sticky shell, ghost suggestions, and shell config.
 - [Stash & shortcuts](./stash-and-shortcuts.md) — editor stash, prompt history, clipboard/navigation shortcuts, and shortcut config.
 - [Skill manager](./skill-manager.md) — browsing and inserting installed skills.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groeponline/pi-wishcraft",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Wishcraft cockpit for the pi coding agent — powerline status, vibes, idea inbox, bash mode, and full customization.",
   "type": "module",
   "files": [

package/src/config/types.ts

@@ -259,6 +259,9 @@ export interface SegmentContext {
   /** Per-segment custom text labels (from powerline.segmentLabels). */
   segmentLabels: ReadonlyMap<string, string>;
 
+  /** Daily token budget progress (wishcraft.tokenBudget.daily). */
+  tokenBudget?: { dailyLimit: number | null; dailyUsed: number };
+
   // Theming
   theme: ThemeLike;
   colors: ColorScheme;

package/src/extension/commands/commands.ts

@@ -17,6 +17,7 @@ import {
   writePowerlinePresetSetting,
 } from "../settings/settings-io.ts";
 import { showOpenPortsList, showSelectOverlay } from "../ui/menu-views.ts";
+import { showTpsOverlay, showUsageOverlay } from "../ui/token-overlays.ts";
 import { showPowerlineMainMenu } from "../ui/powerline-menu-view.ts";
 import { openStashHistory } from "../shortcuts/shortcuts-router.ts";
 import { ensureShellSession, setBashModeActive } from "./bash-mode-actions.ts";
@@ -232,13 +233,12 @@ export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
   });
 
   pi.registerCommand("tps", {
-    description: "Show or set POWERLINE_TPS value",
+    description: "Show the live TPS overlay, or set POWERLINE_TPS",
     handler: async (args, ctx) => {
       rt.currentCtx = ctx;
       const value = args?.trim();
       if (!value) {
-        const current = process.env.POWERLINE_TPS || "not set";
-        ctx.ui.notify(`TPS: ${current}`, "info");
+        await showTpsOverlay(rt, ctx);
         return;
       }
       process.env.POWERLINE_TPS = value;
@@ -248,6 +248,14 @@ export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
     },
   });
 
+  pi.registerCommand("usage", {
+    description: "Show session / today / week token usage overlay",
+    handler: async (_args, ctx) => {
+      rt.currentCtx = ctx;
+      await showUsageOverlay(rt, ctx);
+    },
+  });
+
   pi.registerCommand("open-ports", {
     description: "Show open ports",
     handler: async (_args, ctx) => {

package/src/extension/core/segment-context.ts

@@ -14,6 +14,14 @@ import { getDefaultColors } from "../../theme/theme.ts";
 import { getGitStatus } from "../../git/status.ts";
 import { getQueueContext } from "../queue/queue-context.ts";
 import { getUsageTokenTotal } from "../../usage/ledger.ts";
+import {
+  dayKey,
+  loadUsageFileFromDisk,
+  tokenTotal,
+  totalsForRange,
+} from "../../usage/usage-store.ts";
+import { parseTokenBudget } from "../../usage/token-budget.ts";
+import { readSettings } from "../settings/settings-io.ts";
 import {
   CUSTOM_COMPACTION_STATUS_KEY,
   EDITOR_STATUS_DEFER_MS,
@@ -220,6 +228,17 @@ export function buildSegmentContext(
     effectiveCustomItems,
     options: segmentOptions,
     segmentLabels: new Map(Object.entries(config.segmentLabels)),
+    tokenBudget: (() => {
+      const dailyLimit = parseTokenBudget(
+        readSettings(ctx.cwd ?? process.cwd()).wishcraft,
+      ).daily;
+      const now = Date.now();
+      const todayStart = Date.parse(`${dayKey(now)}T00:00:00`);
+      const dailyUsed = tokenTotal(
+        totalsForRange(loadUsageFileFromDisk(), todayStart, now + 1),
+      );
+      return { dailyLimit, dailyUsed };
+    })(),
     theme,
     colors,
   };

package/src/extension/core/state.ts

@@ -112,6 +112,7 @@ export function createRuntimeState(
     stashedPromptHistory: readPersistedStashHistory(),
     currentEditor: null,
     costAlertNotified: false,
+    tokenBudgetNotifiedLevel: 0,
     bashModeActive: false,
     bashTranscript: new BashTranscriptStore(bashModeSettings),
     bashCompletionEngine: new BashCompletionEngine(),

package/src/extension/core/types.ts

@@ -64,6 +64,8 @@ export interface RuntimeState {
   currentEditor: any;
   /** True once the configured `costAlert` threshold has been notified this session. */
   costAlertNotified: boolean;
+  /** Highest daily-budget warning already shown this session (0 / 80 / 100). */
+  tokenBudgetNotifiedLevel: 0 | 80 | 100;
   bashModeActive: boolean;
   bashTranscript: BashTranscriptStore;
   bashCompletionEngine: BashCompletionEngine;

package/src/extension/hooks/repairs.ts

@@ -2,20 +2,74 @@
  * repairs.ts
  * ---------------------------------------------------------------------------
  * Tool-input repairs vóór executie (pi's `tool_call` event heeft mutable
- * input). Alleen de reparaties die zonder schema-kennis universeel veilig
- * zijn; schema-afhankelijke repairs (bare-string-wrap, JSON-string-array,
- * placeholder-object) vereisen de validator-issue-lijst en blijven bewust
- * weg tot Pi die expose't.
+ * input). Custom/extension tools only. Order is fixed: json-parse before
+ * bare-string wrap so `'["a"]'` becomes `["a"]`, not `[['["a"]']]`.
  * ---------------------------------------------------------------------------
  */
 
 /** Degenerate markdown auto-link: link-tekst == url zonder protocol. */
 const AUTO_LINK_RE = /^\[([^\]\s]+)\]\((https?:\/\/|file:\/\/)?([^)\s]*)\)$/;
 
+const CORE_TOOLS = new Set([
+  "bash",
+  "read",
+  "edit",
+  "write",
+  "grep",
+  "find",
+  "ls",
+]);
+
+const PATH_ALIASES = ["filePath", "absolutePath", "target_file", "file_path"];
+
+const ARRAY_KEYS = new Set([
+  "files",
+  "paths",
+  "globs",
+  "args",
+  "items",
+  "patterns",
+  "include",
+  "exclude",
+  "queries",
+  "urls",
+  "commands",
+]);
+
 function isDegenerateAutoLink(linkText: string, url: string): boolean {
   return linkText === url || linkText === decodeURI(url);
 }
 
+function isArrayKey(key: string): boolean {
+  if (ARRAY_KEYS.has(key)) return true;
+  return /_(files|paths|globs|args|items|patterns)$/.test(key);
+}
+
+function looksLikePath(text: string): boolean {
+  if (/\s/.test(text)) return false;
+  return text.includes("/") || text.includes(".") || /^[a-zA-Z0-9_-]+$/.test(text);
+}
+
+function parseJsonArray(value: string): unknown[] | null {
+  const trimmed = value.trim();
+  if (!trimmed.startsWith("[")) return null;
+  try {
+    const parsed = JSON.parse(trimmed);
+    return Array.isArray(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+function isEmptyObject(value: unknown): boolean {
+  return (
+    typeof value === "object" &&
+    value !== null &&
+    !Array.isArray(value) &&
+    Object.keys(value as Record<string, unknown>).length === 0
+  );
+}
+
 export interface RepairResult {
   toolName: string;
   repairs: string[];
@@ -31,39 +85,58 @@ export function repairToolInput(
   input: Record<string, unknown>,
 ): RepairResult {
   const repairs: string[] = [];
-  const isBuiltin = ["bash", "read", "edit", "write", "grep", "find", "ls"].includes(
-    toolName,
-  );
-  if (isBuiltin || !input || typeof input !== "object") {
+  if (CORE_TOOLS.has(toolName) || !input || typeof input !== "object") {
     return { toolName, repairs };
   }
 
+  if (typeof input.path !== "string" || !input.path) {
+    for (const alias of PATH_ALIASES) {
+      const value = input[alias];
+      if (typeof value === "string" && looksLikePath(value)) {
+        input.path = value;
+        delete input[alias];
+        repairs.push(`path-alias:${alias}`);
+        break;
+      }
+    }
+  }
+
   for (const key of Object.keys(input)) {
     const value = input[key];
-    // null-for-optional: model stuurde null, schema wil afwezig
     if (value === null) {
       delete input[key];
       repairs.push(`null-for-optional:${key}`);
       continue;
     }
-    // markdown auto-link op pad-achtige velden: [x.md](http://x.md) → x.md
     if (typeof value === "string") {
       const m = AUTO_LINK_RE.exec(value);
       if (m && m[1] && isDegenerateAutoLink(m[1], m[3] ?? "")) {
         input[key] = m[1];
         repairs.push(`auto-link-unwrap:${key}`);
       }
+      const current = input[key];
+      if (typeof current === "string") {
+        const parsed = parseJsonArray(current);
+        if (parsed) {
+          input[key] = parsed;
+          repairs.push(`json-string-array:${key}`);
+        }
+      }
+    }
+    const afterParse = input[key];
+    if (isArrayKey(key) && isEmptyObject(afterParse)) {
+      input[key] = [];
+      repairs.push(`empty-object-placeholder:${key}`);
+      continue;
+    }
+    if (isArrayKey(key) && typeof afterParse === "string") {
+      input[key] = [afterParse];
+      repairs.push(`bare-string-wrap:${key}`);
     }
   }
   return { toolName, repairs };
 }
 
-function looksLikePath(text: string): boolean {
-  if (/\s/.test(text)) return false;
-  return text.includes("/") || text.includes(".") || /^[a-zA-Z0-9_-]+$/.test(text);
-}
-void looksLikePath;
-
 /** Repair-teller per (tool, repair) — zichtbaar via /repairs. */
 const repairCounts = new Map<string, number>();
 

package/src/extension/session/session-lifecycle.ts

@@ -17,13 +17,24 @@ import {
 import {
   getSessionTotalCost,
   getUsageTokenTotal,
-  hasSessionAssistantUsage,
   isSessionAssistantMessage,
 } from "../../usage/ledger.ts";
 import {
   formatCostAlertMessage,
   shouldTriggerCostAlert,
 } from "./cost-alert.ts";
+import {
+  formatTokenBudgetWarning,
+  parseTokenBudget,
+  tokenBudgetLevel,
+} from "../../usage/token-budget.ts";
+import {
+  recordUsageEvent,
+  loadUsageFileFromDisk,
+  tokenTotal,
+  totalsForRange,
+  dayKey,
+} from "../../usage/usage-store.ts";
 import {
   detectCustomCompactionEnabled,
   readSettings,
@@ -94,6 +105,22 @@ function maybeNotifyCostAlert(rt: RuntimeState, ctx: any): void {
   );
 }
 
+function maybeNotifyTokenBudget(rt: RuntimeState, ctx: any): void {
+  if (!ctx?.hasUI) return;
+  const daily = parseTokenBudget(readSettings(ctx.cwd ?? process.cwd()).wishcraft)
+    .daily;
+  if (!daily) return;
+  const now = Date.now();
+  const todayStart = Date.parse(`${dayKey(now)}T00:00:00`);
+  const used = tokenTotal(
+    totalsForRange(loadUsageFileFromDisk(), todayStart, now + 1),
+  );
+  const { level } = tokenBudgetLevel(used, daily);
+  if (level === 0 || level <= rt.tokenBudgetNotifiedLevel) return;
+  rt.tokenBudgetNotifiedLevel = level;
+  ctx.ui.notify(formatTokenBudgetWarning(used, daily, level), "warning");
+}
+
 // Helper to extract recent agent response text (skipping thinking blocks)
 function getRecentAgentContext(ctx: any): string | undefined {
   const sessionEvents = ctx.sessionManager?.getBranch?.() ?? [];
@@ -143,6 +170,7 @@ export function registerSessionLifecycle(
     rt.isStreaming = false;
     rt.liveAssistantUsage = null;
     rt.costAlertNotified = false;
+    rt.tokenBudgetNotifiedLevel = 0;
     rt.powerlineCompacting = false;
     rt.deliverAfterRetrySettles = false;
     rt.stashedEditorText = null;
@@ -193,6 +221,7 @@ export function registerSessionLifecycle(
       } else {
         dismissWelcome(rt, ctx);
       }
+      maybeNotifyTokenBudget(rt, ctx);
     }
   });
 
@@ -310,10 +339,21 @@ export function registerSessionLifecycle(
         rt.liveAssistantUsage = null;
       } else if (getUsageTokenTotal(event.message.usage) > 0) {
         rt.liveAssistantUsage = event.message.usage;
+        const usage = event.message.usage;
+        recordUsageEvent({
+          at: Date.now(),
+          model: ctx.model?.id ?? ctx.model?.name,
+          input: usage.input,
+          output: usage.output,
+          cacheRead: usage.cacheRead,
+          cacheWrite: usage.cacheWrite,
+          cost: usage.cost.total,
+        });
       }
     }
     requestImmediateStatusRender(rt, { deferDuringTyping: false });
     maybeNotifyCostAlert(rt, ctx);
+    maybeNotifyTokenBudget(rt, ctx);
   });
 
   pi.on("turn_end", async (_event, ctx) => {

package/src/extension/settings/wishcraft-config.ts

@@ -145,7 +145,8 @@ export function buildConfigGroups(settings: Record<string, unknown>): ConfigGrou
       title: "Hooks & repairs (harness-laag)",
       items: [
         { label: "Hooks ingeschakeld", path: "wishcraft.hooksEnabled", kind: "toggle", hint: "commandcode-achtige preToolUse/postToolUse/sessionStart hooks" },
-        { label: "Tool-input repairs", path: "wishcraft.repairsEnabled", kind: "toggle", hint: "null-for-optional, auto-link unwrap op custom tools" },
+        { label: "Tool-input repairs", path: "wishcraft.repairsEnabled", kind: "toggle", hint: "null-for-optional, auto-link, json-array, path aliases" },
+        { label: "Dagelijks tokenbudget", path: "wishcraft.tokenBudget.daily", kind: "number", hint: "kleurt cost-segment; blokkeert nooit. 0 = uit" },
       ],
     },
     {