Roer 0.9.20

Roer is a session host for agent terminals: roer shell starts a terminal you
work in normally, and M-h hands that live session over to the desktop app.

Requires macOS 14 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.9.20_universal.dmg and drag Roer to Applications.
2. Open Roer once. It puts the roer command on your PATH; in a new
   terminal, roer help.

The app carries roer and the tmux it drives, so there is nothing else to
install, Homebrew included. It links roer into ~/.local/bin, where Claude
Code's installer puts claude; if your shell cannot find it there, the app
asks once for your password and links it into /usr/local/bin instead.

If Claude Code is installed, the first launch asks whether to set Roer up in
it: the /roer-handoff skill, so a session in any terminal can hand itself
over, and roer mcp, Roer's MCP server, so an agent in a Roer session can show
a UI in its session's Generative UI panel. Roer › Claude Code Integration…
changes the answer later, including taking either one back.

Linux

The app and the roer command together, with tmux 3.3 or later pulled in
(Ubuntu 24.04, Debian 12, current Fedora):

sudo apt install ./Roer_0.9.20_amd64.deb       # Debian, Ubuntu
sudo dnf install ./Roer-0.9.20-1.x86_64.rpm    # Fedora, RHEL
roer shell

Roer_0.9.20_amd64.AppImage is the same app for any other distribution,
with tmux 3.3 or later installed yourself. Open it once: it links roer into
~/.local/bin.

Or the roer command alone, with tmux 3.3 or later installed yourself:

mkdir -p ~/.roer/bin ~/.local/bin
curl -fsSL https://github.com/JetBrains/roer/releases/download/v0.9.20/roer-cli-0.9.20-linux-x86_64.tar.gz \
  | tar -xzf - -C ~/.roer/bin
ln -sf ~/.roer/bin/roer ~/.local/bin/roer
roer help
roer skills install   # optional: Roer's skills for Claude Code, Codex, Pi and Junie
roer mcp install      # optional: Roer's MCP server for Claude Code

roer looks for roer-tmux.conf and skills/ beside itself, so they cannot
be split up — roer help succeeding is what proves the config was found.

Windows (preview)

Native, in PowerShell: sessions run on psmux,
a tmux reimplementation on ConPTY. The installers, roer-app.exe and
roer.exe are signed by JetBrains.

1. Run Roer_0.9.20_x64-setup.exe. It installs the app and the roer
   command together, and adds the command's folder to your user PATH.
2. In a new terminal, roer help, then roer shell and M-h.

Roer_0.9.20_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.9.20-windows-x64.zip is the command without the app; keep
its files together, since roer.exe finds roer-tmux.conf and psmux.exe
beside itself.

Roer's UI in Claude Code (preview)

roer-ui-claude-plugin-0.9.20.zip is the roer-ui plugin: /roer <what to show> draws Roer's Generative UI in a pane of any Claude Code session, with no
Roer app involved. It is built on Claude Code's early-access function hooks, so
it needs the flag below and may break with a Claude Code update.

mkdir -p ~/.roer && unzip -o roer-ui-claude-plugin-0.9.20.zip -d ~/.roer
CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 claude --plugin-dir ~/.roer/roer-ui

Verify the downloads

shasum -a 256 -c SHA256SUMS.txt

On Windows, compare Get-FileHash <file> with its line in SHA256SUMS.txt.

Try it

roer shell     # a normal terminal
               # press M-h — the terminal lets go and Roer attaches

---

What's Changed

• Open a tab in a browser, share Changes' review, save a tab as HTML, live loadData by andrey-sokolov in #148
• Release 0.9.20 by andrey-sokolov in #149

Full Changelog: v0.9.19...v0.9.20