Horef Pulse · Support
Help & support
Horef Pulse tells AI agents how loaded your Mac is, so they pace builds, tests and sub-agents. Эта страница по-русски. Step by step with screenshots: user guide (по-русски, בעברית).
How it works
- Menu bar — four screens you flip with arrows: Load, System, Apps and Log. Load shows CPU, memory pressure, swap, disk and temperature as bars, charts of the last 10 minutes or round dials with a needle, your choice, and under them the three heaviest apps with a Quit button; a health score from 0 to 100 that says what took points off; what AI agents are running right now, with a Stop button; processes that have kept a core busy for minutes. The menu bar itself can show CPU, memory, temperature, free disk space, network speed, power draw and the health score — pick any of them under Menu Bar, together in one item or each as its own, with traffic as numbers or moving bars.
- Free up space — Xcode, simulator, Swift, npm, pip, Homebrew and other developer caches, simulators of removed iOS versions, old installers and build folders of projects you have not touched for a week, each with its size and what happens after removing it. Only your click removes anything; an AI can only ask, and its request opens the same window with its picks checked.
- What takes the space — on the Mac's disk or any attached drive: the biggest folders and files, what grew lately, and what can simply go, what is yours to decide and what must never be deleted by hand, each with the proper way to free it. When the disk runs low, a panel shows what took the space lately. Free up space also finds old temporary files, logs, unfinished downloads and old versions of programs.
- Uninstall apps — your apps by size and last use; pick one and Horef Pulse moves it to the Trash together with the settings, caches and data it left in your Library, or deletes it at once if you tick that, quitting it first if it is open — by force if it hangs. Files other apps share are left alone. An AI can only ask.
- Updates — which of your apps have a newer version: Mac App Store apps, apps that update themselves (Sparkle) and Horef Pulse itself, which installs its own update from horef.app after checking its hash, signature and Apple notarization. Every window is one click away under Services.
- System information — CPU and GPU temperature, GPU load, power draw in watts, battery health and cycles, every network connection with its speed (Wi-Fi standard, band and signal), network and disk traffic. AI agents get the same data.
- Terminal — Horef Pulse’s own terminal, with iTerm2-style panes, profiles and colour schemes, shell integration for zsh and bash (jump between commands, copy a command’s output, a notification when a long command ends), triggers and a hotkey window. Sessions keep running when you close the window or quit the app, and open again with what they showed.
- iPhone access — the iPhone app (now in testing, coming to the App Store) shows the load, quits apps, stops what AI agents started, frees up space, uninstalls apps, checks for updates and works in the terminal sessions, at home and away, end-to-end encrypted. Off until you turn it on and pair your iPhone by a QR code. Other Macs with Horef Pulse can watch this Mac’s load in My Macs, one at a time or all side by side.
- Desktop widgets — small, medium and large: load, health, CPU, memory, temperature, disks, heaviest apps and network.
- Fan control (beta) — on Macs with fans: Auto, Boost or Maximum. A small helper, which you allow once in Login Items, sets the speed; it never goes below the fan’s minimum and returns the fans to Auto when Horef Pulse quits or stops answering, when the Mac gets hot, and after a restart. AI agents can read the fans but not change them.
- For AI agents — an MCP server for Claude Code, Claude Desktop, Cursor, Codex and any other MCP client. Tools:
system_status,wait_for_capacity,kill_ai_process,suggest_quit_apps,disk_report,cleanup_preview,suggest_cleanup,suggest_uninstall,disk_usage,action_historyand more. - User guide — with screenshots, here on the site and inside the app (the ? button in the menu), so it works offline.
- Claude Code — one click registers the MCP server and a hook that reminds the model before builds and sub-agents when the Mac is busy. It stays silent while the Mac is fine.
- Command line —
hofpulse wait && make -j$(hofpulse threads)in your own scripts;hofpulse watchstreams the load as JSON lines,hofpulse historyshows what was stopped, quit and cleaned.
Who may stop what
- Processes an AI agent started (builds, tests, dev servers): the agent may stop its own and orphaned ones — never another live session’s work.
- Your apps: the agent can only ask. A panel shows its reason and you decide app by app; apps quit normally and ask about unsaved documents.
- AI tools, MCP servers and macOS: never touched.
- Files: an AI never deletes anything. It can see what could be cleaned or uninstalled and ask; you choose in the Free up space and Uninstall windows.
- Every stop, cleanup and answer is logged in the menu.
How do I connect Claude Code?
Open Horef Pulse from the menu bar and click Connect. It links the hofpulse command to ~/.local/bin, runs claude mcp add for all your projects, adds the hook to ~/.claude/settings.json and, if Claude Desktop is installed, adds the server to its config. Each file is backed up first (.bak-hofpulse). Start a new Claude Code session to get the tools.
Other AI tools
Any MCP client works: add a stdio server with the command ~/.local/bin/hofpulse and the argument mcp. Agents without MCP can call hofpulse status, hofpulse jobs or hofpulse wait in a shell.
What does the AI get?
A level (ok, busy, overloaded, critical) with reasons, how many heavy jobs can run at once, how many build threads to use, and plain advice. It also gets the heaviest processes, which of them the AI started, and which belong to you.
Why “overloaded” while the CPU is not full?
Memory pressure, swapping, heat and a long queue of waiting processes slow a Mac down as much as a busy CPU. A hung iOS Simulator is a common cause: its processes get stuck and the whole Mac stalls. Horef Pulse notices this and tells the agent not to start simulators.
Quit proposals
When an AI asks, or the Mac stays overloaded for 30 seconds, a small panel lists the heaviest apps that are not AI tools. Choose Quit or Keep for each, or Not now. Apps you keep are not proposed again for an hour.
What does Free up space remove?
Only data that rebuilds itself or downloads again: developer caches, DerivedData, simulators of removed iOS versions, node_modules and .build folders of projects untouched for 7 days. Old installers (.dmg, .pkg) go to the Trash. Large items that take long to get back, such as device symbols and downloaded AI models, are listed but not checked. Horef Pulse looks in Downloads, Desktop and Documents only after you click Also search Downloads, Desktop and Documents; macOS then asks you for access.
Fan control is beta
MacBook Air has no fan, so the menu shows passive cooling and no controls. On a MacBook Pro, Mac mini or Mac Studio, click Enable fan control (beta) and allow Horef Pulse in System Settings → General → Login Items. It is beta because it writes to the Mac’s system management controller (SMC) the same way other fan utilities do, on a limited set of Mac models so far. On any failure the fans go back to Auto. Please tell us your Mac model and what you saw.
Remove Horef Pulse
Click Disconnect in the menu, quit Horef Pulse and move it to the Trash. Its data: ~/Library/Application Support/HorefPulse. If you enabled fan control, remove Horef Pulse from Login Items too.
Contact support
Send the Horef Pulse version, your Mac model and macOS version, and what happened. The output of hofpulse status helps.
Claude is a trademark of Anthropic. Horef Pulse is an independent app, not affiliated with Anthropic or any AI vendor.