Guides
Settings
Themes, machine colours, keys, keep awake, the Mac menu bar, quitting and signing out in the desktop app.
Change how the desktop app looks and which keys it uses, keep your computer awake, and control whether your other devices can reach it. For the phone app's settings, see Use chaar on your phone.
Open Settings
Press ⌘, on a Mac or Ctrl, on Windows and Linux, or click the profile button at the bottom of the sidebar.
Settings opens in its own window:
- Profile: your email, your workspace, Open console and Log out.
- Appearance: light or dark, the theme, and machine colours.
- Keyboard Shortcuts: every action and its key.
- About: the app's version, and links to these docs.
Your settings are saved on this computer only.
Change the theme
- Open Appearance.
- At the top, pick System, Light or Dark. System follows your computer.
- Under it, pick a theme: Graphite (the default), Catppuccin, Gruvbox, Rosé Pine, Tokyo Night or Modus.
Each theme has a light and a dark version and its own terminal colours.
You can also switch theme from the command palette. Its key is on Keyboard shortcuts.
Choose a machine's colour
Every machine has a colour. Machine colours show on tab badges in groups, where tabs from different machines sit side by side: see Sessions and tabs.
- Open Appearance and find the machine in the Machines list.
- Click one of its six colour dots.
Each theme has six machine colours. Switching theme keeps each machine's colour position in the new theme:
Change a shortcut
Open Keyboard Shortcuts
Open Settings and choose Keyboard Shortcuts. Or open the shortcut sheet and choose Change keys.
Find the action
Type its name, or a key it uses, into Search actions or keys.
Press the new key
Click the action's row and press the new key. To stop without changing anything, press Esc.
The new key works straight away, and the menus and command palette show it.
- If another action has the key, chaar names it. Choose Replace to take the key, or Cancel.
- If chaar can't use the key, it says why under the row. For example, your system keeps it, or it types text and needs a modifier key as well.
- To put a key back, click Reset on its row. Reset All at the top puts every key back.
For every action and its default key, see Keyboard shortcuts.
Keep your computer awake
Keep awake stops your computer going to sleep, so whatever runs on it keeps going. The screen can still dim and lock. It's in the Mac and Linux apps, not the Windows app.
- Click the cup button at the top of the sidebar.
- Pick how long: 1, 2 or 4 hours, or Until I turn it off. The button now shows the time left.
- To stop early, open the menu again and choose Turn off.
Keep awake is always off when chaar opens. If it doesn't work on Linux, see Troubleshooting.
On a Mac, use the cup button for a set time, and the menu bar's Keep Mac awake to stay awake until you quit chaar.
Turn this Mac on or off from the menu bar
While chaar runs, with its window open or closed, its icon sits in the menu bar. The menu decides whether your other devices can reach this Mac.
- Turn on lets your other devices reach this Mac. If this Mac isn't signed in yet, your browser opens to sign it in first. chaar also starts in the menu bar each time you log in.
- Turn off stops that. Your other devices can't reach this Mac, and chaar no longer starts when you log in.
- Keep Mac awake keeps this Mac from sleeping until you untick it or quit chaar. It's separate from the cup button, and off each time chaar starts.
- Install Command Line Tool… shows if chaar found no
chaarcommand when it started. See Add the chaar command.
The icon's stripes are full while chaar's service is running, and faded while it's turned off. Three dots in the corner mean signing in is in progress. Any other mark means something needs fixing: see Troubleshooting.
The menu and chaar service enable control the same service.
Close or quit the app
Quitting turns this Mac off
Quitting chaar turns this Mac off for your other devices, even if you turned it on from a terminal.
Close the window, and chaar keeps running in the menu bar. It keeps sending notifications, and this Mac stays reachable. To get the window back, open chaar again, or click one of its notifications.
Quit (⌘Q, or Quit in the menu bar) doesn't ask first, and this Mac stays unreachable until you open chaar again. Terminal tabs keep running, but agent chats on this Mac end. To step away and stay reachable, close the window instead.
Sign out
Open Settings, choose Profile, then Log out. The app signs out straight away.
This signs out the desktop app only. The chaar command signs out with chaar logout, and this computer stays reachable until you turn it off.
Stuck? Ask in the Discord community.