claude-remote-approver 0.5.2 → 0.6.1

package/README.md

@@ -21,7 +21,7 @@ cli.mjs hook
   │
   ├──POST──▶ ntfy.sh/<topic>          ──push──▶  Phone (ntfy app)
   │                                                 │
-  │                                           Approve / Deny tap
+  │                                     Approve / Always Approve / Deny tap
   │                                                 │
   └──SSE───▶ ntfy.sh/<topic>-response  ◀──POST──┘
   │
@@ -31,7 +31,7 @@ Claude Code continues or stops
 ```
 
 1. Claude Code invokes the hook, piping the tool request as JSON to stdin.
-2. `cli.mjs hook` sends a notification to your ntfy topic with **Approve** and **Deny** action buttons.
+2. `cli.mjs hook` sends a notification to your ntfy topic with **Approve**, **Always Approve**, and **Deny** action buttons.
 3. The hook subscribes to a response topic (`<topic>-response`) via server-sent events.
 4. When you tap a button on your phone, ntfy.sh publishes your decision to the response topic.
 5. The hook reads the decision and writes `{"behavior":"allow"}` or `{"behavior":"deny"}` to stdout. If the notification fails or times out, the hook returns `{"behavior":"ask"}` so Claude Code falls back to the CLI prompt.
@@ -41,6 +41,16 @@ Claude Code continues or stops
 
 When Claude Code calls the `AskUserQuestion` tool, the hook sends the question to your phone as a notification. Each option appears as an action button you can tap. If the question has more than 3 options, they are split across multiple notifications. If no response is received before the timeout, the hook falls back to the CLI prompt so you can answer at your terminal.
 
+### Always Approve
+
+When Claude Code sends a `permission_suggestions` field with the hook request (indicating the tool can be auto-approved in future), the notification shows three buttons: **Approve**, **Always Approve**, and **Deny**.
+
+- **Approve** -- Allow this one request.
+- **Always Approve** -- Allow this request and tell Claude Code to auto-approve this tool in future sessions. Claude Code adds the permission rule to its settings so it won't ask again.
+- **Deny** -- Reject this request.
+
+If the hook request does not include `permission_suggestions`, only the standard **Approve** and **Deny** buttons are shown.
+
 ## Quick Start
 
 ```bash

package/bin/cli.mjs

@@ -36,15 +36,18 @@ export async function main(args, deps) {
       deps.stdout.write(`Setup complete. Topic: ${result.topic}\n\n`);
 
       try {
-        const host = new URL(result.ntfyServer).host;
-        const ntfyUrl = `ntfy://${host}/${result.topic}`;
-        const httpsUrl = `${result.ntfyServer.replace(/\/+$/, "")}/${result.topic}`;
+        const serverUrl = new URL(result.ntfyServer);
+        const isHttps = serverUrl.protocol === "https:";
+        const ntfyUrl = isHttps
+          ? `ntfy://${serverUrl.host}/${result.topic}`
+          : `${result.ntfyServer.replace(/\/+$/, "")}/${result.topic}`;
+        const subscribeUrl = `${result.ntfyServer.replace(/\/+$/, "")}/${result.topic}`;
 
         deps.stdout.write("Scan this QR code in the ntfy app to subscribe:\n\n");
         // qrcode-terminal invokes the callback synchronously
         deps.generateQR(ntfyUrl, { small: true }, (qrString) => {
           deps.stdout.write(qrString + "\n\n");
-          deps.stdout.write(`Subscribe URL: ${httpsUrl}\n`);
+          deps.stdout.write(`Subscribe URL: ${subscribeUrl}\n`);
         });
       } catch {
         deps.stderr.write(`Warning: Invalid ntfyServer URL in config: ${result.ntfyServer}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-remote-approver",
-  "version": "0.5.2",
+  "version": "0.6.1",
   "description": "Approve or deny Claude Code permission prompts remotely from your phone via ntfy.sh",
   "type": "module",
   "bin": {

package/src/hook.mjs

@@ -11,16 +11,18 @@ export const RETRY_DELAY_MS = 1000;
 export const _internal = { delay: ms => new Promise(r => setTimeout(r, ms)) };
 
 /**
- * Build ntfy action buttons for Approve / Deny.
+ * Build ntfy action buttons for Approve / Deny (and optionally Always Approve).
  *
  * @param {string} server - ntfy server URL
  * @param {string} topic - ntfy topic
  * @param {string} requestId - Unique request identifier
- * @returns {Array<object>} Array of 2 action objects
+ * @param {object} [options] - Optional settings
+ * @param {string[]} [options.permissionSuggestions] - When non-empty, adds an "Always Approve" button
+ * @returns {Array<object>} Array of action objects
  */
-export function buildActions(server, topic, requestId) {
+export function buildActions(server, topic, requestId, { permissionSuggestions } = {}) {
   const url = `${server}/${topic}-response`;
-  return [
+  const actions = [
     {
       action: "http",
       label: "Approve",
@@ -36,6 +38,16 @@ export function buildActions(server, topic, requestId) {
       method: "POST",
     },
   ];
+  if (permissionSuggestions?.length > 0) {
+    actions.splice(1, 0, {
+      action: "http",
+      label: "Always Approve",
+      url,
+      body: JSON.stringify({ requestId, approved: true, alwaysAllow: true }),
+      method: "POST",
+    });
+  }
+  return actions;
 }
 
 /**
@@ -194,7 +206,9 @@ export async function processHook(input, { loadConfig, sendNotification, waitFor
 
   const requestId = crypto.randomUUID();
   const { title, message } = formatToolInfo(input);
-  const actions = buildActions(config.ntfyServer, config.topic, requestId);
+  const actions = buildActions(config.ntfyServer, config.topic, requestId, {
+    permissionSuggestions: input.permission_suggestions,
+  });
 
   const sent = await sendWithRetry(sendNotification, {
     server: config.ntfyServer,
@@ -230,5 +244,9 @@ export async function processHook(input, { loadConfig, sendNotification, waitFor
     return ASK;
   }
   if (response.approved === false) return DENY;
-  return { hookSpecificOutput: { hookEventName: "PermissionRequest", decision: { behavior: "allow" } } };
+  const decision = { behavior: "allow" };
+  if (response.alwaysAllow === true && input.permission_suggestions?.length > 0) {
+    decision.updatedPermissions = input.permission_suggestions;
+  }
+  return { hookSpecificOutput: { hookEventName: "PermissionRequest", decision } };
 }

package/src/ntfy.mjs

@@ -73,7 +73,7 @@ export async function waitForResponse({ server, topic, requestId, timeout }) {
               if (typeof parsed.answer === 'string') {
                 return { answer: parsed.answer };
               }
-              return { approved: parsed.approved };
+              return { approved: parsed.approved, alwaysAllow: parsed.alwaysAllow === true };
             }
           } catch {
             // skip non-JSON lines