gandalf timeline: list and undo local history

gandalf timeline inspects the local history of Gandalf operations. It has three subcommands: list, show, and undo. Timeline undo builds a plan but never writes; it always requires --dry-run.

Synopsis

gandalf timeline list [flags]
gandalf timeline show <reference> [flags]
gandalf timeline undo <reference> --dry-run [flags]

<reference> is a timeline id or a snapshot name.

Common flags

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

timeline list

Prints entries as - <id> <title> (<kind>) -> <after-snapshot>. Add --json for a JSON array.

gandalf timeline list --project .
gandalf timeline list --json

Corrupt timeline events are skipped and reported on stderr.

timeline show

Prints one entry as pretty JSON.

gandalf timeline show <id> --project .
gandalf timeline show baseline --json

timeline undo

Builds a dry-run undo plan for a timeline entry. Requires --dry-run.

gandalf timeline undo <id> --dry-run --project . --json

Timeline undo is always non-writing (writesFiles=false). To roll back an applied restore, use gandalf restore --apply --experimental against the pre-apply safety snapshot.

Overview

Commands

gandalf timeline: list and undo local history

Synopsis

Common flags

timeline list

timeline show

timeline undo

​Synopsis

​Common flags

​timeline list

​timeline show

​timeline undo

​Related

Synopsis

Common flags

timeline list

timeline show

timeline undo

Related