https://github.com/pedrolucaslco/linux-memory-assistant
A lightweight Linux helper that alerts you when your system memory usage gets too high — inspired by macOS-style alerts.
https://github.com/pedrolucaslco/linux-memory-assistant
bash gnome gtk linux memory-management ram shell zenity
Last synced: about 2 months ago
JSON representation
A lightweight Linux helper that alerts you when your system memory usage gets too high — inspired by macOS-style alerts.
- Host: GitHub
- URL: https://github.com/pedrolucaslco/linux-memory-assistant
- Owner: pedrolucaslco
- Created: 2025-10-07T19:58:46.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-08T11:42:34.000Z (9 months ago)
- Last Synced: 2025-10-08T13:31:34.606Z (9 months ago)
- Topics: bash, gnome, gtk, linux, memory-management, ram, shell, zenity
- Language: Shell
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧠 PLCO Memory Assistant
A lightweight Linux helper that alerts you when your system memory usage gets too high — inspired by macOS-style alerts.
## ⚙️ Installation
Run the installer:
```bash
./install.sh
```
## 🚀 Running Manually
If you want to start it right away (without rebooting):
```bash
nohup ~/.local/share/plco-memory-assistant/bin/memory-assistant >/dev/null 2>&1 &
```
## 🔍 Checking Status
Use the included check-status script:
```bash
~/.local/share/plco-memory-assistant/bin/check-status
```
It will:
Show whether the service is running and display its PID
Offer to start it if it’s not running
Example output:
```bash
✅ memory-assistant is running (PID: 12345)
or
❌ memory-assistant is not running
Start it now? (y/n):
```
## 🧪 Testing the Assistant
To verify it’s working:
Run check-status and confirm the process is active.
Open several apps or use a memory-stress tool to push RAM usage above your configured threshold.
A Zenity alert should appear when memory usage passes the limit.
## 🧼 Uninstall (optional)
To remove everything:
```bash
pkill -f memory-assistant 2>/dev/null
rm -rf ~/.local/share/plco-memory-assistant
rm -f ~/.config/autostart/plco-memory-assistant.desktop
echo "✅ Memory Assistant removed."
```