36 lines
1.3 KiB
Markdown
36 lines
1.3 KiB
Markdown
---
|
|
description: macOS system health audit and optimization (packages, environment, security, cleanup, resources)
|
|
---
|
|
|
|
# Mac Optimizer
|
|
|
|
Run macOS system health audits and apply optimizations with user consent.
|
|
|
|
## Module Routing
|
|
|
|
| Keywords | Sub-command |
|
|
|----------|-------------|
|
|
| brew, npm, pip, packages, update, outdated | `/mac-packages` |
|
|
| path, shell, zshrc, environment, env vars | `/mac-environment` |
|
|
| security, firewall, sip, gatekeeper, filevault | `/mac-security` |
|
|
| cache, cleanup, logs, disk space, trash | `/mac-cleanup` |
|
|
| cpu, memory, disk, battery, processes, slow | `/mac-resources` |
|
|
| doctor, full check, health, everything | `/mac-doctor` (runs all 5) |
|
|
|
|
Default to **/mac-doctor** when the request is ambiguous.
|
|
|
|
## Workflow
|
|
|
|
1. **Audit** — run read-only scripts, collect JSON findings
|
|
2. **Report** — present findings grouped by severity (critical → warning → info)
|
|
3. **Consent** — ask which actions to perform
|
|
4. **Execute** — dry-run first, then apply approved actions only
|
|
|
|
## Safety Rules
|
|
|
|
- Never execute cleanup without explicit user approval
|
|
- Always show sizes before deleting anything
|
|
- No sudo by default — ask first if needed
|
|
- Security module is read-only (findings + guidance only)
|
|
- Back up shell configs before modifying
|