@aerok/pi-toolkit 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.1.1] - 2026-09-02
+
+- Added `/toolkit:bark-toggle` for global or project-level `on`, `off`, `status`, and no-argument toggle operations.
+- Disabling Bark through the shortcut clears any armed urgent notification.
+
 ## [0.1.0] - 2026-09-02
 
 Initial public release of pi-toolkit.

package/README.md

@@ -85,6 +85,7 @@ The wizard does not save or activate new encryption credentials until this devic
 |---|---|
 | `/toolkit:bark-setup` | Configure the Bark server, device key, delivery defaults, and encryption |
 | `/toolkit:bark-test` | Send a test using the active encryption mode |
+| `/toolkit:bark-toggle` | Quickly enable, disable, toggle, or inspect Bark notifications |
 | `/toolkit:bark-encryption-rotate` | Generate and verify a new encryption Key and IV |
 | `/toolkit:bark-urgent` | Toggle continuous ringing for the next completed task only |
 | `/toolkit:bark-notify-settings` | Configure notification events, encryption mode, and recap behavior |
@@ -92,6 +93,33 @@ The wizard does not save or activate new encryption credentials until this devic
 
 All Bark commands use the `toolkit:bark-*` namespace so other pi-toolkit extensions can add their own command groups later.
 
+## Quick enable and disable
+
+Toggle global Bark notifications with no arguments:
+
+```text
+/toolkit:bark-toggle
+```
+
+Use an explicit action when the desired result must be unambiguous:
+
+```text
+/toolkit:bark-toggle on
+/toolkit:bark-toggle off
+/toolkit:bark-toggle status
+```
+
+Add `--project` to target the current project's non-secret enabled override:
+
+```text
+/toolkit:bark-toggle --project
+/toolkit:bark-toggle --project on
+/toolkit:bark-toggle --project off
+/toolkit:bark-toggle --project status
+```
+
+Enabling is refused until the inherited Bark server, device key, and encryption credentials are valid. Disabling clears any armed urgent notification. Status reports global, project, and effective values without changing configuration.
+
 ## Default completion notification
 
 When `agent_settled` fires, pi-toolkit sends:

package/extensions/bark/index.ts

@@ -3,7 +3,14 @@ import type { ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-c
 import { Type } from "typebox";
 
 import { createBarkClient } from "./client.js";
-import { loadResolvedConfig, validateResolvedConfig } from "./config.js";
+import {
+  loadGlobalConfig,
+  loadProjectConfig,
+  loadResolvedConfig,
+  saveGlobalConfig,
+  saveProjectConfig,
+  validateResolvedConfig,
+} from "./config.js";
 import { fallbackSummary, summarizeForNotification } from "./recap.js";
 import type { BarkEventKey, BarkLevel, CachedModel, NotifyPriority, ResolvedBarkConfig } from "./types.js";
 import { RecapModelSelectorOverlay } from "./tui/model-selector.js";
@@ -211,6 +218,63 @@ export default function barkExtension(pi: ExtensionAPI): void {
     },
   });
 
+  pi.registerCommand("toolkit:bark-toggle", {
+    description: "Toggle Bark notifications globally or for the current project",
+    handler: async (args, ctx) => {
+      const tokens = args.trim().split(/\s+/).filter(Boolean);
+      const project = tokens.includes("--project");
+      const actions = tokens.filter((token) => token !== "--project");
+      const action = actions[0] as "on" | "off" | "status" | undefined;
+      if (actions.length > 1 || (action && !["on", "off", "status"].includes(action)) || tokens.filter((token) => token === "--project").length > 1) {
+        ctx.ui.notify("Usage: /toolkit:bark-toggle [on|off|status] [--project]", "error");
+        return;
+      }
+
+      const status = (): { global: boolean; project?: boolean; effective: boolean } => {
+        const global = loadGlobalConfig().enabled;
+        const projectEnabled = loadProjectConfig(ctx.cwd)?.enabled;
+        return { global, project: projectEnabled, effective: projectEnabled ?? global };
+      };
+      if (action === "status") {
+        const current = status();
+        ctx.ui.notify(
+          `Bark: ${current.effective ? "on" : "off"} effective · global ${current.global ? "on" : "off"} · project ${current.project === undefined ? "inherited" : current.project ? "on" : "off"}`,
+          "info",
+        );
+        return;
+      }
+
+      const before = status();
+      const current = project ? before.effective : before.global;
+      const enabled = action ? action === "on" : !current;
+      if (enabled) {
+        const errors = validateResolvedConfig(loadResolvedConfig(ctx.cwd));
+        if (errors.length > 0) {
+          ctx.ui.notify(`Cannot enable Bark: ${errors.join("; ")}. Run /toolkit:bark-setup first.`, "error");
+          return;
+        }
+      }
+
+      if (project) {
+        saveProjectConfig(ctx.cwd, { ...(loadProjectConfig(ctx.cwd) ?? { version: 1 }), enabled });
+      } else {
+        saveGlobalConfig({ ...loadGlobalConfig(), enabled });
+      }
+      if (!enabled) {
+        urgentNextTask = false;
+        ctx.ui.setStatus("pi-toolkit-urgent", undefined);
+      }
+
+      const after = status();
+      const scope = project ? "project" : "global";
+      const overridden = !project && after.effective !== enabled;
+      ctx.ui.notify(
+        `Bark notifications ${enabled ? "enabled" : "disabled"} (${scope})${overridden ? `; current project remains ${after.effective ? "on" : "off"}` : ""}.`,
+        overridden ? "warning" : "info",
+      );
+    },
+  });
+
   pi.registerCommand("toolkit:bark-urgent", {
     description: "Toggle continuous ringing for the next completed task",
     handler: async (_args, ctx) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aerok/pi-toolkit",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Encrypted Bark notifications and image paste placeholders for Pi",
   "type": "module",
   "license": "MIT",
@@ -47,10 +47,10 @@
     "node": ">=22.19.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "^0.84.0",
-    "@earendil-works/pi-coding-agent": "^0.84.0",
-    "@earendil-works/pi-tui": "^0.84.0",
-    "typebox": "^1.1.38"
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
   },
   "devDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",