chaarDocsDownloadConsole

Install

Install on your computer

Install the chaar app and the chaar command on the computer you sit at, and let your other devices reach it.

For a server or a cloud VM, see Install on a server instead.

Steps for

What you need

A Mac with Apple silicon and macOS 13 or later.

Install the app

Download for macOSApple silicon · .dmg · 33 MB

Open it and drag chaar to Applications.

  1. Open chaar from Applications. On Welcome to chaar, choose Allow network access, then Allow when macOS asks. This lets chaar connect straight to your machines on the same network.
  2. Sign in. No account yet? Choose New to chaar? Create account.

Add the chaar command

The chaar command opens your machines and sessions from any terminal.

  1. Click chaar's icon in the menu bar and choose Install Command Line Tool…. Type your password if macOS asks.
  2. When chaar says Command line tool installed, open a new terminal window and run chaar.

If the menu has no Install Command Line Tool…, the command is already installed.

The first time, chaar asks you to sign in. See Use chaar in a terminal.

Let your devices reach this computer

  1. Click chaar's icon in the menu bar and choose Turn on.
  2. Your browser opens. Type a Machine name, 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 and Authenticated. chaard is chaar's background service, so this means your other devices can reach this Mac.

chaar now starts in the menu bar when you log in. Close its window and this Mac stays reachable. Quit chaar and it doesn't, until you open chaar again. Turn off in the same menu stops it too.

Update

chaar doesn't update itself. Update all your computers, servers and phones together: see A device says chaar needs updating for why.

Quit chaar, replace it in Applications with the new download, and open it. Quitting ends any agent chats running on this Mac. If you installed the chaar command with Homebrew instead, also run brew upgrade sixtythreelabs/tap/chaar.

Stuck? Ask in the Discord community.

↑↓Move↩Open