chaarDocsDownloadConsole

Reference

FAQ

Short answers to the questions people ask first, each with a link to the page that covers it in full.

What is chaar?

chaar runs terminals and coding agents on your Mac and Linux machines: the computer you sit at, a server, a cloud VM. You open them from the desktop app, the phone app and the chaar command, and they keep running while you're away. See Introduction.

Do I need the desktop app on every machine?

No. Put the desktop app on the computer you sit at. A server or a cloud VM needs only the chaar command. Any Mac or Linux computer becomes a machine your other devices can open once chaar's service is turned on there. See Install on your computer and Install on a server.

What keeps running when I quit or restart?
  • Closing the window: everything keeps running.
  • Quitting chaar on a Mac (⌘Q or any Quit): your other devices can't reach the Mac until you open chaar again, and its agent chats end.
  • Restarting chaar's service (as when you update): agent chats end. They show as Ended and open again where they can carry on.
  • Restarting the machine: its terminal tabs close. Agent chat tabs stay. A session that had only terminal tabs is gone.

Quitting on a Mac doesn't ask first. To step away and stay reachable, close the window instead. On Windows and Linux, closing the last window quits the app. On Linux, quitting the app doesn't change whether other devices can reach the computer. See Settings.

Can my other devices reach a Windows PC?

No. Only a Mac or a Linux computer can be a machine. On Windows, the desktop app and the chaar command can still open your Mac and Linux machines.

Which devices does chaar run on?

The desktop app and the chaar command run on Macs with Apple silicon and macOS 13 or later, on Windows and on Linux. There's no build for Intel Macs, and Linux distributions built on musl, such as Alpine, aren't supported. See Install on your computer.

The phone app runs on iPhone and iPad with iOS 17 or later, and on Android. For now it's in testing. See Install on your phone.

Why do I sign in three times on one computer?

The app, the chaar command and the machine each sign in on their own. Signing one out leaves the other two as they are.

What signs inWhat it's forSign inSign out
The appOpening your machines in the desktop appThe app's sign-in screenLog out in Settings › Profile
The chaar commandOpening your machines from a terminalchaar login, or any command that needs itchaar logout
This machineLetting your devices reach this computerTurn on on a Mac, chaar service enable or chaar service loginchaar service logout

If a machine asks to be signed in again, see The owner has to sign this machine in again.

Which agents does chaar work with?

Claude Code and opencode today, once each is installed on the machine. More agents are coming soon. Any other agent runs in a terminal tab, like any program. See Work with AI agents.

Can I use agents from the terminal?

Partly. In the chaar command, an agent chat shows as a tab with its status mark, and you get its notifications. You can't read it, type in it, approve anything in it, or start one there. You can still run an agent's own command-line program in a terminal tab. See Use chaar in a terminal.

How do I leave a session in the terminal without stopping it?

Press ctrl-bd. The session keeps running, and chaar connect takes you back to it. Don't use ctrl-c to leave: it goes to the program in the tab and can stop it. See Use chaar in a terminal.

Can I do everything from the chaar command?

No. You can open sessions, work in their terminal tabs and see status marks. You can't share a machine: do that on the phone or in the console (chaar's website). Agent chats work as the answer above says. See Terminal commands.

Do I need to open ports or set up a VPN?

No. chaar needs no inbound ports and no VPN, but it does need the internet. Your devices connect to a machine directly when the networks allow it. Otherwise it goes through chaar's servers, encrypted end to end so they can't read it. See Network and security.

Who can open a terminal on my machine?

Only you, as its owner, and people you share it with as Can run (Can view: see sessions only; Can run: type in them and start agents). Everyone in the machine's workspace can see its sessions, but can't open them. You share a machine on the phone or in the console. See Share with others.

Does chaar update itself?

No. Update all your devices and machines together: see A device says chaar needs updating.

Stuck? Ask in the Discord community.

↑↓Move↩Open