Horizon Notify
Productivityhorizon-notifyHorizon Notify is an Agent Skill for productivity published in the peters/horizon repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Notify the Horizon workspace user about completed work, findings, or needed decisions. Only works when HORIZON env var is set.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/peters/horizon/blob/HEAD/assets/plugins/claude-code/skills/horizon-notify/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/horizon-notify, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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' "" "" > "/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.