🧹 safaai — TUI-first Developer Workstation Optimizer

    ___   ___   ___  ___   ___   _ 
   / __| / _ \ | __|/ _ \ / _ \ | |
   \__ \| (_) || _| \_, / \_, / |_|
   |___/ \___/ |_|  /_/  /_/    (_)

Understand your workstation. Never blindly delete. Optimize like a developer.

💡 The Motivation: AI Era vs. Developer Disk Space

We live in the golden age of AI, local LLMs, and agentic coding workflows. But with great developer power comes great disk-space responsibility.

Every single week, your workstation accumulates:

• Gigabytes of Xcode DerivedData and archived artifacts.
• Monstrosity-level node_modules directories hidden in old forgotten directories.
• Orphaned Docker volumes and dangling images.
• Caching artifacts from package managers like Homebrew.
• Massive model weights and vector DB test logs.

Sometimes, your machine starts chugging, and you just need an instant performance boost (freeing inactive RAM, purging caches, killing rogue memory-hogging consumer apps) without launching a heavy, closed-source consumer GUI app.

While there are plenty of disk cleaning utilities for Windows, developers on macOS and Linux are often left to guess which rm -rf command will break their local databases or compilation systems.

safaai is built for devs: terminal-first, completely open-source, interactive, and transparent.

🛠️ Commands Reference

Press / inside the application to open the command palette and run slash commands:

💻 OS Support Matrix

🚀 Installation & Launch

Run it instantly using uv (recommended):

uv tool install safaai
safaai

Or install via pipx / pip:

pipx install safaai
safaai

For macOS standalone binary downloads or custom Homebrew formula taps, check the Releases page.

🔧 For Developers

If you want to run safaai locally and contribute new scanners:

# Clone the repository
git clone https://github.com/manugopinath-dev/safai.git safaai
cd safaai

# Install dependencies and sync environment
uv sync

# Run the TUI in development mode
uv run safaai

# Run the test suite
uv run pytest

Made with ♥ by Manu Gopinath