v0.13.1

Install

The device

Download the desktop app for your OS (below) and open it. It installs the companion service and opens Settings.
Connect the device over USB, and click Install on the Device tab: the app downloads this release's firmware, checks it, and writes it to the device.

Without the desktop app, download firmware.zip below and follow the installation guide.
It includes the matching application, boot files, the default Copilot character, and a checksum-validating Python installer.
Then run npm run setup from a clone of the repository.

The characters.zip asset holds every built-in character pack. Install one from a source checkout with npm run character path/to/openclaw.acpk.

The desktop app

The same character, with the same animation, in a small window on your desktop. It carries the
companion service: when no service runs, it installs it with your agents' hooks, so you need
no clone of the repository and no Node.js. If a service from a clone runs, the app follows that one.

Tip

With GitHub Copilot CLI, one prompt installs it:
copilot -p "Install the latest Agent Companion desktop app for my OS from https://github.com/DanWahlin/agent-buddy/releases"
The app isn't code-signed, so you may still need the step for your OS below.

🍎 macOS (Apple Silicon and Intel)

File	Description
agent-companion-desktop-*-macos-universal.dmg	macOS app

Open the .dmg and drag Agent Companion to Applications. The app isn't code-signed, so macOS
refuses to open it (it may say the app "is damaged"). Clear the download flag once, in Terminal:

sudo xattr -rd com.apple.quarantine "/Applications/Agent Companion.app"

Then open it from Applications. It has no Dock icon: look for it in the menu bar.

🪟 Windows (x64 and Arm64)

File	Description
agent-companion-desktop-*-windows-x64-setup.exe	Windows installer for Intel and AMD PCs
agent-companion-desktop-*-windows-arm64-setup.exe	Windows installer for Arm PCs (Snapdragon)

The app isn't code-signed, so Windows may flag it:

1. If your browser warns about the download, choose Keep.
2. When you see Windows protected your PC, choose More info.
3. Then choose Run anyway.

The app installs the companion service for your Windows account and starts it when you sign in.
Agents that run in WSL 2 can use it too: install their hooks from Settings.

🐧 Linux (x86_64)

File	Description
agent-companion-desktop-*-linux-x86_64.AppImage	Runs on most distributions, including Arch and Omarchy
agent-companion-desktop-*-linux-amd64.deb	Debian and Ubuntu package

AppImage: make it executable, then run it:

chmod +x agent-companion-desktop-*-linux-x86_64.AppImage
./agent-companion-desktop-*-linux-x86_64.AppImage

If it says it needs FUSE, install it (sudo pacman -S --needed fuse2 on Arch and Omarchy,
sudo apt install libfuse2 on Ubuntu), or run it with --appimage-extract-and-run.

Debian or Ubuntu: sudo apt install ./agent-companion-desktop-*-linux-amd64.deb, then run Agent Companion from your apps.

On Hyprland (including Omarchy) the app floats, pins and un-borders its own window, so there is nothing to configure.
On other Wayland desktops it runs through XWayland, so it can see the pointer and remember where you put it.

Changes

[v0.13.1]

Other changes

• Recover the desktop character after a lost WebGL context (#11)

v0.13.0

Install

The device

Download the desktop app for your OS (below) and open it. It installs the companion service and opens Settings.
Connect the device over USB, and click Install on the Device tab: the app downloads this release's firmware, checks it, and writes it to the device.

Without the desktop app, download firmware.zip below and follow the installation guide.
It includes the matching application, boot files, the default Copilot character, and a checksum-validating Python installer.
Then run npm run setup from a clone of the repository.

The characters.zip asset holds every built-in character pack. Install one from a source checkout with npm run character path/to/openclaw.acpk.

The desktop app

The same character, with the same animation, in a small window on your desktop. It carries the
companion service: when no service runs, it installs it with your agents' hooks, so you need
no clone of the repository and no Node.js. If a service from a clone runs, the app follows that one.

Tip

With GitHub Copilot CLI, one prompt installs it:
copilot -p "Install the latest Agent Companion desktop app for my OS from https://github.com/DanWahlin/agent-buddy/releases"
The app isn't code-signed, so you may still need the step for your OS below.

🍎 macOS (Apple Silicon and Intel)

File	Description
agent-companion-desktop-*-macos-universal.dmg	macOS app

Open the .dmg and drag Agent Companion to Applications. The app isn't code-signed, so macOS
refuses to open it (it may say the app "is damaged"). Clear the download flag once, in Terminal:

sudo xattr -rd com.apple.quarantine "/Applications/Agent Companion.app"

Then open it from Applications. It has no Dock icon: look for it in the menu bar.

🪟 Windows (x64 and Arm64)

File	Description
agent-companion-desktop-*-windows-x64-setup.exe	Windows installer for Intel and AMD PCs
agent-companion-desktop-*-windows-arm64-setup.exe	Windows installer for Arm PCs (Snapdragon)

The app isn't code-signed, so Windows may flag it:

1. If your browser warns about the download, choose Keep.
2. When you see Windows protected your PC, choose More info.
3. Then choose Run anyway.

The app installs the companion service for your Windows account and starts it when you sign in.
Agents that run in WSL 2 can use it too: install their hooks from Settings.

🐧 Linux (x86_64)

File	Description
agent-companion-desktop-*-linux-x86_64.AppImage	Runs on most distributions, including Arch and Omarchy
agent-companion-desktop-*-linux-amd64.deb	Debian and Ubuntu package

AppImage: make it executable, then run it:

chmod +x agent-companion-desktop-*-linux-x86_64.AppImage
./agent-companion-desktop-*-linux-x86_64.AppImage

If it says it needs FUSE, install it (sudo pacman -S --needed fuse2 on Arch and Omarchy,
sudo apt install libfuse2 on Ubuntu), or run it with --appimage-extract-and-run.

Debian or Ubuntu: sudo apt install ./agent-companion-desktop-*-linux-amd64.deb, then run Agent Companion from your apps.

On Hyprland (including Omarchy) the app floats, pins and un-borders its own window, so there is nothing to configure.
On other Wayland desktops it runs through XWayland, so it can see the pointer and remember where you put it.

Changes

[v0.13.0]

Features and improvements

• Add the Agent Buddy website with a live firmware-engine demo and a GitHub Pages deploy

• Add the MIT License and a trademark policy for the Agent Buddy name and logo

• Add a Sleeping state to the live demo

Fixes

• Fix clipped descenders in headings and make the website fit phones in portrait and landscape

• Review the website code: remove dead code, share repeated logic, and fix accessibility details

Other changes

• Tighten the website layout, split the states into rows, and move the live demo up

• Keep the website preview server running when browsers cancel requests

• Serve the website preview on port 4790 and report a busy port

• Host the overview video on the website in place of a YouTube embed

• Set the license copyright holder to Dan Wahlin

• Use plain words in the live demo text

• Cut the website's idle CPU use and rename the states headline

• Remove the Local. Private. Yours. section from the website

• Keep only the license and trademark line in the website footer

• Make the tray icon transparent and keep Settings character cards from cutting off text

• Keep Needs attention while other tools in a Copilot question's batch finish

• Center the hero device between the buttons and the next section

• Fill the window with the hero and center the device in the space under the buttons

• Loop the Working track in base-patch character packs

• Load character packs when the server compresses them

• Keep character packs installed from a path

• Resume the agent's state after a tap or click

• Point the website at getagentbuddy.com

v0.12.0

Install

The device

Download the desktop app for your OS (below) and open it. It installs the companion service and opens Settings.
Connect the device over USB, and click Install on the Device tab: the app downloads this release's firmware, checks it, and writes it to the device.

Without the desktop app, download firmware.zip below and follow the installation guide.
It includes the matching application, boot files, the default Copilot character, and a checksum-validating Python installer.
Then run npm run setup from a clone of the repository.

The characters.zip asset holds every built-in character pack. Install one from a source checkout with npm run character path/to/openclaw.acpk.

The desktop app

The same character, with the same animation, in a small window on your desktop. It carries the
companion service: when no service runs, it installs it with your agents' hooks, so you need
no clone of the repository and no Node.js. If a service from a clone runs, the app follows that one.

Tip

With GitHub Copilot CLI, one prompt installs it:
copilot -p "Install the latest Agent Companion desktop app for my OS from https://github.com/DanWahlin/esp32-agent-companion/releases"
The app isn't code-signed, so you may still need the step for your OS below.

🍎 macOS (Apple Silicon and Intel)

File	Description
agent-companion-desktop-*-macos-universal.dmg	macOS app

Open the .dmg and drag Agent Companion to Applications. The app isn't code-signed, so macOS
refuses to open it (it may say the app "is damaged"). Clear the download flag once, in Terminal:

sudo xattr -rd com.apple.quarantine "/Applications/Agent Companion.app"

Then open it from Applications. It has no Dock icon: look for it in the menu bar.

🪟 Windows (x64 and Arm64)

File	Description
agent-companion-desktop-*-windows-x64-setup.exe	Windows installer for Intel and AMD PCs
agent-companion-desktop-*-windows-arm64-setup.exe	Windows installer for Arm PCs (Snapdragon)

The app isn't code-signed, so Windows may flag it:

1. If your browser warns about the download, choose Keep.
2. When you see Windows protected your PC, choose More info.
3. Then choose Run anyway.

The app installs the companion service for your Windows account and starts it when you sign in.
Agents that run in WSL 2 can use it too: install their hooks from Settings.

🐧 Linux (x86_64)

File	Description
agent-companion-desktop-*-linux-x86_64.AppImage	Runs on most distributions, including Arch and Omarchy
agent-companion-desktop-*-linux-amd64.deb	Debian and Ubuntu package

AppImage: make it executable, then run it:

chmod +x agent-companion-desktop-*-linux-x86_64.AppImage
./agent-companion-desktop-*-linux-x86_64.AppImage

If it says it needs FUSE, install it (sudo pacman -S --needed fuse2 on Arch and Omarchy,
sudo apt install libfuse2 on Ubuntu), or run it with --appimage-extract-and-run.

Debian or Ubuntu: sudo apt install ./agent-companion-desktop-*-linux-amd64.deb, then run Agent Companion from your apps.

On Hyprland (including Omarchy) the app floats, pins and un-borders its own window, so there is nothing to configure.
On other Wayland desktops it runs through XWayland, so it can see the pointer and remember where you put it.

Changes

[v0.12.0]

Features and improvements

• Add companion service Stop and Restart, and stop the service with the app when no device was used

v0.11.0

Install

The device

Download the desktop app for your OS (below) and open it. It installs the companion service and opens Settings.
Connect the device over USB, and click Install on the Device tab: the app downloads this release's firmware, checks it, and writes it to the device.

Without the desktop app, download firmware.zip below and follow the installation guide.
It includes the matching application, boot files, the default Copilot character, and a checksum-validating Python installer.
Then run npm run setup from a clone of the repository.

The characters.zip asset holds every built-in character pack. Install one from a source checkout with npm run character path/to/openclaw.acpk.

The desktop app

The same character, with the same animation, in a small window on your desktop. It carries the
companion service: when no service runs, it installs it with your agents' hooks, so you need
no clone of the repository and no Node.js. If a service from a clone runs, the app follows that one.

Tip

With GitHub Copilot CLI, one prompt installs it:
copilot -p "Install the latest Agent Companion desktop app for my OS from https://github.com/DanWahlin/esp32-agent-companion/releases"
The app isn't code-signed, so you may still need the step for your OS below.

🍎 macOS (Apple Silicon and Intel)

File	Description
agent-companion-desktop-*-macos-universal.dmg	macOS app

Open the .dmg and drag Agent Companion to Applications. The app isn't code-signed, so macOS
refuses to open it (it may say the app "is damaged"). Clear the download flag once, in Terminal:

sudo xattr -rd com.apple.quarantine "/Applications/Agent Companion.app"

Then open it from Applications. It has no Dock icon: look for it in the menu bar.

🪟 Windows (x64 and Arm64)

File	Description
agent-companion-desktop-*-windows-x64-setup.exe	Windows installer for Intel and AMD PCs
agent-companion-desktop-*-windows-arm64-setup.exe	Windows installer for Arm PCs (Snapdragon)

The app isn't code-signed, so Windows may flag it:

1. If your browser warns about the download, choose Keep.
2. When you see Windows protected your PC, choose More info.
3. Then choose Run anyway.

The app installs the companion service for your Windows account and starts it when you sign in.
Agents that run in WSL 2 can use it too: install their hooks from Settings.

🐧 Linux (x86_64)

File	Description
agent-companion-desktop-*-linux-x86_64.AppImage	Runs on most distributions, including Arch and Omarchy
agent-companion-desktop-*-linux-amd64.deb	Debian and Ubuntu package

AppImage: make it executable, then run it:

chmod +x agent-companion-desktop-*-linux-x86_64.AppImage
./agent-companion-desktop-*-linux-x86_64.AppImage

If it says it needs FUSE, install it (sudo pacman -S --needed fuse2 on Arch and Omarchy,
sudo apt install libfuse2 on Ubuntu), or run it with --appimage-extract-and-run.

Debian or Ubuntu: sudo apt install ./agent-companion-desktop-*-linux-amd64.deb, then run Agent Companion from your apps.

On Hyprland (including Omarchy) the app floats, pins and un-borders its own window, so there is nothing to configure.
On other Wayland desktops it runs through XWayland, so it can see the pointer and remember where you put it.

Changes

[v0.11.0]

Features and improvements

• Add service and desktop app versions to the Settings status card

• Improve Status card text with normal size and weight

Fixes

• Fix Needs attention for Copilot questions and plan approvals

v0.10.0

Install

The device

Download the desktop app for your OS (below) and open it. It installs the companion service and opens Settings.
Connect the device over USB, and click Install on the Device tab: the app downloads this release's firmware, checks it, and writes it to the device.

Without the desktop app, download firmware.zip below and follow the installation guide.
It includes the matching application, boot files, the default Copilot character, and a checksum-validating Python installer.
Then run npm run setup from a clone of the repository.

The characters.zip asset holds every built-in character pack. Install one from a source checkout with npm run character path/to/openclaw.acpk.

The desktop app

The same character, with the same animation, in a small window on your desktop. It carries the
companion service: when no service runs, it installs it with your agents' hooks, so you need
no clone of the repository and no Node.js. If a service from a clone runs, the app follows that one.

Tip

With GitHub Copilot CLI, one prompt installs it:
copilot -p "Install the latest Agent Companion desktop app for my OS from https://github.com/DanWahlin/esp32-agent-companion/releases"
The app isn't code-signed, so you may still need the step for your OS below.

🍎 macOS (Apple Silicon and Intel)

File	Description
agent-companion-desktop-*-macos-universal.dmg	macOS app

Open the .dmg and drag Agent Companion to Applications. The app isn't code-signed, so macOS
refuses to open it (it may say the app "is damaged"). Clear the download flag once, in Terminal:

sudo xattr -rd com.apple.quarantine "/Applications/Agent Companion.app"

Then open it from Applications. It has no Dock icon: look for it in the menu bar.

🪟 Windows (x64 and Arm64)

File	Description
agent-companion-desktop-*-windows-x64-setup.exe	Windows installer for Intel and AMD PCs
agent-companion-desktop-*-windows-arm64-setup.exe	Windows installer for Arm PCs (Snapdragon)

The app isn't code-signed, so Windows may flag it:

1. If your browser warns about the download, choose Keep.
2. When you see Windows protected your PC, choose More info.
3. Then choose Run anyway.

The app installs the companion service for your Windows account and starts it when you sign in.
Agents that run in WSL 2 can use it too: install their hooks from Settings.

🐧 Linux (x86_64)

File	Description
agent-companion-desktop-*-linux-x86_64.AppImage	Runs on most distributions, including Arch and Omarchy
agent-companion-desktop-*-linux-amd64.deb	Debian and Ubuntu package

AppImage: make it executable, then run it:

chmod +x agent-companion-desktop-*-linux-x86_64.AppImage
./agent-companion-desktop-*-linux-x86_64.AppImage

If it says it needs FUSE, install it (sudo pacman -S --needed fuse2 on Arch and Omarchy,
sudo apt install libfuse2 on Ubuntu), or run it with --appimage-extract-and-run.

Debian or Ubuntu: sudo apt install ./agent-companion-desktop-*-linux-amd64.deb, then run Agent Companion from your apps.

On Hyprland (including Omarchy) the app floats, pins and un-borders its own window, so there is nothing to configure.
On other Wayland desktops it runs through XWayland, so it can see the pointer and remember where you put it.

Changes

[v0.10.0]

Build and maintenance

• Rebuild desktop engine for orientation firmware sources

• Preserve networking RAM and update protocol-limit tests

Features and improvements

• Add accelerometer-based display orientation

• Add saved web alignment trim and pipelined display DMA

Other changes

• Start Wi-Fi before renderer allocations

v0.9.0

Install

The device

Download the desktop app for your OS (below) and open it. It installs the companion service and opens Settings.
Connect the device over USB, and click Install on the Device tab: the app downloads this release's firmware, checks it, and writes it to the device.

Without the desktop app, download firmware.zip below and follow the installation guide.
It includes the matching application, boot files, the default Copilot character, and a checksum-validating Python installer.
Then run npm run setup from a clone of the repository.

The characters.zip asset holds every built-in character pack. Install one from a source checkout with npm run character path/to/openclaw.acpk.

The desktop app

The same character, with the same animation, in a small window on your desktop. It carries the
companion service: when no service runs, it installs it with your agents' hooks, so you need
no clone of the repository and no Node.js. If a service from a clone runs, the app follows that one.

Tip

With GitHub Copilot CLI, one prompt installs it:
copilot -p "Install the latest Agent Companion desktop app for my OS from https://github.com/DanWahlin/esp32-agent-companion/releases"
The app isn't code-signed, so you may still need the step for your OS below.

🍎 macOS (Apple Silicon and Intel)

File	Description
agent-companion-desktop-*-macos-universal.dmg	macOS app

Open the .dmg and drag Agent Companion to Applications. The app isn't code-signed, so macOS
refuses to open it (it may say the app "is damaged"). Clear the download flag once, in Terminal:

sudo xattr -rd com.apple.quarantine "/Applications/Agent Companion.app"

Then open it from Applications. It has no Dock icon: look for it in the menu bar.

🪟 Windows (x64 and Arm64)

File	Description
agent-companion-desktop-*-windows-x64-setup.exe	Windows installer for Intel and AMD PCs
agent-companion-desktop-*-windows-arm64-setup.exe	Windows installer for Arm PCs (Snapdragon)

The app isn't code-signed, so Windows may flag it:

1. If your browser warns about the download, choose Keep.
2. When you see Windows protected your PC, choose More info.
3. Then choose Run anyway.

The app installs the companion service for your Windows account and starts it when you sign in.
Agents that run in WSL 2 can use it too: install their hooks from Settings.

🐧 Linux (x86_64)

File	Description
agent-companion-desktop-*-linux-x86_64.AppImage	Runs on most distributions, including Arch and Omarchy
agent-companion-desktop-*-linux-amd64.deb	Debian and Ubuntu package

AppImage: make it executable, then run it:

chmod +x agent-companion-desktop-*-linux-x86_64.AppImage
./agent-companion-desktop-*-linux-x86_64.AppImage

If it says it needs FUSE, install it (sudo pacman -S --needed fuse2 on Arch and Omarchy,
sudo apt install libfuse2 on Ubuntu), or run it with --appimage-extract-and-run.

Debian or Ubuntu: sudo apt install ./agent-companion-desktop-*-linux-amd64.deb, then run Agent Companion from your apps.

On Hyprland (including Omarchy) the app floats, pins and un-borders its own window, so there is nothing to configure.
On other Wayland desktops it runs through XWayland, so it can see the pointer and remember where you put it.

Changes

[v0.9.0]

Features and improvements

• Add desktop sounds with a volume slider, uninstall from Settings, and a simpler tray menu

• Add native Windows support: bundled service, WSL hooks, and Windows Arm64 installer

v0.8.1

Install

The device

On macOS and Linux, download the desktop app (below) and open it. It installs the companion service and opens Settings.
Connect the device over USB, and click Install on the Device tab: the app downloads this release's firmware, checks it, and writes it to the device.

Without the desktop app, download firmware.zip below and follow the installation guide.
It includes the matching application, boot files, the default Copilot character, and a checksum-validating Python installer.
Then run npm run setup from a clone of the repository.

The characters.zip asset holds every built-in character pack. Install one from a source checkout with npm run character path/to/openclaw.acpk.

The desktop app

The same character, with the same animation, in a small window on your desktop. On macOS and Linux it
carries the companion service: when no service runs, it installs it with your agents' hooks, so you need
no clone of the repository and no Node.js. If a service from a clone runs, the app follows that one.

Tip

With GitHub Copilot CLI, one prompt installs it:
copilot -p "Install the latest Agent Companion desktop app for my OS from https://github.com/DanWahlin/esp32-agent-companion/releases"
The app isn't code-signed, so you may still need the step for your OS below.

🍎 macOS (Apple Silicon and Intel)

File	Description
agent-companion-desktop-*-macos-universal.dmg	macOS app

Open the .dmg and drag Agent Companion to Applications. The app isn't code-signed, so macOS
refuses to open it (it may say the app "is damaged"). Clear the download flag once, in Terminal:

sudo xattr -rd com.apple.quarantine "/Applications/Agent Companion.app"

Then open it from Applications. It has no Dock icon: look for it in the menu bar.

🪟 Windows (x64)

File	Description
agent-companion-desktop-*-windows-x64-setup.exe	Windows installer

The app isn't code-signed, so Windows may flag it:

1. If your browser warns about the download, choose Keep.
2. When you see Windows protected your PC, choose More info.
3. Then choose Run anyway.

The companion service doesn't run on Windows itself (use WSL 2),
so on Windows the desktop app shows the character but can't follow your agents yet.

🐧 Linux (x86_64)

File	Description
agent-companion-desktop-*-linux-x86_64.AppImage	Runs on most distributions, including Arch and Omarchy
agent-companion-desktop-*-linux-amd64.deb	Debian and Ubuntu package

AppImage: make it executable, then run it:

chmod +x agent-companion-desktop-*-linux-x86_64.AppImage
./agent-companion-desktop-*-linux-x86_64.AppImage

If it says it needs FUSE, install it (sudo pacman -S --needed fuse2 on Arch and Omarchy,
sudo apt install libfuse2 on Ubuntu), or run it with --appimage-extract-and-run.

Debian or Ubuntu: sudo apt install ./agent-companion-desktop-*-linux-amd64.deb, then run Agent Companion from your apps.

On Hyprland (including Omarchy) the app floats, pins and un-borders its own window, so there is nothing to configure.
On other Wayland desktops it runs through XWayland, so it can see the pointer and remember where you put it.

Changes

[v0.8.1]

Fixes

• Fix the Linux AppImage build: remove the musl serialport binding from the bundle

v0.7.0

Install

The device

Download firmware.zip below and follow the installation guide.
It includes the matching application, boot files, the default Copilot character, and a checksum-validating Python installer.
Then run npm run setup from a clone of the repository to start the companion service and open the Settings page.

The characters.zip asset holds every built-in character pack. Install one from a source checkout with npm run character path/to/openclaw.acpk.

The desktop app (optional)

The same character, with the same animation, in a small window on your desktop. It needs the companion
service (npm run setup, above) running, and Settings > Desktop companion turns it on or off.

Tip

With GitHub Copilot CLI, one prompt installs it:
copilot -p "Install the latest Agent Companion desktop app for my OS from https://github.com/DanWahlin/esp32-agent-companion/releases"
The app isn't code-signed, so you may still need the step for your OS below.

🍎 macOS (Apple Silicon and Intel)

File	Description
agent-companion-desktop-*-macos-universal.dmg	macOS app

Open the .dmg and drag Agent Companion to Applications. The app isn't code-signed, so macOS
refuses to open it (it may say the app "is damaged"). Clear the download flag once, in Terminal:

sudo xattr -rd com.apple.quarantine "/Applications/Agent Companion.app"

Then open it from Applications. It has no Dock icon: look for it in the menu bar.

🪟 Windows (x64)

File	Description
agent-companion-desktop-*-windows-x64-setup.exe	Windows installer

The app isn't code-signed, so Windows may flag it:

1. If your browser warns about the download, choose Keep.
2. When you see Windows protected your PC, choose More info.
3. Then choose Run anyway.

The companion service doesn't run on Windows itself (use WSL 2),
so on Windows the desktop app shows the character but can't follow your agents yet.

🐧 Linux (x86_64)

File	Description
agent-companion-desktop-*-linux-x86_64.AppImage	Runs on most distributions, including Arch and Omarchy
agent-companion-desktop-*-linux-amd64.deb	Debian and Ubuntu package

AppImage: make it executable, then run it:

chmod +x agent-companion-desktop-*-linux-x86_64.AppImage
./agent-companion-desktop-*-linux-x86_64.AppImage

If it says it needs FUSE, install it (sudo pacman -S --needed fuse2 on Arch and Omarchy,
sudo apt install libfuse2 on Ubuntu), or run it with --appimage-extract-and-run.

Debian or Ubuntu: sudo apt install ./agent-companion-desktop-*-linux-amd64.deb, then run Agent Companion from your apps.

On Hyprland (including Omarchy) the app floats, pins and un-borders its own window, so there is nothing to configure.
On other Wayland desktops it runs through XWayland, so it can see the pointer and remember where you put it.

What's new

Desktop Agent Companion

Thanks to @darrenjrobinson for the original work, with @DanWahlin.

• The device's character can now also show on your desktop. It uses the firmware's own animation engine (compiled to WebAssembly), so it moves the same as the device.
• The app follows your agents through the companion service, as the device does. It shows device installs and the agent badge.
• Use Settings > Desktop companion to turn it on or off, and to show or hide the device rim.
• Right-click the character to hide it, open Settings or close it. It also has a menu bar (tray) item.
• It does not take keyboard focus, and it uses little CPU and memory, so you can leave it running.
• Downloads for macOS (universal .dmg), Windows (setup.exe) and Linux (.AppImage and .deb, Omarchy and Hyprland included).

Other changes

• Fix: an agent event now ends a manual state override, so the device no longer stays on the wrong state.
• The README has a three-part quick start (device, Settings, desktop), and a path for people who use only the desktop app.
• The Copilot, OpenClaw and Claude characters ship as built-in packs.
• CI runs the desktop tests on macOS, Windows and Linux.

The device firmware has no behavior change in this release. You do not have to flash the device again.

Full changelog: v0.6.0...v0.7.0

v0.6.0

Install

Download the firmware.zip asset and follow the installation guide.
It includes the matching application, boot files, the default Copilot character, and a checksum-validating Python installer.

The characters.zip asset holds every built-in character pack. Install one from a source checkout with npm run character path/to/openclaw.acpk.

Changes

[v0.6.0]

Features and improvements

• Add Wi-Fi network scan and live join status

v0.5.1

Install

Download the firmware.zip asset and follow the installation guide.
It includes the matching application, boot files, the default Copilot character, and a checksum-validating Python installer.

The characters.zip asset holds every built-in character pack. Install one from a source checkout with npm run character path/to/openclaw.acpk.

Changes

[v0.5.1]

Other changes

• Ignore permission prompts from one-shot agent runs

• Recognize one-shot Grok and Hermes runs

• Recognize Hermes one-shot runs through its python relaunch

• Show the device's Wi-Fi network on the settings page