プログラミング
AIコーディングエージェントの編集を記録するローカル監査証跡ツール「Ponytrail」を開発しました
I built Ponytrail, a local audit trail for AI coding-agent edits (github.com)
要約
Ponytrailは、AIコーディングエージェントによるファイル変更の理由を記録し、その変更履歴をローカルの履歴ツリーとして表示するCLIツールです。以前のスナップショットからファイルを元に戻す機能も提供し、プロジェクト内の.pony-trail/フォルダに履歴を保持します。これにより、AIが生成したコードの変更を追跡し、必要なときに簡単に以前の状態に戻せるようになります。
全文翻訳
Ponytrail すべての変更を記録します。Ponytrailは、ファイルが変更された理由を記録し、それらの変更をローカルの履歴ツリーとして表示し、以前のスナップショットからファイルを元に戻すための小さなCLIおよびバンドルされたエージェントスキルです。プロジェクト内の.pony-trail/に履歴を保持します。このフォルダはローカルのランタイム状態として扱い、Gitからは除外してください。
スキルをインストールする
バンドルされたpony-trailスキルをローカルのエージェントツールにインストールします。
```
npx ponytrail skills install pony-trail
```
Bunを使用する場合:
```
bunx ponytrail skills install pony-trail
```
インストーラーはエージェントスキルファイルを書き込む前にローカルのスキルインストールスナップショットを記録するため、インストールは後で`ponytrail history --details`で確認できます。
履歴を表示する
スナップショットツリーを表示します。
```
npx ponytrail history
```
アクション、サマリー、チェック、結果、ロールバックの詳細を含めるには:
```
npx ponytrail history --details
```
効果のプレビュー:
```
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.
```
1つのセッションにフィルタリングするか、機械可読な出力を出力します。
```
npx ponytrail history --session <session-id>
npx ponytrail history --json
```
スナップショットは以下から読み込まれます。
`.pony-trail/snapshots.jsonl`
`sessions/<session-id>/tree.md`
スナップショットを元に戻す
計画されているファイルアクションをプレビューします。
```
npx ponytrail revert <snapshot-id> --dry-run
```
元に戻す操作を適用します。
```
npx ponytrail revert <snapshot-id>
```
Ponytrailは、ファイルを変更する前に計画されているファイルアクションを表示し、承認を求めます。非対話型環境では、計画を表示し、プロジェクトを変更せずにキャンセルします。
元に戻す操作は、スナップショットの`pre`状態からファイルを復元します。スナップショットの前にファイルが存在しなかった場合、Ponytrailは元に戻す際にそのファイルを削除します。
ローカル開発
```
bun install
bun run build
bun test
bun run check
```