Appearance
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
| What | When | Switch |
|---|---|---|
| Agent needs you | an agent is waiting for an answer or a permission | Agent needs you |
| Agent finished | an agent finished its turn | Agent finished |
| Long command finished | a long-running command finished fine | Long command finished |
| Command failed or stuck | a long command failed, was stopped, or was stopped because it could never finish | Command failed or stuck |
| Account limits and moves | a Claude account hit its limit, or an agent was moved to another account | Account limits and moves |
| New Ghosted version | a newer Ghosted is out | New Ghosted version |
| Terminal bell | a program in a pane rang the bell | Terminal 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 offRun 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.