MasterFabric Mac CLI

Experimental open-source software. Not affiliated with Slack, Telegram, Apple, or any third-party service. Sensors and configs stay on your Mac. By using this tool you accept responsibility for how you run it, what credentials you store, and any effects on your machine or connected accounts.

MacBook system monitor with a first-class MCP server — so Cursor, Claude, and any agent can read CPU/GPU temps, fans, battery, and more on your machine.

Repo: github.com/masterfabric/masterfabric-mac-cli

Native Swift · Apple Silicon first · No telemetry · AGPL-3.0

Temps, fans, storage, and allocatable RAM stay on this Mac. The menu bar, the mf CLI, and a local MCP server read the same sensors. Nothing is uploaded.

The project is licensed under GNU AGPL-3.0. The menu bar draws meters for heat, load, fans, storage, and memory, plus a one-hour chart. Make N GB asks before it quits apps. mf update installs a published tag and reopens the menu bar.

Storage shows how full the startup volume is.

The menu bar dropdown lists the volume name, a fill bar, and used / total / free space. The bar turns amber from 75% and red from 90%. Settings → Storage also puts Disk 72% on the status strip.

mf disk
mf disk --json

menubar.panel_disk defaults to on. menubar.show_disk defaults to off.

RAM room shows how many bytes a new model can still allocate, then frees that space one app at a time.

macOS “free” memory is not the same number a model can take. Room uses os_proc_available_memory: cached memory macOS can reclaim counts; wired and compressed memory does not. The menu bar draws that number live for 60 seconds, with your target as a dashed line.

Make room sends a normal quit (SIGTERM), one process at a time, and skips anything under 64 MB. It leaves these running:

• Cursor itself
• Model runtimes (Ollama, llama.cpp, LM Studio, MLX, vLLM, GPT4All)
• System processes, Tailscale, and this menu bar

You can still quit a model runtime or Cursor from a single Free row. mf memory free --force sends SIGKILL and is CLI-only. A quit can discard unsaved work in that app if the app does not save on exit.

mf memory room
mf memory room --limit 10 --json
mf config set menubar.model_room_target_gb 16
mf memory make
mf memory free --pid 1234
mf memory free --pid 1234 --force

Process sampling also no longer stalls when ps fills its error pipe, so top processes and RAM room stay responsive on a busy Mac.

MasterFabric speaks Model Context Protocol out of the box. Point Cursor or Claude Desktop at one binary:

mf mcp

Cursor — add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "masterfabric": {
      "command": "/Users/YOU/.local/bin/mf",
      "args": ["mcp"]
    }
  }
}

Copy-paste starter: examples/mcp.json

Resource: masterfabric://status — live JSON snapshot.

Your sensors never leave the Mac. MCP is local stdio only — no cloud relay.

One-liner:

curl -fsSL https://raw.githubusercontent.com/masterfabric/masterfabric-mac-cli/main/scripts/install.sh | bash

From source:

git clone https://github.com/masterfabric/masterfabric-mac-cli.git
cd masterfabric-mac-cli
make install
export PATH="$HOME/.local/bin:$PATH"

Verify:

mf --version
mf status
mf menubar

Requires macOS 13+ and Swift (Xcode or CLT). Apple Silicon recommended.

Homebrew formula (tap after tagging a release): Formula/masterfabric.rb

Live status item. Click it for meters, storage, RAM, Fan Auto/Full, and Settings (gear next to Quit). Alerts and integrations live in Settings.

Open the panel → gear next to Quit. Choose a status style and toggle what appears in the strip and dropdown.

mf menubar          # launch
mf login enable     # start at login

App bundle: ~/.local/MasterFabricMenuBar.app (no Dock icon).

• Fan control — Auto / Full for CPU + GPU fans (one-time admin helper install)
• RAM room — memory-chip button, or the Memory row. Allocatable bytes, a 60-second graph, and a Make N GB target. See What's new in 0.4.16.
• Storage — startup volume fill bar (used percent, used of total, free). Settings → Storage also puts Disk 72% on the status strip (menubar.show_disk, menubar.panel_disk). See What's new in 0.4.17.
• Settings — gear next to Quit; saved under [menubar] in config.toml
• Local notifications — Settings → Notifications (top): off by default; turning On asks macOS for permission; Test notification sends a sample banner (alerts.notify_local)
• Alerts — tap thermometer / GPU / fan / memory / disk / battery / power icons to edit thresholds; optional Send to Integrations
• Integrations — Slack · Telegram · Mail with on/off toggles, Edit, and circle brand badges (configure without the terminal via +)

Scriptable metrics with --json. Example session (status, fan helper, Auto/Full):

mf status
mf cpu
mf memory
mf memory room
mf memory make
mf notify status
mf bot --help
mf about

mf status | temp | fan | fan auto | fan full | info

Fan control (mf fan auto / mf fan full) writes SMC keys and usually needs elevation:

# Recommended (menu bar / one-time admin helper):
mf fan helper install          # password once
mf fan full --elevate
mf fan auto --elevate

# Or classic sudo each time:
sudo mf fan full
sudo mf fan auto

Menu Bar Auto / Full installs a root helper the first time (one password), then switches without prompting again.

mf battery | memory | memory room | memory make | memory free --pid <PID> [--force] | disk | network | cpu
mf power | top | history | watch
mf check [--notify]
mf notify status | test | send --channel slack "hello"
mf bot telegram
mf version [--check] [--json]
mf update [--force] [--json]
mf config show | init | set <key> <value>
mf login enable | disable | status
mf about [--lang en|tr]
mf menubar
mf mcp

All read commands support --json.

Optional notification channels you configure yourself. MasterFabric is not an official product of these services.

Slack            Telegram          Mail

	Channel	What you provide
	Slack	Incoming webhook URL
	Telegram	Bot token + numeric chat id
	Mail	resend / mailgun API key, or smtp

Push alerts (or any message) to chat/email from the CLI, menu bar, or MCP. Tokens stay in ~/.config/masterfabric/config.toml — never commit them.

mf config init
mf config set integrations.slack.enabled true
mf config set integrations.slack.webhook_url "https://hooks.slack.com/services/…"

mf config set integrations.telegram.enabled true
mf config set integrations.telegram.bot_token "123:ABC"
mf config set integrations.telegram.chat_id "987654321"

mf config set integrations.mail.enabled true
mf config set integrations.mail.provider resend   # or smtp | mailgun
mf config set integrations.mail.from "alerts@example.com"
mf config set integrations.mail.to "you@example.com"
mf config set integrations.mail.api_key "re_xxx"

mf notify test --channel all
mf check --notify
mf notify send --channel slack "CPU spike on build machine"

Full sample: examples/integrations.toml

MCP tools: notify_send, notify_status.

Keep a process running on the Mac so the bot can answer questions with live metrics:

mf bot telegram

Then in Telegram:

/status
/temp
/fan
/battery
how's the fan?
cpu load?

Only the configured numeric chat_id is allowed. Ctrl+C stops the listener.

Single source of truth: root VERSION (synced into AppVersion.current on build).

mf version              # local
mf version --check      # compare to the GitHub release (masterfabric/masterfabric-mac-cli)
mf version --check --json
mf update               # install that release tag, then reopen the menu bar if it was running
mf update --force       # reinstall the current release
mf update --json        # machine-readable result

mf update clones the published tag, builds it, and installs into ~/.local. The menu bar quits before its binary is replaced, then opens again. A failure stays on screen and in ~/.local/share/masterfabric/update.log.

Exit code 2 means an update is available. Install from source:

curl -fsSL https://raw.githubusercontent.com/masterfabric/masterfabric-mac-cli/main/scripts/install.sh | bash

Bump a release: edit VERSION, run make version-sync, commit, tag vX.Y.Z.

~/.config/masterfabric/config.toml — language, poll interval, alert thresholds, launch-at-login.

mf config init
mf config set alerts.cpu_temp_celsius 88
mf config set menubar.model_room_target_gb 16

Privacy-first: readings stay on-device. No analytics, no accounts, no network calls for core monitoring.

• License: GNU AGPL-3.0 — same family as OSMEA and masterfabric_core
• Contributing: CONTRIBUTING.md · commits in commits.md
• Security: SECURITY.md · conduct: CODE_OF_CONDUCT.md
• Issues / PRs: welcome at masterfabric/masterfabric-mac-cli
• Stack: SwiftPM · IOKit/SMC · SwiftUI MenuBarExtra · MCP JSON-RPC stdio

swift build
swift run mf status
make install

GNU Affero General Public License v3.0 © MASTERFABRIC Bilişim Teknoloji A.Ş. and contributors.

You can use, modify, and share this program under AGPL-3.0. If you run a modified version as a network service, you must offer the corresponding source to its users. See LICENSE.