---
name: Horizon Notify
slug: horizon-notify
category: Automation
description: Horizon Notify sends OSC alerts to the Horizon terminal user when work is done, a finding matters, or a decision is needed. It only works when HORIZON=1 is set.
github: "https://github.com/peters/horizon/tree/main/assets/plugins/claude-code/skills/horizon-notify"
language: Rust
stars: 697
forks: 26
install: "npx degit https://github.com/peters/horizon/tree/main/assets/plugins/claude-code/skills/horizon-notify ~/.claude/skills/horizon-notify"
installs_to: ~/.claude/skills/horizon-notify
source_path: assets/plugins/claude-code/skills/horizon-notify/SKILL.md
collection_size: 1
category_size: 1523
added: 2026-08-23T05:20:51.514Z
last_synced: 2026-08-23T05:20:51.514Z
canonical_url: "https://dirskills.com/skills/horizon-notify"
---

# Horizon Notify

Horizon Notify sends OSC alerts to the Horizon terminal user when work is done, a finding matters, or a decision is needed. It only works when HORIZON=1 is set.

**Install:**

```bash
npx degit https://github.com/peters/horizon/tree/main/assets/plugins/claude-code/skills/horizon-notify ~/.claude/skills/horizon-notify
```

## README

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 ' ')"`

Keep titles under 80 chars and avoid newlines.