Skip to main content
skill CX Codex

mac-maintenance — Claude Code skill: what it does, how to install

mac-maintenance automates macOS maintenance by upgrading Homebrew packages, pulling clean git repositories, and emptying the Trash.

MIT 117 installs ★ 7,554 updated 2026-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add steipete/agent-scripts --skill mac-maintenance -a claude-code
Open on GitHub

What mac-maintenance does

The skill runs a short macOS cleanup routine. It begins by triggering brew update && brew upgrade. Next, it scans folders under ~/Projects/*/.git, inspecting each working tree with git status --short --branch before running git pull --ff-only.

Dirty repositories remain untouched unless you specifically request handling them, and their paths are reported back. The sequence then empties the macOS Trash through an AppleScript call to Finder, closing with a brief tally of upgraded packages, touched repositories, and Trash status.

Because the git scan specifically targets ~/Projects, checkouts located elsewhere are ignored.

What it helps with

  • upgrade Homebrew formulas and casks
  • fast-forward clean git repositories under Projects
  • empty macOS Trash using Finder
  • review a concise status report of updated repositories and packages

Example prompts for the agent

  • Run mac cleanup and refresh my repos
  • Perform mac-maintenance on Homebrew and Projects
  • Run system maintenance and empty the trash

How to install mac-maintenance

1Skills CLI (Vercel)

npx skills add steipete/agent-scripts --skill mac-maintenance -a claude-code

2Manually: put the files in place

~/.claude/skills/mac-maintenance/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mac-maintenance/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about mac-maintenance

How to install mac-maintenance in Claude Code?

Run npx skills add steipete/agent-scripts --skill mac-maintenance -a claude-code in your terminal.

What does mac-maintenance do?

It upgrades Homebrew packages, runs fast-forward git pulls across clean repos in ~/Projects, and empties the macOS Trash.

How does the skill handle dirty git repositories?

It skips dirty trees by default, keeping your uncommitted work safe while reporting skipped directories in the final summary.

Source text

SKILL.md · MIT
---
name: mac-maintenance
description: "Mac upkeep: brew update/upgrade, pull clean repos, empty Trash."
---

# Mac Maintenance

Use when Peter asks for Mac cleanup, maintenance, or package/repo refresh.

## Run

1. Homebrew:

```bash
brew update && brew upgrade
```

2. Repos under `~/Projects`:

```bash
for repo in ~/Projects/*/.git; do
  dir=${repo:h}
  git -C "$dir" status --short --branch
  git -C "$dir" pull --ff-only
done
```

Skip dirty repos unless Peter explicitly asked to handle them. Report skipped paths.

3. Empty Trash:

```bash
osascript -e 'tell application "Finder" to empty trash'
```

4. Finish with terse counts:

- brew: upgraded / already current
- repos: pulled / skipped / failed
- trash: emptied / failed

© steipete · MIT · steipete/agent-scripts

Similar skills

All skills for Notes, tasks and projects →

From the same set20

The whole set →
ssh-doctor ssh-doctor troubleshoots macOS SSH failures, including pre-auth disconnections, stale sshd sessions, and Remote Login misconfigurations. CX Codex +1 239installs domain-dns-ops The domain-dns-ops skill guides domain, Cloudflare zone, and redirect work. Use it when setting up a domain and checking DNS or HTTPS behavior. CX Codex +1 192installs discord-clawd discord-clawd — a skill to send questions to a Discord-backed agent via OpenClaw relay. Not for archive search—use it to communicate directly with a live session. CX Codex +1 122installs openclaw-relay openclaw-relay is a Claude Code skill that routes prompts and messages to OpenClaw sessions via local acpx or SSH, resolving targets from named aliases in config/session_aliases.json. CX Codex +1 120installs cloudflare-registrar A skill to check domain availability in Cloudflare Registrar, retrieve pricing, and register domains from your code editor. Use it when you register domains regularly and want to skip the dashboard. CX Codex +1 108installs codex-debugging codex-debugging guides debugging across the codex-rs repository. Essential when investigating runtime bugs, CLI behavior, or config parsing issues. CX Codex +1 108installs github-project-triage The github-project-triage Claude Code skill reviews open GitHub issues and pull requests when prompted with “triage.” It surfaces blockers, checks, risks, and a next action for each item. CX Codex +1 105installs obsidian A skill for Claude Code searches, reads, and edits local Obsidian vaults. It handles requests involving notes, backlinks, Bases, and Canvas. CX Codex +1 104installs

Project sponsors

Companies that keep this analytics open