Skip to content

Notifications ​

Ghosted can tell you when something needs you: an agent asks a question, an agent finishes, a long command fails. You choose what it tells you about, and how. (From 1.0.7.)

The quickest way is Settings (in the activity bar, or ctrl+b s): the Notifications group has a switch or a − / + for each of the options below. Changes take effect at once.

What can interrupt you ​

WhatWhenSwitch
Agent needs youan agent is waiting for an answer or a permissionAgent needs you
Agent finishedan agent finished its turnAgent finished
Long command finisheda long-running command finished fineLong command finished
Command failed or stucka long command failed, was stopped, or was stopped because it could never finishCommand failed or stuck
Account limits and movesa Claude account hit its limit, or an agent was moved to another accountAccount limits and moves
New Ghosted versiona newer Ghosted is outNew Ghosted version
Terminal bella program in a pane rang the bellTerminal bell
"Copied"you copied text"Copied" toast

Notifications at the top of the group turns all of them off at once (except "Copied"). The Inbox in Spaces still collects what needed you, so nothing is lost while they're off.

How they reach you ​

  • Show them: off, in Ghosted (a card in the corner of the window; click it to go there), via terminal (your terminal's desktop notification, in terminals that support it) or desktop (the system's own notifications).
  • Sound: a chime with each one. Custom sounds and per-agent sounds are in the config file (below).
  • Toasts stay: until you close them, a few seconds, or 5, 10, 20 or 60 seconds.
  • Wait before telling you: an agent has to still be waiting (or done) after this long, so a quick flicker doesn't notify you.
  • Quiet in the tab you're in: on (the default), nothing about the tab you're looking at. Turn it off to hear about that tab too.
  • Only when you're away: on, nothing while the Ghosted window is in front; you hear about things only when you're working somewhere else.

In the config file ​

The same options live in Ghosted's ~/.config/ghosted/config.toml (see Configuration). Every one is optional:

toml
[ui.notifications]
enabled = true                # false: nothing interrupts you
agent_needs_you = true
agent_finished = true
job_finished = true
job_failed = true
accounts = true
update_available = true
terminal_bell = true
toast_seconds = 0             # how long fading cards stay; 0 = Ghosted's own
quiet_in_current_tab = true
quiet_while_focused = false   # true: only when the window isn't in front

[ui.toast]
delivery = "ghosted"          # "off", "ghosted", "terminal" or "system"
delay_seconds = 1
stay = true                   # false: cards fade after toast_seconds

[ui.toast.clipboard]
enabled = true

[ui.sound]
enabled = true
# done_path = "sounds/done.mp3"       # your own mp3s
# request_path = "sounds/request.mp3"

[ui.sound.agents]
# droid = "off"                       # per agent: default, on or off

Run ghosted server reload-config after editing the file by hand.

When you use Ghosted on several machines, the machine running the agents decides what it sends, and your window can quiet anything further.

Made by Megasupersoft. Free to use; not open source. Built on herdr (Apache-2.0).