---
name: inspect-mac
description: Discover the current Mac with a read-only snapshot (hostname, OS, Homebrew, volumes). Use at the start of a session, on a new or unfamiliar machine, or when the user asks what this Mac has, which disks are mounted, or whether Homebrew is present.
license: MIT
compatibility: Requires macOS. Uses scutil, sw_vers, diskutil, df, and Homebrew if installed.
---

# Inspect this Mac

Probe the machine you are on. Do not assume hostname, Homebrew prefix, or
mounted volumes from memory or from another Mac.

## Cache (optional, local only)

The script can also write a snapshot to:

```text
$XDG_CONFIG_HOME/mac-concierge/machine.md
```

If `XDG_CONFIG_HOME` is unset, it uses:

```text
~/.config/mac-concierge/machine.md
```

The snapshot stays outside this git repository. Each Mac keeps its own file;
do not treat it as synced or shared configuration.

The file is a **hint**, not source of truth. Disks get unmounted, Homebrew
moves, hostnames differ. If the file is missing, continue. If it exists, skim
it, then rediscover before copy, unmount, format, or other mutations.

Ask before writing or overwriting the cache. Creating
`~/.config/mac-concierge/` is allowed only after confirmation.

## Steps

1. Run the bundled script from this skill directory:

   ```sh
   scripts/inspect.sh
   ```

   Read-only. Prints the snapshot to stdout.

2. Summarize what matters: computer name, OS, whether Homebrew is present,
   and which volumes are mounted. The report can contain identifying machine,
   volume, and disk details; advise the user to review and redact it before
   sharing it publicly.

3. If a local snapshot would help later sessions, ask before:

   ```sh
   scripts/inspect.sh --write-cache
   ```

4. Do not commit `machine.md`. Do not copy it to another Mac as if it were
   shared config.