mac-volume — macOS Volume Control

SkillMedia

Gets or sets the macOS system output volume (0, 100) using osascript. Use when the user asks to check the volume, change the volume, turn volume up or down, mute, set audio level, or adjust sound output on macOS.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the mac-volume skill

What this skill tells your AI

The instructions your AI receives, as published by leionion/clawforge in skills/02-Device/mac_volume/SKILL.md and read by ahel’s review.

Reads the current system volume or sets it to a specific level (0–100) using osascript.

Usage

# Check current volume
python3 mac_volume.py

# Set volume to 50%
python3 mac_volume.py 50

# Mute (set to 0)
python3 mac_volume.py 0

# Max volume
python3 mac_volume.py 100

How it works

  • Read: runs osascript -e "output volume of (get volume settings)" to get current level
  • Write: runs osascript -e "set volume output volume <level>" to set the level
  • Accepts integer values from 0 to 100

Signals

GitHub stars
91
Forks
21
Last commit
May 2026
Advanced
Item type
skill
Key
mac-volume
Source
github.com/leionion/clawforge