it2 notify

Post macOS notification

Synopsis

it2 notify <message> [session-id] [flags]

Description

Post a notification to macOS Notification Center via iTerm2.

The notification is posted using iTerm2's escape sequence mechanism (OSC 9).
If no session ID is provided, uses the current session.

Options

--format (default "table"): Output format (table|json|yaml|text)
--timeout (default "5s"): Command timeout
--url (default "ws://localhost:1912"): iTerm2 WebSocket URL

See Also

it2 - iTerm2 API Command-Line Interface

Examples

# Notify current session
$ it2 notify "Build completed"

# Notify specific session
$ it2 notify "Task finished" abc123

# Use with session lookup
$ it2 notify "Job done" $(it2 session current)