kargnas

Mac Optimizing Looper — Development skill for Claude Code

Development community

A menu-bar macOS agent loop: every N minutes it asks Claude/Codex what's overloading your Mac and suggests one-click, risk-checked fixes.

How to install Mac Optimizing Looper

This entry records only its repository, not the path inside it, so there is no exact command to give. Open kargnas/mac-optimizing-looper and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Mac Optimizing Looper does

A menu-bar macOS agent loop: every N minutes it asks Claude/Codex what's overloading your Mac and suggests one-click, risk-checked fixes.

Alternatives in Development

  • Claude Code Guide — A full guide on Claude tips and tricks, optimizing Claude Code, and finding every command possible 3.7k ★
  • Openclaw Workspace — Claude Code skill for maintaining and optimizing OpenClaw workspace files (AGENTS.md, SOUL.md, TOOLS.md, MEMOR 267 ★
  • Device Control Agent — You are an autonomous macOS agent with full control of this device via two CLI tools: - steer — GUI automation 250 ★

README

🔥 Your Mac is slow. AI Agent finds the culprit.

**English** · [한국어](README-ko.md) · [简体中文](README-zh-Hans.md) · [繁體中文](README-zh-Hant.md) · [日本語](README-ja.md) · [Español](README-es.md) · [Deutsch](README-de.md) · [Français](README-fr.md) · [Português](README-pt-BR.md) · [Русский](README-ru.md)

![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg) ![macOS 13+](https://img.shields.io/badge/macOS-13%2B-black?logo=apple) ![SwiftPM](https://img.shields.io/badge/SwiftPM-compatible-F05138?logo=swift&logoColor=white) ![Menu bar app](https://img.shields.io/badge/menu--bar-no%20Dock%20icon-success)

**Your Mac chokes → Claude names the exact process eating it → one click kills it. Nothing happens until you click — so there's no risk to your Mac.**

Every hour, your Mac's load goes to Claude. It ranks what's *actually* hogging your CPU/RAM, writes the exact fix, and drops it in your menu bar — worst-first, color-coded, one click away. And before anything runs, a *second* Claude pass has to clear the command as **SAFE**.

**Mac Optimizing Looper** is a macOS menu-bar app (no Dock icon) that runs a continuous **observe → ask the model → advise → (optionally) act** loop on top of your local LLM CLI.

[**⬇ Install**](#install) · [**See it work ↓**](#how-it-works)

Mac Optimizing Looper menu — ranked, severity-colored fixes

Activity Monitor shows you 200 rows and zero answers. This shows you the **one command** that fixes it — and why.

How it works

One cycle:

⏱  timer fires (default: every 1h, slider 10m … 36h)
→  collect: CPU/MEM + mac-optimizer snapshot (+ optional sustained sample)
→  claude -p   (analysis pass, --effort max)
→  claude -p   (format pass → ranked JSON suggestions)

The menu bar shows the count. The dropdown is ranked **worst-first**: 🔴 critical → 🟡 warning → 🟢 hygiene. Each row expands into **Copy** · **Show in Terminal** · **Review with Claude** · **Run Comma