Files
Cursor AgentandFrank Vitrano 7380d7c4b8 Document one-line upgrade via install.sh re-run
Clarify that re-running the curl installer upgrades in place, and detect
an existing install so the script prints an Updating message.

Co-authored-by: Frank Vitrano <WHC2006@users.noreply.github.com>
2026-07-23 14:45:58 +00:00

74 lines
1.6 KiB
Markdown

# miaur
A lightweight AUR helper written in pure Bash. No helper compilation required.
Its everyday commands follow paru, including `-Syu`, `-S`, `-Ss`, `-Qua`, and `-G`.
## Install
```bash
git clone https://github.com/WHC2006/miaur.git
cd miaur
./install.sh
```
One command:
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/WHC2006/miaur/main/install.sh)
```
Install for the current user under `~/.local`:
```bash
./install.sh --user
```
The installer adds the required packages automatically: `base-devel`, `git`, `curl`, and `jq`.
## Upgrade
Already installed (preferred):
```bash
miaur self-update --noconfirm
```
One-line reinstall from GitHub (same as install; overwrites the current prefix):
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/WHC2006/miaur/main/install.sh)
```
User install:
```bash
bash <(curl -fsSL https://raw.githubusercontent.com/WHC2006/miaur/main/install.sh) --user
```
## Usage
```bash
miaur # Upgrade everything (same as -Syu)
miaur foo # Search and select packages interactively
miaur -S <package> # Install a package
miaur -Ss <query> # Search packages
miaur -Qua # List available AUR upgrades
miaur -Sua # Upgrade AUR packages only
miaur -G <package> # Download a PKGBUILD
miaur --noconfirm -Syu # Upgrade without prompts
miaur self-update # Update miaur from Git
```
Run `miaur -h` for more options.
## Configuration
The optional configuration file is `~/.config/miaur/miaur.conf`. See `config/miaur.conf.example`.
Self-update reads `RepoUrl` / `Branch` (or `MIAUR_REPO` / `MIAUR_BRANCH`) when set.
## License
MIT