Guides
Use chaar on your phone
Home, the terminal and its key bar, search, and settings in the chaar phone app.
Find your sessions on Home, type in the terminal with the key bar, and set the app up the way you like.
To install the app and sign in, see Install on your phone. Starting, splitting, renaming and closing sessions and tabs are on Sessions and tabs.
Find your way around Home
Home shows one workspace at a time: its machines, and the sessions on each one.
- Top left: the workspace's name. Tap it to switch workspace, or to see Shared with me.
- Top right: the people button opens Sharing, with the workspace's members, and the gear opens Settings.
- Bottom left: Needs you, the inbox of what's waiting on you, with a count. See Get notified.
- Bottom right: the new-session button, and the magnifying glass for search.
Pull down to refresh.
Move between workspaces
Swipe sideways across the list to move to the next workspace. Shared with me comes last: it holds the machines people shared with you from workspaces you aren't in. See Share with others.
See who can use a machine
Long-press a machine's header and pick Who has access. To change who has access, see Share with others.
Open a session
Tap a session's row on Home. It opens on the tab that was used last, on any device.
- Switch session: tap the session's name in the rounded button at the top left.
- Go back to Home: tap the back arrow in the same button.
Type in the terminal
- Type: tap the terminal to bring up the keyboard.
- Scroll: drag up or down.
- Change the text size: pinch with two fingers.
- See only the terminal: tap the eye at the top right. Tap it again to bring everything back.
Use the key bar
The key bar sits above the keyboard.
- On the left, the search button opens search.
- In the middle, a row of keys: escape, tab, control, alt, command on iPhone and iPad, symbols and paste. Swipe it sideways to see them all.
- On the right, the joystick moves the cursor. Push it the way the cursor should go, and let go to stop.
To use control, alt or command, tap it, then the next key. Tap it twice quickly to lock it on, and tap it again to turn it off. The paste key pastes your phone's clipboard.
Copy text from the terminal
You can't copy text from the terminal on iPhone or iPad. You can paste into it with the paste key.
- Long-press a word. It's selected.
- Drag to select more.
- Tap Copy in the menu that appears.
Search for anything
Search finds sessions, tabs, workspaces and actions in one field. Open it with the magnifying glass on Home, or the search button on the key bar.
- With nothing typed, it suggests the actions you used last, and lists the sessions.
- To narrow it to one machine, tap that machine's name under the field.
- To open a result, tap it.
- To start a session with your own name, type a name no session on the machine has, then tap the row that says Create name on machine.
| Action | What it does |
|---|---|
| New session | Starts a session. |
| Needs you | Opens Needs you. |
| Switch workspace | Shows another workspace on Home. |
| Delete session | Asks which session, then asks you to confirm. |
| Members | Opens Sharing. |
| Log out | Asks, then signs you out. |
| New tab | While a terminal tab is open: adds a terminal tab. |
| New agent chat | While a terminal tab is open: starts an agent chat. |
Change the app's settings
Tap the gear at the top right of Home. Settings shows your account and the workspace, with Open console (chaar's website), Appearance, the app's version, links to these docs, and Log out.
Appearance has a Mode: System, Light or Dark. Under it are the same six themes as the desktop app. See Settings.
See also: turn notifications off, and see whether you're connected directly.
Next
- Sessions and tabs: start, split, rename and close.
- Work with AI agents: start an agent and answer it from your phone.
- Get notified: know when a tab or chat needs you.
Stuck? Ask in the Discord community.