@clang.engineer/pi-notify

Completion and permission notifications for Pi coding agent

Packages

Package details

extension

Install @clang.engineer/pi-notify from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@clang.engineer/pi-notify
Package
@clang.engineer/pi-notify
Version
0.1.2
Published
Oct 3, 2026
Downloads
527/mo · 53/wk
Author
clang.engineer
License
MIT
Types
extension
Size
7.6 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@clang-engineer/pi-notify

Notification extension for Pi coding agent.

Features

  • Notifies on agent_settled.
  • Notifies on permissions:ask.
  • Backend: auto, macos, terminal, or off.
  • Optional last-input summary in completion notification titles.
  • Optional macOS notification sound.
  • Optional script hook.

Config

Global: ~/.pi/agent/notify.json
Project: <project>/.pi/notify.json

{
  "notify": {
    "title": "Pi",
    "settledMessage": "Agent 작업 완료",
    "includeInput": true,
    "maxInputLength": 80,
    "permissionAsk": true,
    "permissionMessage": "Permission required: {tool}",
    "backend": "auto",
    "skipWhenFrontmost": false,
    "sound": "Glass"
  }
}

Set sound to a macOS sound name such as Glass, Ping, or Submarine. Set it to false to disable sound.