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 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.
Show the snapshot tree:
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
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.
bun install
bun run build
bun test
bun run check
