Roer 0.8.4

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 15 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.8.4_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 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.8.4/roer-cli-0.8.4-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.

1. Run Roer_0.8.4_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.8.4_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.8.4-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.8.4.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.8.4.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

• Describe Roer in the README's first paragraph by andrey-sokolov in #68
• Bump source-map-js to 1.2.2 by andrey-sokolov in #69
• Release 0.8.4, the first signed build by andrey-sokolov in #70

Full Changelog: v0.8.3...v0.8.4

Roer 0.8.3

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 15 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.8.3_universal.dmg and drag Roer to Applications.

2. Clear the quarantine flag:

   xattr -dr com.apple.quarantine /Applications/Roer.app

   This build is unsigned. Until notarization is in place, macOS quarantines the app on
   first launch and it is killed instead of opening. The command above is the
   fix; it is not optional.

3. 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 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.8.3/roer-cli-0.8.3-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 downloads are unsigned, so
SmartScreen warns before installing.

1. Run Roer_0.8.3_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.8.3_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.8.3-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.8.3.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.8.3.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

• Show an extension in the README, and list extensions and worktrees by andrey-sokolov in #66
• Focus a session when it opens, and list live Codex conversations once by andrey-sokolov in #67

Full Changelog: v0.8.2...v0.8.3

Roer 0.8.2

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 15 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.8.2_universal.dmg and drag Roer to Applications.

2. Clear the quarantine flag:

   xattr -dr com.apple.quarantine /Applications/Roer.app

   This build is unsigned. Until notarization is in place, macOS quarantines the app on
   first launch and it is killed instead of opening. The command above is the
   fix; it is not optional.

3. 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 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.8.2/roer-cli-0.8.2-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
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 downloads are unsigned, so
SmartScreen warns before installing.

1. Run Roer_0.8.2_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.8.2_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.8.2-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.8.2.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.8.2.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

• Render GitHub's HTML in Markdown, and teach extensions where data comes from by andrey-sokolov in #63
• Open the session in a browser from the title bar by andrey-sokolov in #64
• Release 0.8.2 by andrey-sokolov in #65

Full Changelog: v0.8.1...v0.8.2

Roer 0.8.1

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 15 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.8.1_universal.dmg and drag Roer to Applications.

2. Clear the quarantine flag:

   xattr -dr com.apple.quarantine /Applications/Roer.app

   This build is unsigned. Until notarization is in place, macOS quarantines the app on
   first launch and it is killed instead of opening. The command above is the
   fix; it is not optional.

3. 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 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.8.1/roer-cli-0.8.1-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
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 downloads are unsigned, so
SmartScreen warns before installing.

1. Run Roer_0.8.1_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.8.1_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.8.1-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.8.1.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.8.1.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

• Show what 0.8 brings on the landing page by andrey-sokolov in #58
• Give psmux the terminal's colours instead of letting it ask by andrey-sokolov in #59
• Make a worktree per task, and keep running sessions in the sidebar by andrey-sokolov in #60
• Give Roer a new icon: representin terminal comand by andrey-sokolov in #62
• Release 0.8.1 by andrey-sokolov in #61

Full Changelog: v0.8.0...v0.8.1

Roer 0.8.0

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 15 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.8.0_universal.dmg and drag Roer to Applications.

2. Clear the quarantine flag:

   xattr -dr com.apple.quarantine /Applications/Roer.app

   This build is unsigned. Until notarization is in place, macOS quarantines the app on
   first launch and it is killed instead of opening. The command above is the
   fix; it is not optional.

3. 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 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.8.0/roer-cli-0.8.0-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
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 downloads are unsigned, so
SmartScreen warns before installing.

1. Run Roer_0.8.0_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.8.0_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.8.0-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.8.0.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.8.0.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

• Hand Generative UI clicks to the agent through its hooks by andrey-sokolov in #50
• Offer to bypass the base's rules when merging by andrey-sokolov in #51
• Fix the Windows e2e, and agent status on Windows by andrey-sokolov in #52
• Search a workspace's projects in Go to File, and attach projects from its menu by andrey-sokolov in #53
• Code extensions: tabs an agent writes, with Changes as one by andrey-sokolov in #54
• Step to a commit on a Cmd+Right pressed as the commits arrive by andrey-sokolov in #56
• Release 0.8.0 by andrey-sokolov in #57

Full Changelog: v0.7.5...v0.8.0

Roer 0.7.5

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 15 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.7.5_universal.dmg and drag Roer to Applications.

2. Clear the quarantine flag:

   xattr -dr com.apple.quarantine /Applications/Roer.app

   This build is unsigned. Until notarization is in place, macOS quarantines the app on
   first launch and it is killed instead of opening. The command above is the
   fix; it is not optional.

3. 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 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.7.5/roer-cli-0.7.5-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
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 downloads are unsigned, so
SmartScreen warns before installing.

1. Run Roer_0.7.5_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.7.5_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.7.5-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.7.5.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.7.5.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

• List the most recently opened session first by andrey-sokolov in #49

Full Changelog: v0.7.4...v0.7.5

Roer 0.7.3

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 15 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.7.3_universal.dmg and drag Roer to Applications.

2. Clear the quarantine flag:

   xattr -dr com.apple.quarantine /Applications/Roer.app

   This build is unsigned. Until notarization is in place, macOS quarantines the app on
   first launch and it is killed instead of opening. The command above is the
   fix; it is not optional.

3. 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 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.7.3/roer-cli-0.7.3-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
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 downloads are unsigned, so
SmartScreen warns before installing.

1. Run Roer_0.7.3_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.7.3_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.7.3-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.7.3.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.7.3.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

• Take an agent's redraw for nothing, not for a turn by andrey-sokolov in #45
• Test that an agent out of sight asking for permission needs you by andrey-sokolov in #46

Full Changelog: v0.7.2...v0.7.3

Roer 0.7.0

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 15 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.7.0_universal.dmg and drag Roer to Applications.

2. Clear the quarantine flag:

   xattr -dr com.apple.quarantine /Applications/Roer.app

   This build is unsigned. Until notarization is in place, macOS quarantines the app on
   first launch and it is killed instead of opening. The command above is the
   fix; it is not optional.

3. 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 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.7.0/roer-cli-0.7.0-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
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 downloads are unsigned, so
SmartScreen warns before installing.

1. Run Roer_0.7.0_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.7.0_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.7.0-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.7.0.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.7.0.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

• Start sessions with any agent, and save named agents by andrey-sokolov in #39

Full Changelog: v0.6.0...v0.7.0

Roer 0.6.0

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 15 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.6.0_universal.dmg and drag Roer to Applications.

2. Clear the quarantine flag:

   xattr -dr com.apple.quarantine /Applications/Roer.app

   This build is unsigned. Until notarization is in place, macOS quarantines the app on
   first launch and it is killed instead of opening. The command above is the
   fix; it is not optional.

3. 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 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.6.0/roer-cli-0.6.0-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
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 downloads are unsigned, so
SmartScreen warns before installing.

1. Run Roer_0.6.0_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.6.0_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.6.0-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.6.0.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.6.0.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

• Add roer-ui: Roer's Generative UI in a Claude Code pane by andrey-sokolov in #36

Full Changelog: v0.5.3...v0.6.0

Roer 0.5.3

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 15 or later. The .dmg is a universal build — one download
for Apple silicon and Intel.

Install

1. Open Roer_0.5.3_universal.dmg and drag Roer to Applications.

2. Clear the quarantine flag:

   xattr -dr com.apple.quarantine /Applications/Roer.app

   This build is unsigned. Until notarization is in place, macOS quarantines the app on
   first launch and it is killed instead of opening. The command above is the
   fix; it is not optional.

3. 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 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.5.3/roer-cli-0.5.3-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
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 downloads are unsigned, so
SmartScreen warns before installing.

1. Run Roer_0.5.3_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.5.3_x64_en-US.msi installs the same files but leaves PATH
alone: add <install folder>\roer yourself.
roer-cli-0.5.3-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.

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

---

Full Changelog: v0.5.2...v0.5.3