All versions since v3.1.10

Find a version

All versions

v3.1.10

Oct 30, 2026

🐚 Shelly-ALPM v3.1.10 Release Notes

Shelly v3.1.10 improves AUR build reliability, resolves system upgrades and explicitly requested repository packages together, and makes RLPM failures easier to understand. The CLI gains a shell progress animation and package-name output for scripts and completions, while the desktop app gets better keyboard navigation and more accurate package lists.

Behind the scenes, Shelly moves to Zig 0.17.0, updates its build and packaging workflows, and removes Arch Linux news from Devario builds.

🧱 More reliable AUR builds

Build dependencies are now discovered and installed before prepare() runs, including when an AUR package needs other AUR packages to build. Dependency planning reads metadata without downloading sources, running lifecycle functions, or changing the reviewed PKGBUILD. Normal source preparation and version updates happen after dependencies are available. (#2110)

This release also improves compatibility with package recipes:

• 🧩 Support prefix and suffix trimming on quoted indexed array elements, including expressions such as ${source[0]%%::*}, fixing UnsupportedArrayExpansion failures for these constructs.
• 📝 Collapse whitespace in multiline pkgdesc values when writing .PKGINFO, keeping descriptions on one valid metadata line. (#2100)
• 📥 Accept larger HTTP response headers during downloads, fixing failures involving GitHub security headers and redirects. (#2096)

🔄 Upgrades and package configuration

shelly install standard --upgrade now resolves the system upgrade and explicitly requested repository packages in one transaction. This fixes dependency failures when a requested package and its updated libraries need to move together, including explicit targets from another repository. The confirmation preview explains the combined operation. (#2105)

Changes to IgnorePkg now preserve the separation between the main configuration and included files. Adding or removing an entry no longer copies inherited entries into pacman.conf. (#2101)

🐛 Clearer RLPM errors and progress

RLPM reports more useful explanations for failures involving configuration, database locks, downloads, filesystem operations, hooks, and scriptlets. Diagnostics retain the underlying technical error and add relevant context, including action names and exit status when available.

File-conflict reporting carries the conflicting paths and package identities into the transaction diagnostics. Download verification and publication progress bars also clear when their work finishes, keeping subsequent hook output readable while other downloads continue.

🐚 A little more shell in your terminal

The new Shell progress style opens and closes a small ASCII shell as it advances along the bar. It becomes the default when no style is saved; existing style choices are preserved. To select it:

shelly config set ProgressBarStyle Shell

Blocks and Pacman remain available. Redirected output prints completed progress lines without animation.

The CLI also adds --names-only to standard and AUR package lists and standard searches. Each matching package name appears on its own line, and standard searches bypass pagination:

shelly list standard --names-only
shelly list aur --names-only
shelly search standard --names-only --show-hidden

Bash, Fish, and Zsh package completions now query Shelly directly, removing their dependency on pacman for those package lists.

🧭 Desktop navigation and package lists

• ♿ Give pages an accessible focus stop so keyboard traversal reaches their content. The first-run wizard also moves focus into each new page, helping keyboard and screen-reader users follow the setup flow. (#2107)
• 📦 Keep the Packages tab based on repository results, using installed-package data to annotate installation status. Foreign and local-only packages no longer appear there as repository packages with unsuitable actions. (#2108)

🌊 Devario defaults

Builds using the Devario path profile no longer fetch or display Arch Linux news during upgrades. News commands are omitted from help, generated manuals, and shell completions; explicitly invoking them reports that news is unavailable. This follows the build’s distribution profile, so selecting another runtime backend does not change it. Builds using the pacman path profile retain Arch news. (#2109)

📦 Build and packaging updates

• ⚡ Move the native components and build recipes to Zig 0.17.0, with matching API and build-option updates. (#2117)
• ✅ Install checksum-verified official Zig archives in CI for the runner’s architecture.
• 🧩 Replace vendored dependency copies with upstream dependencies pinned by URL and content hash.
• 📦 Add a dedicated CachyOS packaging directory and update Arch and Devario build workflows.

🚀 Upgrade notes

Source builds now require Zig 0.17.0. Populate the dependency cache before building offline with zig build --fetch=all in each component you intend to build.

install standard --upgrade cannot be combined with --build-deps; upgrade the system separately before installing build dependencies.

🌍 Translations and thanks

🇫🇷 This release updates the French UI translation.

❤️ Thank you to Zoey Bauer, VinnyQF, Anton Ždanov, Mohit Mishra, Tomás Arribas, and Thierry M for their contributions, and to everyone reporting issues and testing fixes.

📋 Full Changelog: v3.1.9…55a23eb0

🔀 Release pull request: #2120

🐚 Shelly-ALPM v3.2.0 — The Bug Bash Latest

Nov 5, 2026

🐚 Shelly-ALPM v3.2.0 — The Bug Bash

Shelly v3.2.0 is a bug bash: a round of fixes for the things that get between you and your packages. Since v3.1.10, we’ve tackled Flatpak failures, stubborn tray icons, missed restart detection, AUR build errors, and package information that wasn’t telling the whole story.

A few quality-of-life improvements came along too, including multi-package downgrades, AppImage update discovery, and a choice of terminal for updates.

🐛 Flatpak and permissions, untangled

Fixed the Flatpak regression affecting Arch Linux after v3.1.10. Elevated operations now hand work back to the invoking user with setpriv, preserving the login session context needed for Flatpak’s system-helper authentication.

User-cache handling also gets a cleanup. Shelly writes the invoking user’s cache using that user’s credentials, including when launched through supported privilege-elevation tools, and preserves absolute XDG_CACHE_HOME overrides.

Existing ownership problems can be repaired from your regular user session with:

shelly utility --fix-permissions

This repairs Shelly’s directories; it does not change ownership of the parent ~/.cache directory.

🔔 A tray icon that keeps up

• 🔄 Stale update status: The notification service now watches package database changes and refreshes its status after package operations. (#2151)
• 🔌 Endless reconnect loops: When DBUS_SESSION_BUS_ADDRESS is missing, Shelly falls back to $XDG_RUNTIME_DIR/bus. If neither provides a usable address, it reports the problem instead of retrying forever. (#2137)
• 🖥️ Your terminal, your updates: Choose the terminal used to launch updates from the notification service. (#2148)

🔄 Restart detection, actually detecting

Post-upgrade restart and reboot checks were reading some /proc files as empty because those files report a size of zero. Shelly now reads their contents correctly, restoring the information those checks depend on.

The scan also stops treating a deleted /etc/ld.so.cache mapping as a stale shared library, avoiding misleading restart recommendations after ldconfig runs. (#2149)

🧱 AUR builds with fewer surprises

• 🧩 Computed architecture lists: Fix InvalidArchitectureDirective failures when a PKGBUILD derives arch from an associative array. Unresolved values are validated after evaluation. (#2144)
• 🌿 Git source races: Finish cached Git mirror maintenance before cloning build sources, preventing the two operations from racing. (#2123)
• 📝 Useful metadata errors: Package-assembly failures now name the rejected metadata field, making broken recipes easier to diagnose. (#2113)
• ⚙️ Clearer build configuration: Expanded shellybuild.conf documentation explains configuration precedence, compiler flags, and portable versus host-specific settings.

📦 Package information you can trust

Installed package versions now take priority in the UI and CLI search results, rather than being replaced by the repository version. RLPM also correctly reports installation status and dates. (#2044, #2143)

Upgrade previews now include repository package replacements, making it clearer what will change before you confirm. (#2119)

Behind the scenes, unnecessary RLPM database snapshot hashing has been removed, reducing repeated database work.

🧹 Cleaning up the cleanup

purify now recognises leftover pacman download-XXXXXX directories, including those containing partial downloads, and includes them in its cleanup plan. (#2150)

Removing a stale database lock from the desktop app also runs asynchronously, keeping the interface responsive while authentication completes. (#2142)

🖼️ AppImages, better connected

AppImage desktop integration now uses the application’s shipped desktop-file identity and removes superseded launcher entries during updates, addressing naming mismatches and duplicate menu entries. (#2134)

Update support gains embedded update-information discovery and .zsync control-file support. GitHub asset matching honours embedded filename patterns, and release selection receives additional fixes. (#2146, #2147)

✨ A few extras between the fixes

• ⏪ Downgrade packages together: Select older versions of multiple installed packages and install them in one transaction. --target remains a single-package option. (#2132)
• 🎨 Readable console output: The desktop transaction view gains ANSI colour and formatting support. (#2138)
• 📥 Download speeds: CLI progress lines now show transfer speed. (#2139)
• ✅ Recommended apps in batches: Select multiple applications from the Recommended page for installation.

🌍 Translations and thanks

🇻🇳 Added Vietnamese translations for the desktop UI and notifications.
🇦🇩 Updated the Catalan translation.

❤️ Thank you to everyone who reported a bug, supplied a reproduction, tested a fix, or contributed a patch. This bash was built around those reports.