For agents

Let your agents check first

Stillwater gives coding agents two ways to see your Mac before they start something heavy. Both only read; neither lets an agent quit a process or delete a file.

The check before heavy work

In Stillwater, open Settings › Agents › Check before test runs and model loads and click Add next to Claude Code or Codex. Stillwater adds one hook to ~/.claude/settings.json or ~/.codex/hooks.json, keeps your other hooks as they are, and saves a backup of the file. Codex asks you to trust the hook the next time it starts.

Right before the agent runs a shell command, the hook looks at it. A browser test run (Playwright, Cypress, WebdriverIO, TestCafe or Vitest's browser mode, directly or through npm test and other package scripts) or a model load (ollama run, llama-server -m model.gguf, mlx_lm.generate --model …) is checked against the Mac right now. Only when the Mac should wait does Stillwater stop that one command and tell the agent why:

Room, but not for 6 workers at once: Codex in field-notes is running 3 browsers (648.5 MB).
Run fewer, or check again in 30 seconds.

It stops a run for another suite running, memory pressure, a disk nearly full, the project's own past runs not fitting, or a model too large to load now. It never stops one for busy cores alone or for a reading it doesn't have. A session is stopped at most once every 15 minutes, so running the command again goes ahead. Every other command passes untouched, and no permission changes. What it stopped is listed in the Agents detail.

The MCP server

stillwater mcp is a Model Context Protocol server inside the app. Settings › Agents shows the setup for each agent; for Claude Code it is one command:

claude mcp add --scope user stillwater -- /Applications/Stillwater.app/Contents/Helpers/stillwater mcp
ToolWhat it answers
check_workloadBefore a parallel browser test run (browser_tests with a worker count) or loading a model (local_model with its size): proceed, reduce, defer or unknown, the observations behind it with when each was made, and when to check again. A missing reading is "unknown", never "go ahead".
mac_statusHow the Mac is doing and whether there is room for heavy work.
agentsThe other agent sessions and local models sharing the Mac. Agents see each session's folder name, never full paths or session titles.
top_processesThe busiest processes.
ai_storageWhat fills the disk: models, the Hugging Face cache, agents' data.

Settings › Agents also has a short instruction to paste into CLAUDE.md, AGENTS.md or GEMINI.md, so the agent remembers to call check_workload.

Let Codex say when it needs you

Claude Code reports when it is waiting for you on its own. For Codex, Settings › Agents › Add to Codex adds a small hook that records only whether Codex is waiting, working or idle, so the menu bar mark works for Codex too.

The command line

/Applications/Stillwater.app/Contents/Helpers/stillwater get       # one reading
/Applications/Stillwater.app/Contents/Helpers/stillwater agents    # agent sessions
/Applications/Stillwater.app/Contents/Helpers/stillwater storage   # what fills the disk

Each command also takes --json.