chaarDocsDownloadConsole

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.

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.
ActionWhat it does
New sessionStarts a session.
Needs youOpens Needs you.
Switch workspaceShows another workspace on Home.
Delete sessionAsks which session, then asks you to confirm.
MembersOpens Sharing.
Log outAsks, then signs you out.
New tabWhile a terminal tab is open: adds a terminal tab.
New agent chatWhile 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

Stuck? Ask in the Discord community.

↑↓Move↩Open