I built Ponytrail, a local audit trail for AI coding-agent edits

Notifications You must be signed in to change notification settings

Fork 1

Star 104

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

13 Commits

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

Repository files navigation

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 npx ponytrail history --json

Snapshots are read from:

.pony-trail/ snapshots.jsonl sessions//tree.md

Revert A Snapshot

Preview the planned file actions:

npx ponytrail revert --dry-run

Apply the revert:

npx ponytrail revert

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

About

devos.ing

Resources

Readme

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

104 stars

Watchers

0 watching

Forks

1 fork

Report repository

Releases 1

v0.0.1-beta.0

Latest

Jun 22, 2026

Packages 0

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 90.7%

Shell 6.2%

Python 3.1%