chaarDocsDownloadConsole

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.

Steps for

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.

MarkWhat it saysWhat it meansGoes awayCommand line
WorkingIt's running.Goes away: When it reports a new state◐
Working · 60%It's running, and it said how far along it is.Goes away: When it reports a new state◐ 60%
Done · not opened yetIt finished a piece of work you haven't looked at yet.Goes away: Once its tab is on your screen✓
Needs your OKIt can't go on until you approve something.Goes away: When it reports a new state◆
Needs your answerIt can't go on until you type an answer.Goes away: When it reports a new state?
Needs your sign-inIt can't go on until you give it a login, token or other credential.Goes away: When it reports a new state⚷
FailedIt failed and stopped, and you haven't opened it since.Goes away: Turns into the outline once its tab is on your screen✗
FailedIt failed and stopped, and you've opened it since.Goes away: When it runs again✗
EndedThe program, or the agent, is gone.Goes away: When you close its tab, or the agent starts again○

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.

Needs you
api-fixNeeds your OK · studio
nightly buildFailed · build-box
docsDone · studio
Drawing of the inbox in the desktop app.

To jump straight to the next agent chat that needs you, press ⌘J.

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.

↑↓Move↩Open