Skip to content

Security: StackOneHQ/stack-nudge

SECURITY.md

Security policy

Reporting a vulnerability

Please do not open public GitHub issues for security reports. Instead, email security@stackone.com with:

  • A description of the issue and the version of stack-nudge affected.
  • Steps to reproduce or a proof-of-concept, if available.
  • Any known mitigations.

We aim to acknowledge reports within 3 business days and to provide a remediation timeline within 10 business days of the initial acknowledgement.

Scope

In scope:

  • The stack-nudge.app and stack-nudge-panel.app macOS binaries (notifier and floating-panel daemon).
  • The unix-socket protocol the panel daemon uses to receive nudges from notify.sh (~/.stack-nudge/panel.sock).
  • File-permission handling in ~/.stack-nudge/ and the launchd plists installed by install.sh.
  • The shell hook entry point notify.sh and its handling of agent-supplied JSON (Claude Code passes hook payloads on stdin).
  • Supply-chain issues in the immediate stack-nudge repository (e.g. typo-squat risk on installer URLs).

Out of scope (report upstream instead):

  • Vulnerabilities in stackvox (the offline TTS engine) — report to https://github.com/StackOneHQ/stackvox.
  • Vulnerabilities in kokoro-onnx, onnxruntime, or any other dependency of stackvox — report to the respective project.
  • macOS Accessibility / Automation TCC bugs — report to Apple.

Supported versions

stack-nudge is pre-1.0. Only the latest published release receives security fixes. Once 1.0 ships, we will maintain the most recent minor release of the current major version.

Privacy

stack-nudge runs entirely locally — see PRIVACY.md for the full story. There is no network telemetry, no analytics, no cloud component. Voice synthesis happens locally via stackvox; the only network traffic at install time is pip install stackvox from PyPI.

There aren't any published security advisories