Guides
Get notified
What each status mark means, where the Needs you inbox is, and how your computer, phone and terminal tell you when something changes.
See at a glance what each tab is doing, and get told on your computer, phone or terminal when something needs you, fails or finishes.
The status marks
Each tab and agent chat shows a mark for what it's doing. Agent chats report on their own. A terminal tab shows a mark only when the program in it reports its status: to make your own scripts do that, see Show status from your scripts.
The desktop app and the phone draw the same marks. The chaar command prints a text mark for each.
◐◐ 60%✓◆?⚷✗✗○You see the marks on each tab, on session rows on Home, on folded session rows in the desktop sidebar, and in the chaar command's list of sessions. A session row shows its most urgent tab: needs you first, then failed, done and working.
Needs you
Needs you, the inbox, lists every tab and agent chat that needs you, failed, or finished while you weren't looking, most urgent first. Each row shows the program's tile, the name, the state, the machine and the program's message, if it sent one. Pick a row to open it. When there's nothing, it says Nothing needs you right now.
In the desktop and phone apps, the inbox button's badge counts the rows. It's orange while something needs you, and red if something failed and nothing needs you. The inbox shows the workspace you're viewing.
Click the inbox button at the right end of the sidebar's top row. With the sidebar hidden, it's in the top bar, left of the profile button.
To jump straight to the next agent chat that needs you, press ⌘J.
Tap the inbox button at the bottom left of Home. You can also tap the search button at the bottom right of Home and pick Needs you, or tap a notification.
In a session, press ctrl-bi. Pick a row and press enter to open that tab. This list covers all your workspaces and Shared.
While something needs you, the session's bar shows a count, such as ! 2 need you · ctrl-b i.
When a mark goes away
Done and Failed are for things you haven't looked at yet. They count as seen once you look at the tab or chat in chaar. On the phone, opening a session counts all of its terminal tabs as seen. Then:
- Done goes away.
- Failed turns into the outline , until the program does something else.
Looking doesn't clear a request. A needs-you mark goes away once you answer and the program moves on.
What you've seen on one device clears on your other devices too.
Notifications
Your devices tell you when a tab or agent chat starts needing you, fails or finishes, unless you're looking at it in chaar. You're only notified about new changes. Older ones wait in Needs you.
On your computer
While chaar is running, you get a notification from your system, with the program's message (up to 200 characters) if it sent one. Click it to open that tab or chat. When something needs you, a card with an Open button also appears at the top right of the window. Done and failed get no card: they wait in Needs you.
When you close the window, chaar stays in the menu bar and keeps notifying you. After you quit chaar, nothing notifies you until you open it again.
On your phone
Your machines send notifications to your phone even while chaar is closed. A notification names the session and says what happened, such as Needs your OK or Done. It never includes the program's message. Tap it to open Needs you, then tap a row to go straight to its tab.
To get them, allow notifications when the app asks: see Install on your phone.
In a terminal
While chaar is running, it asks your terminal to show a notification. Whether one appears depends on your terminal. If none arrive, see Troubleshooting.
Only from your own machines
Your phone gets notifications only from machines you set up with your own account. Machines shared with you, or added by other people in your workspace, never send them, and there's no way to turn that on. Their marks still show in the app.
Keep phone notifications coming
Open the phone app at least every two weeks, and visit each workspace with your machines, or your machines stop sending to this phone.
If they stop anyway, see No notifications on your phone.
Turn phone notifications off
Turn off notifications for chaar in your phone's settings. chaar has no switch of its own. Logging out stops notifications to this phone.
Stuck? Ask in the Discord community.