https://github.com/jstreitb/baa
BAA: The cozy TUI that herds your package managers. Unified updates for apt, pacman, snap & flatpak... 🐑
https://github.com/jstreitb/baa
apt automation bubbletea charmbracelet cli developer-tools flatpak go golang linux opensource package-manager pacman security snap system-update terminal-app terminal-ui tui
Last synced: about 1 month ago
JSON representation
BAA: The cozy TUI that herds your package managers. Unified updates for apt, pacman, snap & flatpak... 🐑
- Host: GitHub
- URL: https://github.com/jstreitb/baa
- Owner: jstreitb
- License: mit
- Created: 2026-04-18T14:32:16.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-27T11:19:03.000Z (about 1 month ago)
- Last Synced: 2026-04-27T13:13:01.873Z (about 1 month ago)
- Topics: apt, automation, bubbletea, charmbracelet, cli, developer-tools, flatpak, go, golang, linux, opensource, package-manager, pacman, security, snap, system-update, terminal-app, terminal-ui, tui
- Language: Go
- Homepage:
- Size: 13.5 MB
- Stars: 2
- Watchers: 0
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 🐑 BAA 🐑
**The universal Linux package manager updater.**
One command. One password. Every package manager updated.
⭐ **If you find BAA useful, consider giving it a star!**
> [!NOTE]
> **From Weekend Project to Clean Code:** BAA was originally planned as a quick weekend project, which resulted in the old codebase becoming absolute spaghetti code. To ensure maintainability, security, and testability, we have completely rewritten the application from scratch with a modular, enterprise-ready architecture.
[](https://github.com/jstreitb/baa/releases)
[](LICENSE)
[](https://go.dev)
[](https://github.com/jstreitb/baa/stargazers)
---
## Quick Install
```bash
curl -sSfL https://raw.githubusercontent.com/jstreitb/baa/main/install.sh | bash
```
> **Security Note:** You can verify the installer script before running it by downloading it first, reading it, or checking its checksum against the release assets.
To update BAA itself to the latest version, simply run:
```bash
baa --update
```
To uninstall BAA from your system, run:
```bash
baa --uninstall
```
Or build from source:
```bash
git clone https://github.com/jstreitb/baa.git
cd baa && make build
sudo mv baa /usr/local/bin/
```
## How It Works
```
$ baa
```
1. **Detects** installed package managers automatically
2. **Asks** for your sudo password once (masked, secure)
3. **Updates** everything sequentially with a live animated TUI
4. **Shows** a summary of what succeeded and failed
That's it. No config files, no complicated setup.
## Command-Line Flags
| Flag | Description |
|------|-------------|
| `--update` | Updates baa to the latest version |
| `--uninstall` | Uninstalls baa from your system |
| `--detect` | Shows detected package managers and exit |
| `--credits` | Shows the credits and exit |
| `--version` | Prints the current version |
| `--help` | Shows the help message |
## Supported Package Managers
| Manager | Detected via | Sudo | Non-Interactive Flags |
|---------|-------------|------|-----------------------|
| **apt** | `apt-get` | ✓ | `DEBIAN_FRONTEND=noninteractive`, `--force-confold` |
| **dnf** | `dnf` | ✓ | `-y` |
| **zypper** | `zypper` | ✓ | `--non-interactive`, `up` |
| **pacman** | `pacman` | ✓ | `--noconfirm` |
| **nix** | `nix-env` | ✗ | `-u` |
| **brew** | `brew` | ✗ | `upgrade` |
| **flatpak** | `flatpak` | ✗ | `-y --noninteractive` |
| **snap** | `snap` | ✓ | — |
> **Adding a new manager?** It's a single file. See [CONTRIBUTING.md](CONTRIBUTING.md#adding-a-new-package-manager).
## Features
### 🔍 Auto-Detection
Probes `$PATH` for every supported package manager — no configuration needed.
### 🔒 Secure by Design
Password stored as `[]byte`, zeroed after use, delivered via `stdin` pipe. Never appears in process args or logs.
### 🤖 Fully Autonomous
Non-interactive flags handle everything. No "Press Y to continue" interruptions.
### 🛟 Interactive Fallback
If a manager *needs* user input (e.g. a dpkg config prompt), BAA suspends the TUI and drops you into the raw terminal. Resume is automatic.
### 🎨 Beautiful TUI
Catppuccin Macchiato theme, ASCII sheep animation, live command output, styled summary screen.
### ⚡ Fast & Lightweight
Single static binary. No runtime dependencies. ~3 MB.
## Security
BAA takes security seriously:
| Measure | Implementation |
|---------|---------------|
| **Password storage** | `[]byte` — never a Go `string` |
| **Memory cleanup** | Explicit zeroing with `for i := range pw { pw[i] = 0 }` |
| **Password delivery** | Piped via `stdin` to `sudo -S` |
| **Process args** | Password never appears in CLI arguments |
| **Environment** | Env vars passed through `sudo -- env` to reach child processes |
| **Goroutine copies** | Each copy is independently zeroed after use |
## Architecture
```
baa/
├── cmd/baa/main.go # Entry point
├── internal/
│ ├── ui/ # Bubbletea TUI (model, views, styles, components)
│ ├── pkgmanager/ # PackageManager interface + implementations
│ └── utils/ # Secure sudo execution, error sanitization
├── install.sh # One-line installer
├── .goreleaser.yml # Release automation
└── Makefile
```
Built with the [Charmbracelet](https://charm.sh/) ecosystem:
- [Bubble Tea](https://github.com/charmbracelet/bubbletea) — TUI framework
- [Lip Gloss](https://github.com/charmbracelet/lipgloss) — Styling
- [Bubbles](https://github.com/charmbracelet/bubbles) — Components
### 🐑 The Flock
BAA is a community-driven project. A huge thank you to the amazing people who help guide the herd!
## Contributing
Contributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md) before getting started.
## AI Assistance
"If you can't beat them, join them."
This project was architected and developed with the support of AI Assistance.
## License
[MIT](LICENSE) — go build something great.