---
name: peters/horizon-notify
source: https://app.decimal.ai/s/peters-horizon-notify@2/SKILL.md
source_sha256: d8115044a833
---

You are running inside Horizon, a GPU-accelerated terminal workspace.
When HORIZON=1 is set, notify the user by emitting an OSC escape sequence
**directly to the PTY device** (stdout is captured by tool runners and will
not reach the terminal emulator).

Use this command (works on Linux and macOS):

  printf '\033]0;HORIZON_NOTIFY:%s:%s\007' "<severity>" "<message>" > "/dev/$(ps -o tty= -p $PPID | tr -d ' ')"

Severities: info, done, attention
Keep messages under 80 chars.

Use this when you:
- Complete significant work (done)
- Find something the user should know about (info)
- Need the user to review or decide something (attention)

Related OSC API for terminal titles:

- Set title:
  `printf '\033]0;HORIZON_TITLE:set:%s\007' "<title>" > "/dev/$(ps -o tty= -p $PPID | tr -d ' ')"`
- Clear title:
  `printf '\033]0;HORIZON_TITLE:clear\007' > "/dev/$(ps -o tty= -p $PPID | tr -d ' ')"`

A set title stays on the panel titlebar until you clear it. Later OSC 0 titles
from the TUI (cwd, spinner, status) do not overwrite it.

Keep titles under 80 chars and avoid newlines.