GitHub - 0xroylee/ponytrail

Every change, on the trail. Ponytrail is a small CLI and bundled agent skill for recording why files changed, showing those changes as a local history tree, and reverting files from a previous snapshot. It keeps the trail in .pony-trail/ inside your project. Treat that folder as local runtime state; it should stay out of git. Install The Skill Install the bundled pony-trail skill into your local agent tools: npx ponytrail skills install pony-trail With Bun: bunx ponytrail skills install pony-trail The installer records a local skill-install snapshot before writing agent skill files, so the install can be found later in ponytrail history --details. View History Show the snapshot tree: npx ponytrail history Include action, summary, checks, result, and rollback details: npx ponytrail history --details Effect preview: Snapshot history * ponytrail-skills * skill-install-20260622064256Z-99fa03fd (pre/post) action: install skill summary: Installed pony-trail skill for claude, copilot, codex checks: ponytrail skills install pony-trail --home . --agents claude, copilot, codex result: claude:installed, copilot:installed, codex:installed rollback: Remove or reinstall the affected agent skill folders, then record another snapshot.

Filter to one session or print machine-readable output: npx ponytrail history --session <session-id> npx ponytrail history --json Snapshots are read from: .pony-trail/ snapshots.jsonl sessions/<session-id>/tree.md

Revert A Snapshot Preview the planned file actions: npx ponytrail revert <snapshot-id> --dry-run Apply the revert: npx ponytrail revert <snapshot-id> Ponytrail prints the planned file actions and asks for approval before changing files. In non-interactive environments, it prints the plan and cancels without mutating the project. Revert restores files from the snapshot's pre state. If a file did not exist before the snapshot, Ponytrail deletes it during the revert.

Local Development bun install bun run build bun test bun run check