Meridian Dynamics

A gift from Meridian Dynamics · Free

Pulse

Your Mac tells you before it slows down.

A gift from Meridian Dynamics. It installs on your Mac and works without the internet.

Install it with one command

curl -fsSL https://meridiandynamics.net/pulse/install.sh | sh

installs to ~/.pulse · requires macOS 13 or later

Local install

One command. Your Mac does the rest.

Pulse is not a service: it is a file in your home folder that macOS runs every hour. This is what installing it looks like.

Terminal simulation: the install command is pasted, Pulse turns on and a dry run shows two alerts.

What it does

Three alerts. Nothing else.

  • Disk

    When less than 60 GB is free. With a full disk, macOS has nowhere to move memory and everything slows down.

  • Memory

    When swap goes over 5 GB or macOS reports memory pressure. It means too much is open.

  • Restart

    After 3 days without a restart if swap is high, or after 5 days no matter what. A restart clears what builds up.

Details

  • Lives only on your Mac

    Once installed, Pulse uses no internet and sends no data. Everything happens in ~/.pulse and you can read the code before installing.

    ~/.pulse
    // What is on your Mac
    ~/.pulse/pulse.sh ← the script
    ~/.pulse/config ← your limits
    ~/Library/LaunchAgents/net.meridiandynamics.pulse.plist
  • You set the limits

    Change when it speaks up by removing the # from a line. No code editing.

    ~/.pulse/config
    # ~/.pulse/config
    DISCO_MIN_GB=60
    SWAP_MAX_GB=5
    DIAS_REINICIO=3
    PAUSA_H=12
  • Try it without waiting

    Shows what Pulse sees right now, without sending notifications or saving anything.

    zsh
    $ DRY=1 ~/.pulse/pulse.sh
    libre=48GB swap=7GB dias=4
  • Leaves no trace

    Stops the agent, deletes its macOS file and the ~/.pulse folder.

    zsh
    $ ~/.pulse/uninstall.sh
    ✓ Pulse uninstalled

Uninstall

~/.pulse/uninstall.sh

macOS shows them as "Script Editor", the system tool Pulse uses to notify you. Enable it in Settings → Notifications.

View the code