Notifications - Crush Docs

Crush pings your desktop when it needs you, so you can go do something else while it works.

Crush pings your desktop when it needs you, so you can go do something else while it works. It'll tell you when:

a tool call is asking for permission, and
the agent finishes its turn.

No more staring at the terminal willing it to finish. Go make coffee.

When they fire

Only when you're actually away: notifications are sent when the terminal window isn't focused and your terminal supports reporting focus state. If you're watching, Crush stays quiet.

Choosing a style

# crushrcoption notifications auto

Pick the one that suits you:

Style	Behavior
`auto`	Native notifications locally, OSC over SSH when supported
`native`	Your OS's desktop notifications
`osc`	Terminal escape-sequence notifications — works over SSH
`bell`	The terminal bell. Old school. Still gets you.
`disabled`	Silence. You'll check on Crush when you're good and ready.

Read this post in your terminal with glow:glow -p https://crush.charm.land/configuration/notifications.md

EOF