Skip to content

A desktop coding agent with free access to frontier models.

TypeScript

Linux arm64 builds and Arch Linux packages (#16)

Ramshourieshc71a0710f150
diff --git a/.github/workflows/linux-packages.yml b/.github/workflows/linux-packages.yml
new file mode 100644
index 00000000..2fbfadab
--- /dev/null
+++ b/.github/workflows/linux-packages.yml
@@ -0,0 +1,253 @@
+name: Linux Packages
+
+# Builds the Linux installers the release publishes (x64 and arm64: .deb,
+# .AppImage, .tar.gz, .pacman) with the release's steps, without publishing,
+# then installs and launches them: each .deb on Ubuntu, each .pacman and the
+# AUR PKGBUILD (built from this run's tarball) on Arch Linux of the same CPU.
+
+on:
+ workflow_dispatch:
+ pull_request:
+ paths:
+ - apps/desktop/electron-builder*.yml
+ - apps/desktop/scripts/prepare-sidecar.mjs
+ - packaging/aur/**
+ - scripts/aur/**
+ - .github/workflows/release-desktop.yml
+ - .github/workflows/linux-packages.yml
+
+permissions:
+ contents: read
+
+concurrency:
+ group: linux-packages-${{ github.ref }}
+ cancel-in-progress: true
+
+jobs:
+ build:
+ name: Build and launch (${{ matrix.name }})
+ timeout-minutes: 90
+ strategy:
+ fail-fast: false
+ matrix:
+ include:
+ - name: x64
+ runner: ubuntu-22.04
+ target: x86_64-unknown-linux-gnu
+ builder_args: --linux --x64
+ update_manifest: latest-linux.yml
+ deb_arch: amd64
+ file_arch: x86-64
+ - name: arm64
+ runner: ubuntu-22.04-arm
+ target: aarch64-unknown-linux-gnu
+ builder_args: --linux --arm64
+ update_manifest: latest-linux-arm64.yml
+ deb_arch: arm64
+ file_arch: aarch64
+ runs-on: ${{ matrix.runner }}
+ env:
+ # A plain X.Y.Z: pacman versions cannot contain "-".
+ PACKAGE_VERSION: 0.0.${{ github.run_number }}
+ PNPM_CONFIG_VERIFY_DEPS_BEFORE_RUN: "false"
+ CSC_IDENTITY_AUTO_DISCOVERY: "false"
+ steps:
+ - uses: actions/checkout@v4
+
+ - uses: pnpm/action-setup@v4
+ with:
+ version: 11.4.0
+
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 24
+ cache: pnpm
+
+ - uses: oven-sh/setup-bun@v2
+ with:
+ bun-version: 1.3.10
+
+ - name: Install Linux packaging tools
+ run: |
+ sudo apt-get update
+ sudo apt-get install --yes libarchive-tools rpm xvfb file
+
+ - name: Install dependencies
+ run: pnpm --filter @omnirush/desktop... --filter @omnirush/app... --filter omnirush-server... --filter omnirush-ui-mcp... install --frozen-lockfile --prefer-offline
+
+ - name: Stamp version
+ run: node scripts/release/stamp-version.mjs --version "$PACKAGE_VERSION"
+
+ - name: Build desktop application
+ env:
+ TARGET: ${{ matrix.target }}
+ run: pnpm --filter @omnirush/desktop build:electron
+
+ - name: Package installers
+ run: |
+ pnpm --dir apps/desktop exec electron-builder \
+ --config electron-builder.yml \
+ ${{ matrix.builder_args }} \
+ --publish never
+ ls -la apps/desktop/dist-electron
+
+ - name: Verify packaged server imports
+ run: node apps/desktop/scripts/verify-packaged-imports.mjs
+
+ - name: Verify update manifest
+ run: |
+ node apps/desktop/scripts/verify-update-manifest.mjs \
+ --manifest "apps/desktop/dist-electron/${{ matrix.update_manifest }}" \
+ --version "$PACKAGE_VERSION"
+
+ - name: Check every installer was produced
+ working-directory: apps/desktop/dist-electron
+ run: |
+ set -euo pipefail
+ for f in omnirush-linux-*-"$PACKAGE_VERSION".{deb,AppImage,tar.gz,pacman}; do
+ [ -f "$f" ] || { echo "missing $f" >&2; exit 1; }
+ echo "$f $(du -h "$f" | cut -f1)"
+ done
+ [ -f "omnirush-linux-${{ matrix.deb_arch }}-$PACKAGE_VERSION.deb" ]
+
+ - name: Install the .deb and launch it
+ run: |
+ set -euo pipefail
+ sudo apt-get install --yes "./apps/desktop/dist-electron/omnirush-linux-${{ matrix.deb_arch }}-$PACKAGE_VERSION.deb"
+ echo "launcher -> $(readlink -f /usr/bin/omnirush)"
+ file -L /usr/bin/omnirush | tee /dev/stderr | grep -q "${{ matrix.file_arch }}"
+ file -L /opt/OmniRush.ai/resources/sidecars/opencode | tee /dev/stderr | grep -q "${{ matrix.file_arch }}"
+ # Still running when the timer fires (exit 124) = it started.
+ set +e
+ xvfb-run -a timeout 25 omnirush --no-sandbox > launch.log 2>&1
+ rc=$?
+ set -e
+ tail -20 launch.log
+ [ "$rc" -eq 124 ] || { echo "omnirush exited with $rc before the timeout" >&2; exit 1; }
+
+ - uses: actions/upload-artifact@v4
+ with:
+ name: omnirush-linux-${{ matrix.name }}
+ path: |
+ apps/desktop/dist-electron/omnirush-linux-*.tar.gz
+ apps/desktop/dist-electron/omnirush-linux-*.pacman
+ apps/desktop/dist-electron/omnirush-linux-*.deb
+ apps/desktop/dist-electron/omnirush-linux-*.AppImage
+ apps/desktop/dist-electron/latest-linux*.yml
+ retention-days: 7
+
+ arch:
+ name: Arch Linux (${{ matrix.carch }})
+ needs: build
+ timeout-minutes: 45
+ strategy:
+ fail-fast: false
+ matrix:
+ include:
+ - carch: x86_64
+ artifact: omnirush-linux-x64
+ tar_arch: x64
+ runner: ubuntu-22.04
+ image: docker.io/library/archlinux:base-devel
+ # The official image is x86_64 only; Arch Linux ARM, rebuilt daily.
+ - carch: aarch64
+ artifact: omnirush-linux-arm64
+ tar_arch: arm64
+ runner: ubuntu-22.04-arm
+ image: docker.io/menci/archlinuxarm:base-devel
+ runs-on: ${{ matrix.runner }}
+ container:
+ image: ${{ matrix.image }}
+ env:
+ PACKAGE_VERSION: 0.0.${{ github.run_number }}
+ steps:
+ - name: Install test tools
+ run: |
+ # pacman 7 confines its downloads with Landlock, which the runner's
+ # container runtime does not permit ("restricting filesystem access
+ # failed"). The official archlinux image already sets
+ # DisableSandboxFilesystem; do the same on Arch Linux ARM.
+ sed -i 's/^#[[:space:]]*DisableSandboxFilesystem/DisableSandboxFilesystem/' /etc/pacman.conf
+ grep -q '^DisableSandboxFilesystem' /etc/pacman.conf \
+ || sed -i '0,/^\[options\]/s//[options]\nDisableSandboxFilesystem/' /etc/pacman.conf
+ # Arch Linux ARM mirrors stall now and then; wait instead of
+ # aborting after 10 s under 1 B/s, and retry the whole install.
+ grep -q '^DisableDownloadTimeout' /etc/pacman.conf \
+ || sed -i '0,/^\[options\]/s//[options]\nDisableDownloadTimeout/' /etc/pacman.conf
+ grep -nE '^(DownloadUser|DisableSandbox|DisableDownloadTimeout)' /etc/pacman.conf
+ for attempt in 1 2 3; do
+ pacman -Syu --noconfirm --needed git xorg-server-xvfb file desktop-file-utils namcap && break
+ [ "$attempt" -lt 3 ] || exit 1
+ echo "pacman failed (attempt $attempt); retrying" >&2
+ sleep 10
+ done
+
+ - uses: actions/checkout@v4
+
+ - uses: actions/download-artifact@v4
+ with:
+ name: ${{ matrix.artifact }}
+ path: dist
+
+ - name: Install the .pacman and launch it
+ run: |
+ set -euo pipefail
+ pkg=$(ls dist/omnirush-linux-*-"$PACKAGE_VERSION".pacman)
+ bsdtar -xOf "$pkg" .PKGINFO | grep -E "^(pkgname|pkgver|arch|depend) "
+ bsdtar -xOf "$pkg" .PKGINFO | grep -q "^arch = ${{ matrix.carch }}$"
+ for attempt in 1 2 3; do
+ pacman -U --noconfirm "$pkg" && break
+ [ "$attempt" -lt 3 ] || exit 1
+ sleep 10
+ done
+ echo "launcher -> $(readlink -f /usr/bin/omnirush)"
+ file -L /usr/bin/omnirush
+ set +e
+ xvfb-run -a timeout 25 omnirush --no-sandbox > launch.log 2>&1
+ rc=$?
+ set -e
+ tail -20 launch.log
+ [ "$rc" -eq 124 ] || { echo "omnirush exited with $rc before the timeout" >&2; exit 1; }
+ pacman -Rns --noconfirm omnirush
+
+ - name: Build the AUR PKGBUILD from this run's tarball, install and launch it
+ run: |
+ set -euo pipefail
+ useradd -m builder
+ mkdir /build
+ cp packaging/aur/PKGBUILD /build/
+ # makepkg uses a source already in the build directory under its
+ # name instead of downloading it.
+ cp "dist/omnirush-linux-${{ matrix.tar_arch }}-$PACKAGE_VERSION.tar.gz" \
+ "/build/omnirush-$PACKAGE_VERSION-${{ matrix.tar_arch }}.tar.gz"
+ cp LICENSE "/build/omnirush-$PACKAGE_VERSION-LICENSE"
+ chown -R builder /build
+ cd /build
+ sha=$(sha256sum "omnirush-$PACKAGE_VERSION-${{ matrix.tar_arch }}.tar.gz" | cut -d' ' -f1)
+ sed -i -e "s/^pkgver=.*/pkgver=$PACKAGE_VERSION/" \
+ -e "s/^sha256sums_${{ matrix.carch }}=.*/sha256sums_${{ matrix.carch }}=('$sha')/" PKGBUILD
+ # Binary repack: the runtime depends are installed by pacman -U.
+ sudo -u builder makepkg -f -d --noconfirm
+ # .zst on Arch, .xz on Arch Linux ARM (makepkg.conf PKGEXT).
+ pkg=
+ for f in omnirush-"$PACKAGE_VERSION"-1-${{ matrix.carch }}.pkg.tar.*; do
+ case "$f" in *.sig) ;; *) pkg=$f ;; esac
+ done
+ [ -f "$pkg" ]
+ namcap "$pkg" || true
+ for attempt in 1 2 3; do
+ pacman -U --noconfirm "$pkg" && break
+ [ "$attempt" -lt 3 ] || exit 1
+ sleep 10
+ done
+ echo "launcher -> $(readlink -f /usr/bin/omnirush)"
+ file -L /usr/bin/omnirush | grep -q "$( [ "${{ matrix.carch }}" = x86_64 ] && echo x86-64 || echo aarch64 )"
+ ls /usr/share/icons/hicolor/*/apps/omnirush.*
+ desktop-file-validate /usr/share/applications/omnirush.desktop
+ test -s /usr/share/licenses/omnirush/LICENSE
+ set +e
+ xvfb-run -a timeout 25 omnirush --no-sandbox > launch.log 2>&1
+ rc=$?
+ set -e
+ tail -20 launch.log
+ [ "$rc" -eq 124 ] || { echo "omnirush exited with $rc before the timeout" >&2; exit 1; }
diff --git a/.github/workflows/release-desktop.yml b/.github/workflows/release-desktop.yml
index e5b2060d..7b146103 100644
--- a/.github/workflows/release-desktop.yml
+++ b/.github/workflows/release-desktop.yml
@@ -88,6 +88,16 @@ jobs:
target: x86_64-unknown-linux-gnu
builder_args: --linux --x64
update_manifest: latest-linux.yml
+ # Built natively on an arm64 runner, so electron-builder installs
+ # and rebuilds the native modules (better-sqlite3, node-pty) for the
+ # host CPU and prepare-sidecar fetches the arm64 opencode. Same
+ # Ubuntu release as x64, so both need the same glibc.
+ - name: Linux arm64
+ runner: ubuntu-22.04-arm
+ platform: linux
+ target: aarch64-unknown-linux-gnu
+ builder_args: --linux --arm64
+ update_manifest: latest-linux-arm64.yml
runs-on: ${{ matrix.runner }}
env:
RELEASE_TAG: ${{ needs.prepare.outputs.tag }}
diff --git a/apps/desktop/electron-builder.base.yml b/apps/desktop/electron-builder.base.yml
index 16d7afbe..82beff6e 100644
--- a/apps/desktop/electron-builder.base.yml
+++ b/apps/desktop/electron-builder.base.yml
@@ -91,6 +91,25 @@ linux:
- AppImage
- deb
- tar.gz
+ - pacman
+# Arch Linux package (`sudo pacman -U omnirush-linux-<arch>-<version>.pacman`).
+# electron-builder's default pacman dependencies name packages Arch no longer
+# ships (http-parser) or moved to the AUR (libappindicator-gtk3), which makes
+# `pacman -U` fail; these are the ones in packaging/aur/PKGBUILD.
+pacman:
+ depends:
+ - gtk3
+ - nss
+ - alsa-lib
+ - libxss
+ - libxtst
+ - xdg-utils
+ - at-spi2-core
+ - libdrm
+ - libxkbcommon
+ - mesa
+ - dbus
+ - hicolor-icon-theme
win:
icon: resources/icons/icon.ico
extraResources:
diff --git a/apps/desktop/electron-builder.yml b/apps/desktop/electron-builder.yml
index eb0c8bc0..cfe63a6e 100644
--- a/apps/desktop/electron-builder.yml
+++ b/apps/desktop/electron-builder.yml
@@ -7,4 +7,7 @@ protocols:
- omnirush
linux:
executableName: omnirush
+pacman:
+ # The AUR package's name, so the two replace each other cleanly.
+ packageName: omnirush
artifactName: omnirush-${os}-${arch}-${version}.${ext}
diff --git a/packaging/aur/.SRCINFO b/packaging/aur/.SRCINFO
index c8349962..ae9f28de 100644
--- a/packaging/aur/.SRCINFO
+++ b/packaging/aur/.SRCINFO
@@ -1,5 +1,5 @@
pkgbase = omnirush
- pkgdesc = An Open source alternative to Claude Cowork
+ pkgdesc = OmniRush.ai desktop app: AI agents for every profession
pkgver = 0.0.0
pkgrel = 1
url = https://github.com/omnirush-ai/omnirush-gui
@@ -18,7 +18,12 @@ pkgbase = omnirush
depends = mesa
depends = dbus
depends = hicolor-icon-theme
+ optdepends = libsecret: encrypt the sign-in with a Secret Service keyring
+ optdepends = gnome-keyring: Secret Service keyring for window-manager sessions (Hyprland, sway, i3)
options = !strip
+ options = !debug
+ source = omnirush-0.0.0-LICENSE::https://github.com/omnirush-ai/omnirush-gui/raw/v0.0.0/LICENSE
+ sha256sums = SKIP
source_x86_64 = omnirush-0.0.0-x64.tar.gz::https://github.com/omnirush-ai/omnirush-gui/releases/download/v0.0.0/omnirush-linux-x64-0.0.0.tar.gz
sha256sums_x86_64 = 0000000000000000000000000000000000000000000000000000000000000000
source_aarch64 = omnirush-0.0.0-arm64.tar.gz::https://github.com/omnirush-ai/omnirush-gui/releases/download/v0.0.0/omnirush-linux-arm64-0.0.0.tar.gz
diff --git a/packaging/aur/PKGBUILD b/packaging/aur/PKGBUILD
index 3ff5d96a..d1557e06 100644
--- a/packaging/aur/PKGBUILD
+++ b/packaging/aur/PKGBUILD
@@ -5,14 +5,18 @@
pkgname=omnirush
pkgver=0.0.0
pkgrel=1 # pkgrel should change when PKGBUILD does. Standard is to change back to 1 next time. Any interger is valid.
-pkgdesc="An Open source alternative to Claude Cowork"
+pkgdesc="OmniRush.ai desktop app: AI agents for every profession"
arch=('x86_64' 'aarch64')
url="https://github.com/omnirush-ai/omnirush-gui"
license=('MIT')
depends=('gtk3' 'nss' 'alsa-lib' 'libxss' 'libxtst' 'xdg-utils' 'at-spi2-core' 'libdrm' 'libxkbcommon' 'mesa' 'dbus' 'hicolor-icon-theme')
optdepends=('libsecret: encrypt the sign-in with a Secret Service keyring'
'gnome-keyring: Secret Service keyring for window-manager sessions (Hyprland, sway, i3)')
-options=(!strip)
+options=(!strip !debug)
+
+# The license text of the tagged release (MIT, with the ee/ exceptions it lists).
+source=("${pkgname}-${pkgver}-LICENSE::${url}/raw/v${pkgver}/LICENSE")
+sha256sums=('SKIP')
# Architecture-specific sources and checksums
source_x86_64=("${pkgname}-${pkgver}-x64.tar.gz::${url}/releases/download/v${pkgver}/omnirush-linux-x64-${pkgver}.tar.gz")
@@ -41,9 +45,16 @@ package() {
install -d "${pkgdir}/opt/omnirush"
cp -a "${bundle_dir}/." "${pkgdir}/opt/omnirush/"
+ # The Electron executable is named by linux.executableName in
+ # apps/desktop/electron-builder.yml.
install -d "${pkgdir}/usr/bin"
- ln -s /opt/omnirush/@omnirushdesktop "${pkgdir}/usr/bin/omnirush"
+ ln -s /opt/omnirush/omnirush "${pkgdir}/usr/bin/omnirush"
+ local size
+ for size in 16 24 32 48 64 128 256 512; do
+ install -Dm644 "${pkgdir}/opt/omnirush/resources/icons/linux/${size}x${size}.png" \
+ "${pkgdir}/usr/share/icons/hicolor/${size}x${size}/apps/omnirush.png"
+ done
install -Dm644 "${pkgdir}/opt/omnirush/resources/app-dist/omnirush-logo-square.svg" \
"${pkgdir}/usr/share/icons/hicolor/scalable/apps/omnirush.svg"
@@ -51,15 +62,18 @@ package() {
cat > "${pkgdir}/usr/share/applications/omnirush.desktop" <<'EOF'
[Desktop Entry]
Name=OmniRush.ai
-Comment=Run agents, skills, and MCP workflows
+Comment=OmniRush.ai desktop app
Exec=omnirush %U
Terminal=false
Type=Application
Icon=omnirush
-StartupWMClass=OmniRush.ai
-Categories=Development;Utility;
+StartupWMClass=ai.omnirush
+Categories=Development;
MimeType=x-scheme-handler/omnirush;
EOF
+ install -Dm644 "${srcdir}/${pkgname}-${pkgver}-LICENSE" \
+ "${pkgdir}/usr/share/licenses/${pkgname}/LICENSE"
+
chmod 4755 "${pkgdir}/opt/omnirush/chrome-sandbox"
}
diff --git a/packaging/aur/README.md b/packaging/aur/README.md
index 2d3ebd87..0e1bf50b 100644
--- a/packaging/aur/README.md
+++ b/packaging/aur/README.md
@@ -1,79 +1,52 @@
# Arch Linux package
-Use this directory to build and install the OmniRush.ai package locally on Arch Linux without Docker.
+OmniRush.ai installs on Arch Linux (`x86_64` and `aarch64`) in two ways.
-## What this packaging does
+## 1. The `.pacman` package from a release (quickest)
-- Targets `x86_64` and `aarch64` Arch Linux.
-- Downloads the published Electron GitHub release asset for the current architecture.
-- Installs the Electron bundle under `/opt/omnirush`.
-- Adds `/usr/bin/omnirush`, a desktop entry, and the OmniRush.ai icon.
-
-## Prerequisites
-
-- Arch Linux on `x86_64` or `aarch64`
-- `base-devel`
-- `curl`
-
-Install the packaging prerequisites once:
-
-```bash
-sudo pacman -S --needed base-devel curl
-```
-
-## Build and install the current packaged version
-
-From the repo root:
+Every GitHub release carries a pacman package per architecture, built by
+electron-builder next to the `.deb` and `.AppImage`:
```bash
-cd packaging/aur
-makepkg -si
+# x86_64
+sudo pacman -U https://github.com/omnirush-ai/omnirush-gui/releases/download/v<version>/omnirush-linux-x86_64-<version>.pacman
+# aarch64
+sudo pacman -U https://github.com/omnirush-ai/omnirush-gui/releases/download/v<version>/omnirush-linux-aarch64-<version>.pacman
```
-That will:
-
-1. download the Electron tarball pinned in `PKGBUILD`
-2. build an Arch package such as `omnirush-<version>-1-x86_64.pkg.tar.zst`
-3. install it locally with `pacman`
-
-After install, `omnirush` is available as the desktop launcher. The bundled sidecars remain inside `/opt/omnirush`; the package does not claim the standalone `opencode` command.
-
-## Update the package to a newer release
+It installs the app under `/opt/OmniRush.ai`, like the `.deb`, and pacman pulls
+in the runtime dependencies (the list is `pacman.depends` in
+`apps/desktop/electron-builder.base.yml`).
-If the GitHub release version changed, refresh the packaging metadata first:
+## 2. The PKGBUILD in this directory (AUR)
-```bash
-scripts/aur/update-aur.sh v0.13.4
-```
-
-Then rebuild:
-
-```bash
-cd packaging/aur
-makepkg -si
-```
+`PKGBUILD` repackages the release tarball (`omnirush-linux-x64-<version>.tar.gz`
+or `omnirush-linux-arm64-<version>.tar.gz`) under `/opt/omnirush`, and adds
+`/usr/bin/omnirush`, a desktop entry, the icons and the license. Both
+packages are named `omnirush`, so either replaces the other.
-## Build without installing
+The committed `PKGBUILD` and `.SRCINFO` are templates (`pkgver=0.0.0`, zero
+checksums). Render them for a release first:
```bash
+scripts/aur/update-aur.sh v<version> # sets pkgver and the sha256 sums
cd packaging/aur
-makepkg -s
+makepkg -si # build and install
```
-This leaves the built package in `packaging/aur/` so you can install it later with:
-
-```bash
-sudo pacman -U omnirush-<version>-1-x86_64.pkg.tar.zst
-```
+Do not commit the rendered files. `scripts/aur/publish-aur.sh` pushes them to
+the AUR repository `omnirush` (needs `AUR_SSH_PRIVATE_KEY`); the
+`aur-validate` workflow builds and checks them in an Arch container first.
-## Verify the installed app
+Prerequisites: `sudo pacman -S --needed base-devel curl`.
-```bash
-omnirush
-```
+## Checks
-If you want to confirm the package contents first:
+The `Linux Packages` workflow builds the x64 and arm64 installers on every
+change to this packaging, installs the `.pacman` and a `makepkg` build of this
+PKGBUILD on Arch Linux of the same CPU, and launches the app headless.
```bash
-pacman -Ql omnirush
+pacman -Ql omnirush # what the package installed
+omnirush # start the app
```
diff --git a/scripts/aur/update-aur.sh b/scripts/aur/update-aur.sh
index 30f04ffd..9c2862e0 100644
--- a/scripts/aur/update-aur.sh
+++ b/scripts/aur/update-aur.sh
@@ -102,5 +102,12 @@ text = re.sub(
flags=re.M,
)
text = re.sub(r"^\s*sha256sums_aarch64 = .*", f"\tsha256sums_aarch64 = {sha_arm64}", text, flags=re.M)
+# The license comes from the release tag too (source=, not per-arch).
+text = re.sub(
+ r"^\s*source = (\S+?)-[^-\s]+-LICENSE::(\S+?)/raw/v[^/\s]+/LICENSE$",
+ lambda m: f"\tsource = {m.group(1)}-{version}-LICENSE::{m.group(2)}/raw/v{version}/LICENSE",
+ text,
+ flags=re.M,
+)
srcinfo_path.write_text(text)
PY