Skip to content
Development
Skill

/horizon-notify

Notify the Horizon workspace user about completed work, findings, or needed decisions. Only works when HORIZON env var is set.

From plugin
horizon
6952 skills
Install
$ npx -y skills add peters/horizon --skill horizon-notify --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/horizon-notify

Context preview

The summary Claude sees to decide when to auto-load this skill.

Notify the Horizon workspace user about completed work, findings, or needed decisions. Only works when HORIZON env var is set.

SKILL.md

horizon-notify.SKILL.md
name: horizon-notify
description: Notify the Horizon workspace user about completed work, findings, or needed decisions. Only works when HORIZON env var is set.
user-invocable: false

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.

Ships withhorizon

GPU-accelerated terminal board that puts all your sessions on an infinite canvas

Get the whole plugin
Stats
695
Stars
26
Forks
Active
Maintenance
Rust
Language
MIT
License
2h ago
Last commit
4mo ago
Created

Repo: peters/horizon