GitHub - 0xroylee/ponytrail · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
0xroylee
ponytrail
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star<br>104
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>13 Commits<br>13 Commits
.codegraph
.codegraph
.cursor/rules
.cursor/rules
.github/workflows
.github/workflows
.husky
.husky
.ponytrail
.ponytrail
assets
assets
bundled-skills/pony-trail
bundled-skills/pony-trail
docs
docs
outputs
outputs
scripts
scripts
src
src
tests
tests
.gitignore
.gitignore
AGENTS.md
AGENTS.md
README.md
README.md
biome.json
biome.json
package.json
package.json
tsconfig.json
tsconfig.json
View all files
Repository files navigation
Ponytrail
Every change, on the trail.
Ponytrail is a small CLI and bundled agent skill for recording why files changed,<br>showing those changes as a local history tree, and reverting files from a<br>previous snapshot.
It keeps the trail in .pony-trail/ inside your project. Treat that folder as<br>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<br>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<br>* ponytrail-skills<br>* skill-install-20260622064256Z-99fa03fd (pre/post)<br>action: install skill<br>summary: Installed pony-trail skill for claude, copilot, codex<br>checks: ponytrail skills install pony-trail --home . --agents claude, copilot, codex<br>result: claude:installed, copilot:installed, codex:installed<br>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 --json">npx ponytrail history --session session-id><br>npx ponytrail history --json
Snapshots are read from:
/tree.md">.pony-trail/<br>snapshots.jsonl<br>sessions//tree.md
Revert A Snapshot
Preview the planned file actions:
--dry-run">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<br>files. In non-interactive environments, it prints the plan and cancels without<br>mutating the project.
Revert restores files from the snapshot's pre state. If a file did not exist<br>before the snapshot, Ponytrail deletes it during the revert.
Local Development
bun install<br>bun run build<br>bun test<br>bun run check
About
devos.ing
Resources
Readme
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
104<br>stars
Watchers
watching
Forks
fork
Report repository
Releases
v0.0.1-beta.0
Latest
Jun 22, 2026
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
TypeScript<br>90.7%
Shell<br>6.2%
Python<br>3.1%
You can’t perform that action at this time.