Repository navigation
Releases
Jojo 0.2.7 (alpha)
Jojo 0.2.7 (alpha).
Installing
The recommended way to install or upgrade is one command:
- Windows (PowerShell):
irm https://raw.githubusercontent.com/josephmcgarvey/Jojo/master/scripts/install-windows.ps1 | iex - macOS (Terminal):
curl -fsSL https://raw.githubusercontent.com/josephmcgarvey/Jojo/master/scripts/install-mac.sh | bash
Each script downloads the latest release, closes Jojo's window if it is open (running sessions keep running in the daemon), installs Jojo and opens it. Because the installer is downloaded by PowerShell or curl rather than a browser, Windows SmartScreen and macOS Gatekeeper do not block the unsigned app.
To install by hand instead, download the file for your computer below:
- Windows (x64):
Jojo_0.2.7_x64-setup.exe. SmartScreen shows "Windows protected your PC": choose More info ▸ Run anyway. - macOS, Apple Silicon (M1 and later):
Jojo_0.2.7_aarch64.dmg. - macOS, Intel:
Jojo_0.2.7_x64.dmg.
A .dmg downloaded in a browser is blocked on first launch: open System Settings ▸ Privacy & Security and choose Open Anyway, or run xattr -dr com.apple.quarantine /Applications/Jojo.app.
0.2.7 does not change the protocol between the window and the daemon, so installing it over any 0.2.x release keeps running sessions.
Changes
- New app icon: the J of the JOJO wordmark in the brand gradient, on a dark blue disc. It replaces the lowercase j on a violet-to-cyan disc in the taskbar, Dock, Start menu and window title bar. Windows and macOS may show the old icon until Explorer or the Dock refreshes its icon cache.
- The icon is also available as
assets/jojo-icon.svgin the repository, for use as a favicon.
Jojo 0.2.6 (alpha)
Jojo 0.2.6 (alpha).
Installing
The recommended way to install or upgrade is one command:
- Windows (PowerShell):
irm https://raw.githubusercontent.com/josephmcgarvey/Jojo/master/scripts/install-windows.ps1 | iex - macOS (Terminal):
curl -fsSL https://raw.githubusercontent.com/josephmcgarvey/Jojo/master/scripts/install-mac.sh | bash
Each script downloads the latest release, closes Jojo's window if it is open (running sessions keep running in the daemon), installs Jojo and opens it. Because the installer is downloaded by PowerShell or curl rather than a browser, Windows SmartScreen and macOS Gatekeeper do not block the unsigned app.
To install by hand instead, download the file for your computer below:
- Windows (x64):
Jojo_0.2.6_x64-setup.exe. SmartScreen shows "Windows protected your PC": choose More info ▸ Run anyway. - macOS, Apple Silicon (M1 and later):
Jojo_0.2.6_aarch64.dmg. - macOS, Intel:
Jojo_0.2.6_x64.dmg.
A .dmg downloaded in a browser is blocked on first launch: open System Settings ▸ Privacy & Security and choose Open Anyway, or run xattr -dr com.apple.quarantine /Applications/Jojo.app.
0.2.6 does not change the protocol between the window and the daemon, so installing it over any 0.2.x release keeps running sessions.
Changes
- The version is shown in the app: at the bottom left of Settings ("Jojo 0.2.6 · jojod 0.2.6", the daemon's version while This PC is connected) and in the tooltip of the JOJO logo at the top of the sidebar.
- One-line install scripts for Windows and macOS (above).
- The repository is public and released under the MIT License.
- The README shows the JOJO logo and has been brought up to date.
Jojo 0.2.5 (alpha)
Jojo 0.2.5 (alpha).
Downloads
- Windows (x64):
Jojo_0.2.5_x64-setup.exe. The installer is unsigned, so Windows SmartScreen shows "Windows protected your PC" on first run: choose More info ▸ Run anyway. - macOS, Apple Silicon (M1 and later):
Jojo_0.2.5_aarch64.dmg. - macOS, Intel:
Jojo_0.2.5_x64.dmg.
The macOS builds are unsigned (ad-hoc signed). On first launch macOS blocks the app: open System Settings ▸ Privacy & Security and choose Open Anyway, or run xattr -dr com.apple.quarantine /Applications/Jojo.app.
0.2.5 does not change the protocol between the window and the daemon, so installing it over any 0.2.x release keeps running sessions.
Snippet placeholders
- A snippet's command can contain
{{name}}, or{{name:default}}with a default value, for examplegit checkout {{branch:main}} && git pull {{remote:origin}} {{branch:main}}. - Inserting or running such a snippet opens a form with one field per name, a preview of the command as it will be typed, and Insert and Run. Enter does what the snippet was opened with; Ctrl+Enter (⌘Enter on macOS) always runs; Esc cancels.
- Each field starts with the value last used for that snippet, else the default. A name used several times is asked for once and fills every use.
- Text in double braces that is not a single name, such as
{{ two words }}or${{ secrets.TOKEN }}, is typed as written. Copy copies the command with its placeholders unfilled.
macOS
- The JOJO logo sits at the right end of the traffic-light row, centered on the buttons.
Jojo 0.2.4 (alpha)
Jojo 0.2.4 is the alpha release.
Downloads
- Windows (x64):
Jojo_0.2.4_x64-setup.exe. The installer is unsigned, so Windows SmartScreen shows "Windows protected your PC" on first run: choose More info ▸ Run anyway. - macOS, Apple Silicon (M1 and later):
Jojo_0.2.4_aarch64.dmg. - macOS, Intel:
Jojo_0.2.4_x64.dmg.
The macOS builds are unsigned (ad-hoc signed). On first launch macOS blocks the app: open System Settings ▸ Privacy & Security and choose Open Anyway, or run xattr -dr com.apple.quarantine /Applications/Jojo.app.
0.2.4 does not change the protocol between the window and the daemon, so installing it over any 0.2.x release keeps running sessions.
Folding locations and projects
- A chevron appears at the left of a location or project row when the pointer is over it; clicking it folds or unfolds the rows beneath. Clicking a location's name also folds it. Alt+click on a project's chevron folds or unfolds every project of that location.
- With a location or project name focused, Left folds and Right unfolds it.
- A folded row shows one small dot per session that is working, needs you, done or in error, in that state's color; a session that needs you keeps pulsing. A folded location also shows its project count.
- Choosing a session from the Needs you queue, the switcher, Jump (Ctrl+Shift+J) or an output search match unfolds its location and project.
- Folded groups are saved in
layout.jsonand stay folded after a restart.
Changes to the sidebar
- Location, project and session rows are indented 14 px further to make room for the fold chevron.
(There is no 0.2.3 release; its tag was superseded by 0.2.4.)
Jojo 0.2.2
Downloads
- Windows (x64):
Jojo_0.2.2_x64-setup.exe. The installer is unsigned, so Windows SmartScreen shows "Windows protected your PC" on first run: choose More info ▸ Run anyway. - macOS, Apple Silicon (M1 and later):
Jojo_0.2.2_aarch64.dmg. - macOS, Intel:
Jojo_0.2.2_x64.dmg.
The macOS builds are unsigned (ad-hoc signed). On first launch macOS blocks the app: open System Settings ▸ Privacy & Security and choose Open Anyway, or run xattr -dr com.apple.quarantine /Applications/Jojo.app.
0.2.2 does not change the protocol between the window and the daemon, so installing it over 0.2.0 or 0.2.1 keeps running sessions.
Snippets
- The snippets library holds commands you use often. The command-prompt icon in the tab row opens it, listing the snippets for the focused terminal grouped by folder, with a search field.
- Clicking a snippet types it into the focused terminal without pressing Enter. Run types it and presses Enter, Copy puts it on the clipboard, and Edit changes or deletes it. In the list, Up and Down move the highlight, Enter inserts and Ctrl+Enter (⌘Enter on macOS) runs.
- A snippet can span several lines; it is typed as one paste, so shells with bracketed paste (PowerShell 7, zsh, bash 5.1 and later) receive the whole block before running anything.
- New snippet creates one, and Save as snippet… in a pane's right-click menu creates one from the selected text.
- Each snippet has a name, a command, an optional folder and a Show for setting: every location and project, only terminals on one location, or only terminals in one project.
- The switcher (Ctrl+Shift+P) lists the focused terminal's snippets.
- Snippets are saved in
snippets.jsonin the app's settings folder (%APPDATA%\Jojoon Windows,~/Library/Application Support/Jojoon macOS). Each computer has its own library.
Dialogs and the tab row
- All dialogs (Settings, search, Snippets, the snippet editor, Add remote location, Add project and confirmations) have a glow in the theme's colors, a faint accent tint at the top, a border in the theme's focus color, larger corners, and a blurred backdrop. Prism's dialog glow and border cycle through the rainbow; Contrast uses a solid yellow outline.
- The search field in the tab row is a magnifier icon button, and Snippets is a command-prompt icon button. Ctrl+Shift+P still opens search.
Jojo 0.2.1
Downloads
- Windows (x64):
Jojo_0.2.1_x64-setup.exe. The installer is unsigned, so Windows SmartScreen shows "Windows protected your PC" on first run: choose More info ▸ Run anyway. - macOS, Apple Silicon (M1 and later):
Jojo_0.2.1_aarch64.dmg. - macOS, Intel:
Jojo_0.2.1_x64.dmg.
The macOS builds are unsigned (ad-hoc signed). On first launch macOS blocks the app: open System Settings ▸ Privacy & Security and choose Open Anyway, or run xattr -dr com.apple.quarantine /Applications/Jojo.app.
0.2.1 does not change the protocol between the window and the daemon, so installing it over 0.2.0 keeps running sessions.
Prism theme
- Prism (Settings ▸ Theme) is Neon Glass with an animated rainbow. Working sessions (their pane border and glow, badge and state word), the focused pane's border and glow, the selected tab and session, the JOJO logo and the background glow cycle through the color wheel every 12 seconds.
- Done, error and needs-you keep their own colors; a pane that needs you still pulses amber.
- The rainbow does not follow the base color, and it stops moving when Windows' Show animations setting (or macOS Reduce motion) is on.
Compact conversation
- Right-click a session's context meter, or its sidebar row, and choose Compact conversation to type
/compactinto that Claude Code session. - It is available on every session running Claude Code, including a terminal where
claudewas started by hand. It is disabled, with the reason shown, while Claude is starting, working or waiting for your answer, where the typed text would interrupt the turn or answer the prompt on screen.
Documentation
- The repository has a README covering installation, use, remote locations, Claude Code hooks, file locations, architecture, building and testing.
- The roadmap lists three new postponed items: a clear error for servers that run each SSH connection in a container (RunCloud's jailed shell), folding locations and projects in the sidebar, and choosing an agent per session.
Jojo 0.2.0
Downloads
- Windows (x64):
Jojo_0.2.0_x64-setup.exe. The installer is unsigned, so Windows SmartScreen shows "Windows protected your PC" on first run: choose More info ▸ Run anyway. - macOS, Apple Silicon (M1 and later):
Jojo_0.2.0_aarch64.dmg. - macOS, Intel:
Jojo_0.2.0_x64.dmg.
The macOS builds are unsigned (ad-hoc signed). On first launch macOS blocks the app: open System Settings ▸ Privacy & Security and choose Open Anyway, or run xattr -dr com.apple.quarantine /Applications/Jojo.app.
Installing over an earlier version replaces the jojod daemon. Running sessions end when the old daemon stops; with Restore sessions on, Claude sessions resume with their names kept.
Agents-first layout
- Each pane glows in its session's state color, and panes that need you pulse.
- A Needs you queue at the top of the sidebar lists the sessions waiting on you from every location, longest wait first. Click a row to jump to its pane.
- Tabs are session cards that show the name, the time in the current state, the state word, and what the session is asking.
- A state strip replaces the status bar, with a search button that opens the switcher.
- A context meter on each session row shows how full Claude's context window is. It turns amber at 70% and red at 85%.
Search
- The switcher (Ctrl+Shift+P) searches the output of every session, including scrollback, and jumps to the matching line.
Themes and appearance
- Four new themes: Graphite, Phosphor, Porcelain and Contrast. Each sets its own glass, corners, border width, glow and shadows, in addition to colors.
- A base color setting recolors any theme while keeping text readable.
- Font dropdowns for the terminal and the interface. Theme default uses each theme's own interface font.
- A JOJO logo at the top of the sidebar.
- Drag the edge between the sidebar and the terminal to resize the sidebar; double-click the edge to reset its width.
Projects, tabs and remote locations
- Drag tabs to reorder them.
- Rename, remove and drag-reorder projects in the sidebar.
- "Machine" is renamed Remote location. Adding one offers the hosts from
~/.ssh/config, and adding a project opens a folder browser on that machine. - Larger location headings with dividers between locations.
Fixes
- Session names are kept after a daemon restart.
exitin a shell closes its pane.- Color replies such as
1;rgb:0808…no longer appear at the prompt after runninggh. - Remote locations work on hosts without
$SHELLset, or that drop exit codes (RunCloud). - An outdated daemon is reported with a message telling you to restart it.