chaarDocsDownloadConsole

Getting started

Quick start

Set up chaar on your computer and your phone, and open the same session on both.

In about ten minutes you'll have a session running on your computer that you can open from your phone.

Steps for

1. Install chaar

Download for macOSApple silicon · .dmg · 33 MB

Open it and drag chaar to Applications.

Open chaar from Applications. On Welcome to chaar, choose Allow network access, then Allow when macOS asks. This lets chaar connect straight to machines on the same network.

2. Make an account and sign in

  1. On the sign-in screen, choose New to chaar? Create account. Your browser opens the console, chaar's website. (Signing in to the app never creates an account.)
  2. Choose Sign up with your email, or with Google, Apple or GitHub.
  3. Verify your email from the link chaar sends you. Do it soon: if you sign in with Google, Apple or GitHub using the same email first, that sign-in takes over the account and its password stops working.
  4. Back in the app, sign in with your email and password, or the same Google, Apple or GitHub account.

3. Let your devices reach this computer

  1. Click chaar's icon in the menu bar, the striped circle at the top right of your screen, and choose Turn on.
  2. Your browser opens. Type a Machine name, such as office-macbook, pick one or more workspaces under Workspace, and choose Register machine. If this Mac was registered before, choose Authenticate machine instead.
  3. The menu now says chaard: Running. chaard is chaar's background service, so this means your other devices can reach this Mac.

4. Open a session

  1. Find your machine's card in the sidebar, and click + on it. If it says Offline, see A machine shows Offline.
  2. The new session asks what its first tab should be. Choose Terminal.
  3. Run something that takes a while, such as top.
session-1
Pick its first tab on office-macbook
Terminal
Agents
Drawing of an empty session in the desktop app.

5. Open it on your phone

  1. Install chaar on your phone:

    Beta on TestFlight · scan the code with your phone

    Get chaar on your phone

    Pick your phone, then point its camera at the code.

    iPhoneBeta on TestFlightOpen the link
  2. Open it and sign in with the same account.

  3. Allow notifications when it asks, so chaar can tell you when something needs you.

  4. Home lists your machines and their sessions. Tap your new session, such as session-1: it's the same one, with top still running.

Next

Stuck? Ask in the Discord community.

↑↓Move↩Open