Focus.AI Labs / Artifact Field Notes Extensions
Fast browse / jump off / source-grounded
Extensions

ferologics/pi-notify

Native desktop notifications via OSC 777

Origin
seed-list
Extensibility
package
Primary interface
unknown

What this artifact is for

The quick orientation layer before you go deeper upstream.

Profile

Summary

Native desktop notifications via OSC 777

Seed description: Native desktop notifications via OSC 777

Category: Extensions

Best for: Not yet synthesized.

Signals

How to read this page

Workflow tags: notifications

Integrations: none captured

Caveats: No caveats captured yet

Maturity: No maturity signals captured

README excerpt

More of the actual upstream surface so you can skim here before deciding to open the repo.

Upstream skim

A Pi extension that sends a native desktop notification when the agent finishes and is waiting for input.

| Terminal | Support | Protocol | | ------------------------------ | ------- | ------------------------------- | | Ghostty | ✓ | OSC 777 | | iTerm2 | ✓ | OSC 9 | | WezTerm | ✓ | OSC 777 | | rxvt-unicode | ✓ | OSC 777 | | Kitty | ✓ | OSC 99 | | tmux (inside a supported term) | ✓* | tmux passthrough + OSC 777/99/9 | | Windows Terminal | ✓ | PowerShell toast | | Terminal.app | ✗ | — | | Alacritty | ✗ | — |

\* tmux requires passthrough enabled in your tmux config:

Preview source: captured upstream text ↗

What shows up in the source

Quick topics

pi-notifyCompatibilityInstallHow it worksOptional: Custom sound hookExample (macOS)Example (Linux)Example (Windows PowerShell)

Skim bullets

  • OSC 777 (Ghostty, WezTerm, rxvt-unicode): Native escape sequence
  • OSC 9 (iTerm2): iTerm2 notification protocol, detected via TERM_PROGRAM=iTerm.app
  • OSC 99 (Kitty): Kitty's notification protocol, detected via KITTYWINDOWID
  • tmux passthrough: OSC sequences are wrapped automatically when TMUX is set
  • Windows toast (Windows Terminal): PowerShell notification, detected via WT_SESSION
  • tmux works only with passthrough enabled (set -g allow-passthrough on).
  • zellij/screen are still unsupported for OSC notifications.

Sources and provenance

Everything on this page should be traceable back to the list seed or an upstream surface.

Provenance

Discovery reason: Listed in the awesome-pi-agent README

Discovered from: seed artifact

Claim confidence: medium

Surface capture kind: repo-readme