Shelly is a modern reimagination of the Arch Linux package manager, designed to be a more intuitive and user-friendly alternative to pacman and octopi. Unlike other Arch package managers, Shelly offers a modern, visual interface with a focus on user experience and ease of use; It IS NOT built as a pacman wrapper or front-end. It is a complete reimagination of how a user interacts with their Arch Linux system, providing a more streamlined and intuitive experience.

Recommended install for Shelly with a single command:

curl -fsSL https://raw.githubusercontent.com/ZoeyErinBauer/Shelly-ALPM/master/web-install.sh | sudo bash

Or if on CachyOS or using CachyOS packages

sudo pacman -S shelly

This will download and install the latest release, including the UI and CLI tools.

To install with an AUR helper like yay or paru.

yay -S shelly

or

paru -S shelly

Note: -bin packages will be made available soon and will allow you to install without needing to run makepkg every update.

To uninstall the quick installer version is you wish to switch to the AUR managed version:

curl -fsSL https://raw.githubusercontent.com/ZoeyErinBauer/Shelly-ALPM/master/uninstall.sh | sudo bash

• Modern-CLI: Provides a command-line interface for advanced users and automation, with a focus on ease of use.
• Native Arch Integration: Directly interacts with libalpm for accurate and fast package management.
• Modern UI Framework: Built using Avalonia UI, ensuring a modern and responsive user interface.
• Package Management: Supports searching for, installing, updating, and removing packages.
• Repository Management: Synchronizes with official repositories to keep package lists up to date.
• AUR Support: Integration with the Arch User Repository for a wider range of software.
• Flatpak Support: Manage Flatpak applications alongside native packages.

Upcoming features and development targets:

• Repository Modification: Allow modification of supported repositories (First future release).
• Package Grouping: Group related packages for easier management.
• Desktop Integration: Enhance integration with the desktop environment for seamless experience. Targeting KDE Plasma and Gnome initially.
• Shelly Sync: Multi-system sync lists that keep packages together across computers

• Arch Linux (or an Arch-based distribution)
• .NET 10.0 Runtime (for running only if installed from non *-bin aur package)
• .NET 10.0 SDK (for building)
• libalpm (provided by pacman)
• xwayland

Since Shelly is designed for Arch Linux, you can build and install it using the provided PKGBUILD:

git clone https://github.com/ZoeyErinBauer/Shelly-ALPM.git
cd Shelly-ALPM
makepkg -si

You can also build the project manually using the .NET CLI:

dotnet publish Shelly-UI/Shelly-UI.csproj -c Release -o publish/shelly-ui
dotnet publish Shelly-CLI/Shelly-CLI.csproj -C Release -o publish/shelly-cli
dotnet publish Shelly-CLI/Shelly-CLI.csproj -C Release -o publish/shelly-notifications

alternatively you can run

sudo ./local-install.sh

This will build and perform the functions of install.sh

The binary will be located in the /publish/shelly-ui/ directory.

Run the application from your terminal or application launcher:

shelly-ui

In it's install location or by opening it from your applications menu.

Shelly also includes a command-line interface (shelly-cli) for users who prefer terminal-based package management. The CLI provides the same core functionality as the UI but in a scriptable, terminal-friendly format.

Global options:

• --help - Display help information
• --version - Display version information

sync command:

• -f, --force - Force synchronization even if databases are up to date

install, remove, update commands:

• --no-confirm - Skip confirmation prompt

upgrade command:

• --no-confirm - Skip confirmation prompt

# Synchronize package databases
shelly sync

# Force sync even if up to date
shelly sync --force

# List all installed packages
shelly list-installed

# List packages needing updates
shelly list-updates

# Install packages
shelly install firefox vim

# Install without confirmation
shelly install firefox --no-confirm

# Remove packages
shelly remove firefox

# Update specific packages
# This should not be done unless you know what you're doing
shelly update firefox vim

# Perform full system upgrade
# Preferred way to update your system
shelly upgrade

# System upgrade without confirmation
shelly upgrade --no-confirm

Shelly is structured into several components:

• Shelly-UI: The main Avalonia-based desktop application.
• Shelly-CLI: Command-line interface for terminal-based package management.
• Shelly-Notifications: Tray service to manage notifactions the Shelly-UI.
• PackageManager: The core logic library providing bindings and abstractions for libalpm.
• PackageManager.Tests: Comprehensive tests for the package management logic.
• Shelly-UI.Tests: Unit tests for the Avalonia UI components.

dotnet build

dotnet test

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

Shelly is in active development. It comes with no guarantees and may contain bugs, however if you experience issues please report them by opening an issue on this page and we will do our best to resolve the issues.

• Some UI controls were inspired by Aura.UI