gandalf diff: compare two snapshots - Gandalf

gandalf diff compares two snapshots and reports what changed. Output separates semantic changes (typed entities such as MCP server entries) from raw source changes (file-level additions and removals). Use the special current ref to compare against live state without persisting a new snapshot.

Synopsis

gandalf diff <baseline> <target> [flags]

Both <baseline> and <target> are snapshot names, or the special ref current.

Flags

Flag	Description	Default
`-p`, `--project`	Project directory	`.`
`--home`	Home directory	`$HOME`
`--store`	Gandalf store directory	`~/.gandalf` or `$GANDALF_STORE`
`--agent`	Filter by agent (`codex`, `claude-code`)	(unfiltered)
`--scope`	Filter by scope (`user`, `project`, `managed`, `unknown`)	(unfiltered)
`--json`	Emit JSON output	off

Examples

gandalf diff baseline current --agent codex --scope user --project .

gandalf diff baseline-claude current --agent claude-code --scope user --project .

gandalf diff baseline current --agent codex --scope user --project . --json

Output shape

The text output has two sections:

Semantic changes: severity-labeled entries with a code and entity name.
Raw source changes: file status and source path per entry.

Use --json for the machine-readable graph diff.

⌘I