pacc

pacc is an Arch Linux package management assistant with a terminal user interface. It aims to put pacman, paru, and AUR-oriented workflows into one focused TUI so common maintenance tasks feel fast, visible, and safe.

This project is currently in an early scaffold stage. The UI shell is in place, and the next steps are wiring real package data, package actions, and safer command execution flows.

Goals

• Show the system package state from one screen
• Surface upgrades from pacman and paru
• Review AUR updates without jumping between tools
• Help manage orphan packages and package cache cleanup
• Keep dangerous operations explicit and reviewable

Current Status

The current build includes:

• A Rust TUI built with ratatui and crossterm
• Basic app state, focus management, and keyboard navigation
• Backend detection for pacman and paru
• Keyword search over local paru cache and clone metadata
• Cache entry inspection for PKGBUILD, git metadata, and archived package files

Planned Features

• Real package inventory from pacman -Q
• Upgrade views for official repos and AUR packages
• Search, filtering, and per-package inspection
• Action confirmations for sync, upgrade, remove, clean, and orphan flows
• Background command execution and better error reporting

Usage

cargo run

Default keys:

• Tab: switch focus
• /: enter paru cache search mode
• Space: toggle selection for the highlighted cache entry
• d: open delete confirmation for the selected cache entry
• Up / Down: move selection
• Enter: inspect the selected cache entry or trigger the selected action stub
• r: refresh backend detection
• q or Esc: quit

Development

cargo fmt
cargo check

Publishing

This crate is published on crates.io as pacc.

License

Licensed under either of the following, at your option:

• Apache License, Version 2.0
• MIT License

See LICENSE-APACHE and LICENSE-MIT.