Amethyst is a fast, efficient and lightweight AUR helper and Pacman wrapper. Made for Crystal, compatible with any Arch-based Linux distribution
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Go to file
Michal S 64b7ea72bc Fixed env for flake 2 years ago
.cargo add fallback AMETHYST_CODENAME 2 years ago
.devcontainer Update Dockerfile 2 years ago
.github/workflows Adjust CI to have new codename envvar 2 years ago
docs Add documentation for config keys 2 years ago
src args: make quiet help more clear 2 years ago
.envrc Revert changes from Nix rust tool 2 years ago
.gitignore Revert changes from Nix rust tool 2 years ago
Cargo.lock config: use config crate 2 years ago
Cargo.toml config: use config crate 2 years ago
Containerfile Fix debug container script 2 years ago
LICENSE Create LICENSE 2 years ago
README.md Add `makepkg` instructions 2 years ago
flake.lock Fix searching (both AUR and repo) 2 years ago
flake.nix Fixed env for flake 2 years ago
logo.svg Add a new logo 2 years ago
run-isolated.sh [WIP] Implement parallel aur install 2 years ago

README.md

Logo

Amethyst


License GitHub issues GitHub pull requests
Discord The maintainer of this repository
Mastodon Follow Twitter Follow

Amethyst is a fast, efficient and lightweight AUR helper and Pacman wrapper.
Made for Crystal, compatible with any Arch-based Linux distribution.

Basic usage

Action FreeBSD pkg-style alias Pacman-style flags
Install a package ame ins/install ame -S
Remove a package ame rm/remove ame -R/-Rs
Upgrade a package ame upg/upgrade ame -Syu
Search for a package ame sea/search ame -Ss
Query the package list ame qu/query ame -Q
Show a package's info ame inf/info ame -Qi
Clean the pacman cache ame cl/clean ame -Sc
Check for .pacnew ame di/diff ame -D

Exit codes overview

Exit Code (i32) Reason
1 Running ame as UID 0 / root
2 Failed creating paths
3 Could not find one or more required package dependencies
4 User cancelled package installation
5 Pacman error when installing package
6 Git error
7 Makepkg error
8 Failed to parse config file
63 Any other misc error

Install on non-Crystal distros

  • sudo pacman -S --needed base-devel pacman-contrib cargo
  • git clone https://github.com/crystal-linux/pkgbuild.amethyst
  • cd pkgbuild.amethyst && makepkg -si

Debug/development builds

  • cargo build

Optimised/release builds

  • cargo build --release

TODO:

v3.6.0

  • Allow editing of PKGBUILDs before install