Skillget

mac-stats

mcp
SUMMARY

macOS menu bar system monitor + local AI agent. Ollama chat, Discord bot, scheduler, tasks, MCP—all on your Mac. No cloud, no telemetry. CPU/GPU/RAM/disk in the bar; full agent stack when you need it. Rust + Tauri.

README.md

mac-stats

The AI agent that just gets it done. All local.

GitHub release

Rust + Tauri menu-bar app for macOS (Apple Silicon–first): live system metrics and a serious local Ollama agent in one place—tools, Discord, tasks, scheduler, and MCP—without shipping your data to a vendor backend.

mac-stats Data Poster theme

📋 Changelog · 🗺️ AI roadmap (tasks & tools) · 📸 Screenshots & themes

What mac-stats ships with

Menu bar & glass UI

  • CPU, GPU, RAM, and disk in the menu bar; open the window for temperature, CPU frequency (IOReport where available), battery, and a process list with top consumers.
  • Nine themes, collapsible sections, and a dashboard for monitors, Ollama, and more—designed to feel native on macOS.
  • Low overhead in normal use: on the order of ~0.5% CPU with the window closed, under ~1% with the CPU window open.

Local AI agent (Ollama) with a deep toolbelt

  • Chat in the app or via Discord using the same engine: multi-step tool loop, sub-agents (AGENT:), skills, memory (memory.md, MEMORY_APPEND), and session compaction so long threads stay usable.
  • Web & research: FETCH_URL (server-side fetch, SSRF-hardened, HTML cleaned before the model sees it), BRAVE_SEARCH, PERPLEXITY_SEARCH (optional API keys).
  • Browser automation (CDP): navigate, click, scroll, extract, and BROWSER_SCREENSHOT → PNG under ~/.mac-stats/screenshots/ (handy for Discord attachments).
  • Automation & coding helpers: RUN_CMD (allowlisted), RUN_JS, PYTHON_SCRIPT under ~/.mac-stats/scripts/, CURSOR_AGENT when the Cursor CLI is on PATH.
  • Integrations: DISCORD_API, MASTODON_POST, Redmine helpers, optional plugins—plus any MCP server (stdio or HTTP/SSE), e.g. Ori Mnemos.
  • Smarter routing: deterministic pre-routing for common intents (fetch URL, search, Discord API, schedules, tasks) so simple asks don’t pay an extra planning hop; context-overflow auto-recovery trims oversized tool results and retries instead of failing the whole run.
  • Quality-of-life: completion verification (did we meet the ask?), escalation / “try harder” phrases you can edit, loop guards against tool thrash, and user-facing Ollama error sanitization.

Discord, tasks, scheduler, monitoring

  • Discord bot — @mentions, DMs, per-channel modes (mention_only, all_messages, having_fun), optional draft messages that update while tools run, debouncing for rapid messages, 429 handling with backoff.
  • Tasks — markdown task files under ~/.mac-stats/task/ (TASK_CREATE, TASK_LIST, TASK_STATUS, assignees, append/show).
  • Scheduler — cron or one-shot jobs in schedules.json; Ollama-powered runs with optional Discord replies and a per-task wall-clock timeout.
  • Monitors & alerts — website checks, social (e.g. Mastodon mentions), rules and channels (Telegram, Slack, Mastodon, …); background due checks with stats persisted to disk.

Privacy & operations

  • Models and inference stay on your Mac (Ollama). Config, agents, sessions, tasks, and logs live under ~/.mac-stats/. Optional network features only run when you configure them.
  • Structured logging via tracing; tune console noise with MAC_STATS_LOG (subsystem filter). Tail ~/.mac-stats/debug.log when debugging.

Install

DMG (recommended): Download latest release → drag to Applications.

Build from source:

git clone https://github.com/raro42/mac-stats.git && cd mac-stats && ./run

Or one-liner: curl -fsSL https://raw.githubusercontent.com/raro42/mac-stats/refs/heads/main/run -o run && chmod +x run && ./run

If macOS blocks the app: Gatekeeper may show "damaged" or block the unsigned app—the file is fine. Right-click the DMG → Open, then confirm. Or after install: xattr -rd com.apple.quarantine /Applications/mac-stats.app

All local (quick reminder)

  • AI — Ollama on your Mac; models and inference stay on-device unless you point at a remote endpoint yourself.
  • Your data — Config, memory, sessions, and tasks in ~/.mac-stats. Secrets in ~/.mac-stats/.config.env or Keychain.
  • Optional network — Discord, Mastodon, FETCH_URL, Brave Search, Perplexity, website checks—only when you configure and use them.
  • Metrics — Read from your machine (temperature, frequency, process list) when the window is open; menu bar stays light when it’s closed.

No subscription. No lock-in. Works offline for chat and core monitoring. Grab a model from Ollama and you’re running locally.

Configuration

All settings live under ~/.mac-stats/:

~/.mac-stats/
├── config.json            # Window decorations, scheduler interval, ollamaChatTimeoutSecs, browserViewportWidth/Height
├── .config.env            # Secrets (Discord, Mastodon, API keys, Perplexity) — never commit ;-)
├── discord_channels.json  # Per-channel modes (mention_only, all_messages, having_fun)
├── schedules.json         # Cron and one-shot tasks
├── user-info.json         # Per-user details (Discord id → display_name, notes, timezone)
├── agents/                # LLM agents (orchestrator, coder, etc.), soul.md, memory.md
│   ├── escalation_patterns.md   # Phrases that trigger “try harder”; user-editable, auto-adds when you complain
│   ├── session_reset_phrases.md # Phrases that clear session (e.g. “new topic”, “reset”)
│   ├── prompts/           # planning_prompt.md, execution_prompt.md
│   └── skills/            # skill-<n>-<topic>.md for different agent personalities
├── task/                  # Task files (TASK_LIST, TASK_CREATE, TASK_STATUS)
├── scripts/               # PYTHON_SCRIPT output
├── session/               # Conversation sessions (compacted to memory)
├── screenshots/           # BROWSER_SCREENSHOT output
└── debug.log              # App logs (tail -f ~/.mac-stats/debug.log)

Commands

Binary name mac_stats; app shows as mac-stats. From repo root unless noted.

Command Description
mac_stats Start app (menu bar + optional CPU window)
mac_stats --cpu Start with CPU window open
mac_stats -v / -vv / -vvv Verbosity for debug.log
mac_stats discord send <channel_id> <message> Post to Discord from CLI
./run dev Development mode, hot reload (repo root)

Features

AI & agents (Ollama, local)

  • Chat — In the app window or via Discord. Code execution (JS), FETCH_URL, BRAVE_SEARCH, PERPLEXITY_SEARCH (optional; API key in env, .config.env, or Keychain/Settings), RUN_CMD (allowlisted), MASTODON_POST (toot from the agent), retry and correction.
  • Completion verification — We extract 1–3 success criteria at the start and ask “Did we satisfy the request?” at the end; if not, we append a disclaimer. Heuristic: “screenshot requested but none attached” → note. See docs/025_expectation_check_design_DONE.md.
  • Escalation / “try harder” — Edit ~/.mac-stats/agents/escalation_patterns.md; one phrase per line. When your message matches one, we run a stronger pass (+10 tool steps). New phrases you use get auto-added.
  • Memory — Global and per-agent memory.md; MEMORY_APPEND; session compaction writes lessons to memory.
  • Discord bot — Optional. @mentions, DMs, or having_fun mode (your Mac chats with other bots when bored); per-channel model/agent. Full Ollama + tools.
  • Tasks — ~/.mac-stats/task/ with TASK_LIST, TASK_CREATE, TASK_STATUS, assignees, scheduler loop.
  • Scheduler — Cron or one-shot (~/.mac-stats/schedules.json); tasks through Ollama; optional Discord reply channel.
  • MCP — Tools from any MCP server (HTTP/SSE or stdio). Ori Mnemos vault via MCP_SERVER_STDIO.
  • Agents — Multiple LLM agents under ~/.mac-stats/agents/ (orchestrator, coder, Discord expert, etc.); AGENT: delegates. Local models by role; cloud only when you configure it (design). Editable prompts in ~/.mac-stats/agents/prompts/ and soul.md in agents/.
  • cursor-agent — When the Cursor Agent CLI is on PATH, agents can delegate via CURSOR_AGENT: or RUN_CMD: cursor-agent; see docs/012_cursor_agent_tasks.md.
  • PYTHON_SCRIPT — Ollama can run Python under ~/.mac-stats/scripts/ (disable with ALLOW_PYTHON_SCRIPT=0).

UI

  • Menu bar + expandable window; status dashboard (monitors, Ollama, etc.); 9 themes. Scrollable, collapsible sections.

System monitoring (background)

  • Real-time CPU, GPU, RAM, disk in the menu bar; temperature, frequency, battery; process list with top consumers. Click for details.
  • Monitoring & alerts — Website and social monitoring (Mastodon mentions); alert rules and channels (Telegram, Slack, Mastodon, etc.).

Usage

  • Chat — Open the window (click the menu bar icon or run with --cpu) and use the AI panel. Verbosity: -v / -vv / -vvv.
  • Discord — Configure ~/.mac-stats/discord_channels.json and ensure your bot token is set; the agent responds to @mentions, DMs, or in having_fun channels (where your Mac can chill and talk to other bots). See Discord setup and channel modes for details.
  • Mastodon — Set MASTODON_INSTANCE_URL and MASTODON_ACCESS_TOKEN in env or ~/.mac-stats/.config.env; the agent can MASTODON_POST toots, and you can add Mastodon monitors (mentions) and alert channels. No X.com yet ;-) — let's see who implements it first.
  • Monitoring — Click any percentage in the menu bar to open the details window. ⌘W to hide; click again to toggle; ⌘Q to quit.

Development

Prerequisites: Rust. From repo root: ./run dev. Run cargo audit in src-tauri/ before release. Coder-agent workflow: docs/agent_workflow.md.

Inspiration & notes

Local AI agent stack first; system monitoring lives in the menu bar when you need it. Inspired by Stats by exelban (low CPU, native metrics), OpenClaw, browser-use, and Hermes by Nous Research. Built with Rust + Tauri; metrics use libproc, SMC, IOReport where appropriate.

  • Menu bar: refresh every 1–2s | Window: 1s | Process list: 15s

Contact

Questions or ideas? Discord or open an issue on GitHub.

We’d love your feedback. If you’ve tried mac-stats—or you’re thinking about it—drop a note in this discussion. What works, what doesn’t, and what you’d like to see next. It all helps.

MIT License

Reviews (0)

No results found