Getting Started

Jojo is a desktop terminal for running and supervising many Claude Code sessions at once, on your own computer and on Linux servers over SSH. This guide explains how to install it, how the window is organized, and how to use each feature.

Covers Jojo 0.2.5 (alpha) for Windows 11 and macOS.

Jojo combines a terminal emulator and a terminal multiplexer in one window. Sessions are grouped by location and project; each project has its own tabs, and each tab holds up to four split panes.

Start using Jojo by running one command for your computer. Each command downloads the latest release, installs it and opens Jojo. Run the same command again later to upgrade. Installing and upgrading explains what each command does and how to install by hand instead.

Windows 11, in PowerShell:

macOS, in Terminal:

How Jojo is built

Jojo is built from two programs:

1. The window (Jojo.exe on Windows, Jojo.app on macOS) draws the sidebar, tabs and terminals. It holds no terminal state of its own.
2. The daemon, jojod, runs in the background and owns every terminal session. There is one daemon on your computer and one on each Linux server you add.

Because the daemon owns the sessions, closing, crashing or restarting the window does not stop any of them. When the window opens again, it reconnects to the daemon and repaints every pane as it was. Claude Code hooks report each session's state (working, waiting for you, done, failed) to the daemon, and the window shows that state on every pane, tab and sidebar row.