CLI Tool
apkg
Argo Package Manager
Simplified Gentoo package management with Build Swarm integration
Quick Start
Terminal
$
apkg install firefox
# Install a package
$
apkg search vim
# Search for packages
$
apkg update
# Sync and update system
$
apkg remove package
# Uninstall a package
Why apkg?
Traditional Gentoo
emerge --ask --verbose --update --deep --newuse @world
- Long, hard to remember commands
- Compiles everything from source
- Hours/days of compilation time
- Complex USE flag management
With apkg
apkg upgrade
- Simple, intuitive commands
- Uses binary packages from Build Swarm
- Updates in minutes, not hours
- Automatic binhost configuration
Features
Binary Package First
Automatically fetches pre-compiled packages from the Build Swarm binhost when available.
Smart Search
Fuzzy search across package names and descriptions with highlighted results.
Status Dashboard
View installed packages, pending updates, and system health at a glance.
USE Flag Helper
Interactive USE flag selection with descriptions and dependency info.
Swarm Integration
Request builds from the Build Swarm if a package isn't in the binhost yet.
Beautiful Output
Color-coded, human-readable output with progress bars and status indicators.
Command Reference
| Command | Description | Equivalent emerge |
|---|---|---|
apkg install <pkg> |
Install a package | emerge --ask pkg |
apkg remove <pkg> |
Uninstall a package | emerge --ask --depclean pkg |
apkg search <term> |
Search for packages | emerge --search term |
apkg update |
Sync repos & show updates | emerge --sync && emerge -pvuDN @world |
apkg upgrade |
Apply all updates | emerge -uDN @world |
apkg info <pkg> |
Show package details | equery meta pkg |
apkg clean |
Remove orphan packages | emerge --depclean |
apkg status |
System status dashboard | No equivalent |
Installation
1
Clone the repository
git clone https://github.com/KeyArgo/apkg.git
2
Run the installer
cd apkg && sudo ./install.sh
3
Configure binhost (optional)
apkg config --binhost http://binhost.local:8080