@pushary/agent-hooks 0.28.0 → 0.28.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pushary
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# @pushary/agent-hooks
+
+[![npm version](https://img.shields.io/npm/v/@pushary/agent-hooks.svg)](https://www.npmjs.com/package/@pushary/agent-hooks)
+[![npm downloads](https://img.shields.io/npm/dm/@pushary/agent-hooks.svg)](https://www.npmjs.com/package/@pushary/agent-hooks)
+[![license](https://img.shields.io/npm/l/@pushary/agent-hooks.svg)](./LICENSE)
+
+Push notifications, questions, and permission approvals for AI coding agents. Get a push when your agent finishes work, answer its questions from your phone, and approve risky commands before they run. Works with Claude Code, Codex, Cursor, Gemini CLI, and Hermes.
+
+Your agent froze waiting for a yes. This is how it reaches you.
+
+```bash
+npx @pushary/agent-hooks@latest setup
+```
+
+One command wires up the MCP server, the permission hooks, and the agent instruction files. Then you close your laptop and the agent still reaches you.
+
+## What it does
+
+There are three things.
+
+**Notify.** The agent sends a push when a long task finishes or when a build, test, or deploy fails. The notification can carry what changed, the error, and suggested next steps.
+
+**Ask.** The agent asks you questions through push: yes/no, multiple choice, or free text. It waits for your answer. When Pushary is connected, the agent sends its questions to your phone instead of stalling in the terminal.
+
+**Gate.** Risky shell commands (`rm -rf`, force pushes, history rewrites, database drops, deploys) are checked before they run. What happens is set by your dashboard policy: auto approve trusted read-only commands, push to your phone for approval, or hold for the phone and never auto-deny. If the check cannot run, the command is blocked instead of allowed. It fails closed.
+
+## Setup
+
+You need an API key. Sign up at [pushary.com](https://pushary.com/sign-up?from=npm), then run:
+
+```bash
+npx @pushary/agent-hooks@latest setup
+```
+
+The wizard detects which agents you have installed and configures each one. To skip the prompts:
+
+```bash
+npx @pushary/agent-hooks@latest setup --key pk_xxx.sk_xxx --skip-phone
+```
+
+Verify it worked:
+
+```bash
+npx @pushary/agent-hooks@latest doctor
+```
+
+## Supported agents
+
+| Agent | Notify | Ask | Gate |
+|-------|:------:|:---:|:----:|
+| Claude Code | yes | yes | yes |
+| Codex | yes | yes | yes |
+| Cursor | yes | yes | yes |
+| Gemini CLI | yes | yes | yes |
+| Hermes | yes | yes | yes |
+
+Any other MCP client can use notify and ask by pointing at the Pushary MCP endpoint directly.
+
+## Commands
+
+```
+setup    Configure Claude Code, Codex, Gemini CLI, Hermes, or Cursor with Pushary
+doctor   Verify your Pushary installation is working
+clean    Remove all Pushary configuration
+mode     Switch approval mode (push_only, push_first, terminal_only)
+wait     Show or set the "wait for your phone" ladder (pushary wait 45)
+hook     Run as a PreToolUse hook (reads stdin, writes stdout)
+```
+
+Examples:
+
+```bash
+npx @pushary/agent-hooks@latest mode push_only --for 30m
+npx @pushary/agent-hooks@latest wait 45
+npx @pushary/agent-hooks@latest clean
+```
+
+## Manual MCP setup
+
+If you only want notifications and questions (no permission gating), add Pushary to your MCP config directly:
+
+```json
+{
+  "mcpServers": {
+    "pushary": {
+      "type": "http",
+      "url": "https://pushary.com/api/mcp/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+The MCP server exposes `send_notification`, `ask_user`, `wait_for_answer`, and `cancel_question`. Full tool reference is in the [docs](https://pushary.com/docs?from=npm).
+
+## Security
+
+The permission gate fails closed. If a policy cannot be fetched or a hook errors, the command is blocked, not allowed. Secrets in command arguments and environment are redacted before anything is sent to a phone or stored. Read-only commands can be allowlisted so trusted work never interrupts you, while writes and destructive commands still route through approval.
+
+## Links
+
+- Website: [pushary.com](https://pushary.com/?from=npm)
+- Docs: [pushary.com/docs](https://pushary.com/docs?from=npm)
+- Sign up: [pushary.com/sign-up](https://pushary.com/sign-up?from=npm)
+- Issues: [github.com/pushary/pushary/issues](https://github.com/pushary/pushary/issues)
+
+## License
+
+MIT

package/dist/bin/pushary-clean.js

@@ -2,14 +2,14 @@
 import {
   removeClaudeMcpServers,
   removePusharySettings
-} from "../chunk-76F75WQQ.js";
+} from "../chunk-QNEYHDKR.js";
 import {
   execNpm,
   removeCodexHooks,
   removeGeminiSettings,
   removeInstructionBlock
-} from "../chunk-QDPUTE2V.js";
-import "../chunk-YRL4ZB4R.js";
+} from "../chunk-X3YCHQQK.js";
+import "../chunk-Z5PL3K7C.js";
 
 // bin/pushary-clean.ts
 import { existsSync, readFileSync, writeFileSync, rmSync } from "fs";

package/dist/bin/pushary-codex-hook.js

@@ -32,14 +32,14 @@ import {
   toCodexWire,
   toPolicyLookup,
   waitForAnswer
-} from "../chunk-NFKYZY74.js";
+} from "../chunk-IAOXM7X5.js";
 import "../chunk-DWED7BS3.js";
 import {
   DECISION_LINE_MAX,
   effectiveWaitSeconds,
   hookWaitClamped,
   hookWaitDeadline
-} from "../chunk-YRL4ZB4R.js";
+} from "../chunk-Z5PL3K7C.js";
 import {
   getApiKey
 } from "../chunk-NKXSILEW.js";

package/dist/bin/pushary-codex.js

@@ -4,9 +4,9 @@ import {
   getMachineId,
   reportEvent,
   waitForAnswer
-} from "../chunk-NFKYZY74.js";
+} from "../chunk-IAOXM7X5.js";
 import "../chunk-DWED7BS3.js";
-import "../chunk-YRL4ZB4R.js";
+import "../chunk-Z5PL3K7C.js";
 import {
   getApiKey
 } from "../chunk-NKXSILEW.js";

package/dist/bin/pushary-doctor.js

@@ -12,12 +12,12 @@ import {
   missingGeminiHookEvents,
   readCodexMcpAuth,
   untrustedCodexHookEvents
-} from "../chunk-QDPUTE2V.js";
+} from "../chunk-X3YCHQQK.js";
 import {
   callMcpTool,
   sendMcpRequest
 } from "../chunk-DWED7BS3.js";
-import "../chunk-YRL4ZB4R.js";
+import "../chunk-Z5PL3K7C.js";
 import {
   getBaseUrl
 } from "../chunk-NKXSILEW.js";

package/dist/bin/pushary-gemini-hook.js

@@ -24,14 +24,14 @@ import {
   savePendingQuestion,
   sendNotification,
   waitForAnswer
-} from "../chunk-NFKYZY74.js";
+} from "../chunk-IAOXM7X5.js";
 import "../chunk-DWED7BS3.js";
 import {
   DECISION_LINE_MAX,
   effectiveWaitSeconds,
   hookWaitClamped,
   hookWaitDeadline
-} from "../chunk-YRL4ZB4R.js";
+} from "../chunk-Z5PL3K7C.js";
 import {
   getApiKey
 } from "../chunk-NKXSILEW.js";

package/dist/bin/pushary-hook.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   handlePreToolUse
-} from "../chunk-2BHYQCF7.js";
+} from "../chunk-P6QBZS27.js";
 import "../chunk-KQYIHZ5E.js";
-import "../chunk-NFKYZY74.js";
+import "../chunk-IAOXM7X5.js";
 import "../chunk-DWED7BS3.js";
-import "../chunk-YRL4ZB4R.js";
+import "../chunk-Z5PL3K7C.js";
 import "../chunk-NKXSILEW.js";
 
 // bin/pushary-hook.ts

package/dist/bin/pushary-post-hook.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   handlePostToolUse
-} from "../chunk-NFKYZY74.js";
+} from "../chunk-IAOXM7X5.js";
 import "../chunk-DWED7BS3.js";
-import "../chunk-YRL4ZB4R.js";
+import "../chunk-Z5PL3K7C.js";
 import "../chunk-NKXSILEW.js";
 
 // bin/pushary-post-hook.ts

package/dist/bin/pushary-prompt-hook.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   handleUserPrompt
-} from "../chunk-NFKYZY74.js";
+} from "../chunk-IAOXM7X5.js";
 import "../chunk-DWED7BS3.js";
-import "../chunk-YRL4ZB4R.js";
+import "../chunk-Z5PL3K7C.js";
 import "../chunk-NKXSILEW.js";
 
 // bin/pushary-prompt-hook.ts

package/dist/bin/pushary-setup.js

@@ -3,7 +3,7 @@ import {
   addClaudeMcpServer,
   addPusharyHooks,
   addPusharyToolPermissions
-} from "../chunk-76F75WQQ.js";
+} from "../chunk-QNEYHDKR.js";
 import {
   GEMINI_HOOK_BINARY,
   addCodexHookTrust,
@@ -16,14 +16,14 @@ import {
   renderAgentInstructions,
   renderProjectAgentInstructions,
   writeInstructionBlock
-} from "../chunk-QDPUTE2V.js";
+} from "../chunk-X3YCHQQK.js";
 import {
   reportEvent
-} from "../chunk-NFKYZY74.js";
+} from "../chunk-IAOXM7X5.js";
 import "../chunk-DWED7BS3.js";
 import {
   isValidApiKey
-} from "../chunk-YRL4ZB4R.js";
+} from "../chunk-Z5PL3K7C.js";
 import "../chunk-NKXSILEW.js";
 
 // bin/pushary-setup.ts

package/dist/bin/pushary-stop-hook.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   handleStop
-} from "../chunk-NFKYZY74.js";
+} from "../chunk-IAOXM7X5.js";
 import "../chunk-DWED7BS3.js";
-import "../chunk-YRL4ZB4R.js";
+import "../chunk-Z5PL3K7C.js";
 import "../chunk-NKXSILEW.js";
 
 // bin/pushary-stop-hook.ts

package/dist/{chunk-NFKYZY74.js → chunk-IAOXM7X5.js}

@@ -12,7 +12,7 @@ import {
   matchToolPattern,
   redactSecrets,
   redactSecretsDeep
-} from "./chunk-YRL4ZB4R.js";
+} from "./chunk-Z5PL3K7C.js";
 import {
   getApiKey,
   getBaseUrl

package/dist/{chunk-2BHYQCF7.js → chunk-P6QBZS27.js}

@@ -20,12 +20,12 @@ import {
   savePendingQuestion,
   sendNotification,
   waitForAnswer
-} from "./chunk-NFKYZY74.js";
+} from "./chunk-IAOXM7X5.js";
 import {
   effectiveWaitSeconds,
   hookWaitClamped,
   hookWaitDeadline
-} from "./chunk-YRL4ZB4R.js";
+} from "./chunk-Z5PL3K7C.js";
 import {
   getApiKey
 } from "./chunk-NKXSILEW.js";

package/dist/{chunk-76F75WQQ.js → chunk-QNEYHDKR.js}

@@ -1,6 +1,6 @@
 import {
   HOOK_BUDGETS
-} from "./chunk-YRL4ZB4R.js";
+} from "./chunk-Z5PL3K7C.js";
 
 // src/claude-config.ts
 import { join } from "path";

package/dist/{chunk-QDPUTE2V.js → chunk-X3YCHQQK.js}

@@ -1,6 +1,6 @@
 import {
   HOOK_BUDGETS
-} from "./chunk-YRL4ZB4R.js";
+} from "./chunk-Z5PL3K7C.js";
 
 // src/codex-config.ts
 import { createHash } from "crypto";

package/dist/{chunk-YRL4ZB4R.js → chunk-Z5PL3K7C.js}

@@ -1,4 +1,4 @@
-// ../../../../../packages/contracts/src/index.ts
+// ../contracts/src/index.ts
 var APPROVAL_MODES = ["push_only", "terminal_only", "push_first", "notify_only"];
 var isApprovalMode = (value) => typeof value === "string" && APPROVAL_MODES.includes(value);
 var HOOK_BUDGETS = {

package/dist/src/index.js

@@ -1,6 +1,6 @@
 import {
   handlePreToolUse
-} from "../chunk-2BHYQCF7.js";
+} from "../chunk-P6QBZS27.js";
 import "../chunk-KQYIHZ5E.js";
 import {
   askUser,
@@ -14,9 +14,9 @@ import {
   reportEvent,
   resolvePolicy,
   waitForAnswer
-} from "../chunk-NFKYZY74.js";
+} from "../chunk-IAOXM7X5.js";
 import "../chunk-DWED7BS3.js";
-import "../chunk-YRL4ZB4R.js";
+import "../chunk-Z5PL3K7C.js";
 import {
   getApiKey,
   getBaseUrl

package/package.json

@@ -1,7 +1,28 @@
 {
   "name": "@pushary/agent-hooks",
-  "version": "0.28.0",
+  "version": "0.28.2",
   "description": "Permission hooks for AI coding agents: route tool approvals through Pushary push notifications",
+  "keywords": [
+    "pushary",
+    "claude-code",
+    "claude-code-hooks",
+    "codex",
+    "cursor",
+    "gemini-cli",
+    "hermes",
+    "mcp",
+    "mcp-server",
+    "ai-agent",
+    "ai-coding-agent",
+    "human-in-the-loop",
+    "hitl",
+    "push-notifications",
+    "notifications",
+    "agent-permissions",
+    "permission-hooks",
+    "tool-approvals",
+    "pretooluse"
+  ],
   "author": "Pushary <business@pushary.com>",
   "homepage": "https://pushary.com",
   "repository": {
@@ -9,6 +30,9 @@
     "url": "git+https://github.com/pushary/pushary.git",
     "directory": "packages/agent-hooks"
   },
+  "bugs": {
+    "url": "https://github.com/pushary/pushary/issues"
+  },
   "license": "MIT",
   "type": "module",
   "engines": {