bfree ✨

A better free, human by default. Inspired by tools like btop, bfree gives you memory and swap stats in a clean one-line summary.

The command nobody asked for — but your RAM deserves it. 🚀

Why bfree?

The traditional free command is powerful but outdated in UX and modern workload awareness.

Problems with free

• ❌ Not human-readable by default (KB output)
• ❌ Confusing memory semantics (used vs free vs buff/cache)
• ❌ No percentages
• ❌ No visual signal
• ❌ Not container/cgroup aware
• ❌ No context about reclaimable memory
• ❌ No PSI (pressure stall info)
• ❌ Misleading inside Kubernetes / Docker / Podman

Modern systems deserve better visibility.

Highlights

• 🧼 Clean by design — minimal, focused, and pleasant to read
• 📊 Human-first output — sizes + percentages in one line
• 🧠 Useful memory semantics — includes effective reclaimable cache
• ⚡ Snappy — lightweight Rust CLI

Status

• ✅ Linux /proc/meminfo parser
• ✅ One-line memory + swap output
• ✅ Percentages for used/cache/available/swap
• ✅ Unit tests for memory math
• 🔜 Container/cgroup-aware mode
• 🔜 PSI (pressure stall information)
• 🔜 Optional visual signal (bars/colors)

Current Semantics

• used = MemTotal - MemAvailable
• cache = Cached + SReclaimable - Shmem (effective reclaimable cache)
• avail = MemAvailable

Run

cargo run --

Contributing

Ideas, feedback, and PRs are welcome. The project is young — jump in early and shape it.

Made with ❤️ for the terminal.