# Capture CLI

> Change or debug the diffuse-dev CLI (capture, inspect, diff, validate, fixtures, privacy). Use when adding a command or the CLI disagrees with the apps.

- Skill: `hoangsonww/capture-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hoangsonww/capture-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hoangsonww/capture-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hoangsonww (https://skillmd.com/u/hoangsonww)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hoangsonww/capture-cli

---


# capture-cli

```bash
swift run diffuse-dev --help
```

The CLI is a thin client of `SnapshotService`, `ReportRenderer`, `SnapshotValidator`, and `PrivacyLedger`. If a command needs new behaviour, add it to the domain package first, then expose it.

- Do not parse snapshot JSON by hand in a command.
- `--now` / injected `FixedTimeSource` keep fixtures reproducible.
- Validate uses `SnapshotValidator`; do not duplicate rules.
- Exit non-zero on validation problems.

Source: `Tools/diffuse-dev/Sources/diffuse-dev`. Nested `Tools/AGENTS.md`.