# macos-forensics

macos-forensics is a Claude Code skill that inspects host artefacts during incident response on Apple operating systems. It coordinates unified log traces, FSEvents records and TCC databases.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 73 repo stars
- Author: W4L33Dx
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/W4L33Dx/Cyber-Monster/tree/HEAD/blue-team/digital-forensics/macos-forensics/SKILL.md
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/macos-forensics

## What it does

The skill correlates digital evidence across disparate storage mechanisms on Apple machines. It parses unified logs stored as `tracev3` data under `/private/var/db/diagnostics/` and connects them with file system modification streams in `FSEvents`. Since `FSEvents` batches record monotonically rising IDs without discrete wall-clock timestamps, the skill binds them to flush timestamps and external references.

It inspects download paths by linking `com.apple.quarantine` attributes to `QuarantineEventsV2` via matching identifiers. The workflow handles timestamp conversions between Mac absolute time and Unix epochs. It also audits user and system TCC databases. Grants found without corresponding prompt traces in the unified log are flagged as anomalies.

On active hosts, triage requires gathering a `sysdiagnose` archive and running `log collect` before any reboot. SQLite tables must be retrieved alongside `-wal` and `-shm` sidecars, then inspected with `immutable=1`. When log coverage is missing or incomplete, the skill mandates an inconclusive telemetry gap classification instead of a clean verdict.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add W4L33Dx/Cyber-Monster --skill macos-forensics -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/macos-forensics/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/macos-forensics/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add W4L33Dx/Cyber-Monster --skill macos-forensics -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/macos-forensics/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add W4L33Dx/Cyber-Monster --skill macos-forensics -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/macos-forensics/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install W4L33Dx/Cyber-Monster blue-team/digital-forensics/macos-forensics
```

2. **Manually: put the files in place**
- File: `.github/skills/macos-forensics/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add W4L33Dx/Cyber-Monster --skill macos-forensics -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/W4L33Dx/Cyber-Monster --path blue-team/digital-forensics/macos-forensics
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/macos-forensics/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/W4L33Dx/Cyber-Monster/tree/HEAD/blue-team/digital-forensics/macos-forensics/SKILL.md

## When to use it
- reconstruct process executions using the unified log and Rosetta 2 caches
- sequence file system alterations through FSEvents identifiers
- identify suspicious privacy authorizations across system and user TCC tables
- link quarantined files to their download metadata in QuarantineEventsV2
- inspect persistence configurations across LaunchAgents and LaunchDaemons

## Example prompts
- Examine the TCC databases and flag grants that have no corresponding prompt events in the unified log.
- Reconstruct the download timeline by correlating com.apple.quarantine attributes with QuarantineEventsV2.
- Inspect launchd plists and unified log entries for evidence of unauthorized persistence.

## Similar
- [macos-security-bypass](https://affpapa.org/en/nevibecode/skills/macos-security-bypass.md) — skill · 3900 installs
- [macos-accessibility](https://affpapa.org/en/nevibecode/skills/macos-accessibility.md) — skill · 314 installs
- [macos-permissions](https://affpapa.org/en/nevibecode/skills/macos-permissions.md) — skill · 152 installs
- [memory-forensics-volatility](https://affpapa.org/en/nevibecode/skills/memory-forensics-volatility.md) — skill · 3900 installs
- [disk-forensics](https://affpapa.org/en/nevibecode/skills/disk-forensics.md) — skill · 456 installs
- [incident-response-forensics](https://affpapa.org/en/nevibecode/skills/incident-response-forensics.md) — skill · 254 installs

From the same set: [w4l33dx/cyber-monster](https://affpapa.org/en/nevibecode/by/w4l33dx/cyber-monster.md) — 61 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
