Reading the repo
Reading the repo
How to install on Windows
Monitors your RAM and reports any "quite terrible" unused capacity directly to the CEO of OpenAI.
Fresh setup, read just now
Will it work on Windows?
winget install Git.Git) or WSL2 (wsl --install).You'll need Linux, bash, and a working sendmail, msmtp or mail command. Your RAM is assumed.
git clone https://github.com/IainKay/ram-altman.git
cd ram-altman
chmod +x ram-altman.sh test-ram-altman.sh
./ram-altman.sh --status # see the evidence against you
./ram-altman.sh --dry-run # preview an email without sending it
Example output, from a simulated machine that has confessed to everything:
Total: 15.3 GiB
Used: 6.7 GiB
Available: 8.6 GiB (56.2%)
Free: 0.3 GiB
Cache: 8.2 GiB
To run it for real, add this to your crontab with crontab -e:
RAM_ALTMAN_TO=recipient@example.com
RAM_ALTMAN_FROM=you@example.com
RAM_ALTMAN_FROM_NAME=Your Name
*/5 * * * * /path/to/ram-altman.sh
It samples every five minutes and emails at most once a day. If a send fails, it tries again on the next run, because this message matters.
| Setting | What it does | Default |
| --- | --- | --- |
| RAM_ALTMAN_TO | Who receives the bad news | Required |
| RAM_ALTMAN_FROM | A real address you can send from | Required |
| RAM_ALTMAN_FROM_NAME | Your name, or your nom de RAM | Optional |
| RAM_ALTMAN_THRESHOLD | Email when available RAM is above this percentage (whole number) | 10 |
| RAM_ALTMAN_STATE_DIR | Where the log and state files live | ~/.local/state/ram-altman |
Then run powershell -ExecutionPolicy Bypass -File .\setup.ps1. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: winget install Git.Git
git clone https://github.com/IainKay/ram-altman.git cd ram-altman
Run these in Git Bash (installed with Git) or WSL — not PowerShell. Do the README instructions above first.
chmod +x ram-altman.sh test-ram-altman.sh ./ram-altman.sh --status # see the evidence against you ./ram-altman.sh --dry-run # preview an email without sending it
The steps run shell scripts (.sh). Use Git Bash (winget install Git.Git) or WSL2 (wsl --install).
No reports for Windows yet.
Opens a chat with this manual already filled in, for Windows. It uses your own account; gitmanual sends nothing.