Skip to content

notify-on-idle.md

Latest commit

 

History

History
44 lines (31 loc) · 757 Bytes

notify-on-idle.md

File metadata and controls

44 lines (31 loc) · 757 Bytes

Notify on idle

The smallest possible visible confirmation that hooks are working: a notification each time PI finishes a turn with no pending messages.

Hook snippet

hooks:
  - id: idle-notify
    event: session.idle
    actions:
      - notify: "Agent is idle"

Where to put it

Usually:

~/.pi/agent/hook/hooks.yaml

What it does

When PI finishes a turn and has no pending messages, it shows a notification.

Quick test

  1. Start PI
  2. Do one normal agent turn
  3. Wait for the turn to finish
  4. Confirm the notification appears

Notes

  • In headless PI, notify is skipped.
  • If you want richer details, use the long form with a level:
actions:
  - notify:
      text: "Idle"
      level: success