mactriage

mactriage is an open-source macOS diagnostic and recovery tool built in Go for everyday users, developers, help desks, and IT teams.

Running mactriage opens a colourful, interactive troubleshooting experience that guides users through diagnosing their Mac without requiring them to understand obscure Terminal commands. Advanced users can still access conventional commands, automation-friendly JSON and NDJSON output, stable finding codes, configurable failure policies, and fleet-ready reports.

Its Doctor scans can examine overall system health, application launch failures, storage pressure, startup items, network configuration, battery condition, thermal state, backup status, security checks, crashes, dependencies, architecture compatibility, and file-descriptor exhaustion. Results are ranked by severity and confidence, with plain-language explanations, supporting evidence, and concrete next steps.

When mactriage can safely help, it presents the exact action it can perform, explains its effects and privilege requirements, asks for permission, and verifies the outcome afterward. It deliberately avoids dangerous shortcuts such as disabling Gatekeeper or SIP, rewriting signatures, deleting application data, or making undocumented system changes.

Reports are privacy-conscious and sanitised by default. Non-interactive runs never prompt or modify the system, making mactriage suitable for scripts, CI pipelines, remote support, MDM workflows, and larger Mac fleets.

In short, mactriage aims to be the first command you run when a Mac or application is behaving strangely: approachable enough for a regular Mac user, but detailed and deterministic enough for professional troubleshooting.