Ferretlog — Git skill for Claude Code
git log for your Claude Code agent runs 🐾.
How to install Ferretlog
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open eitanlebras/ferretlog and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Ferretlog does
git log for your Claude Code agent runs 🐾.
Alternatives in Git
- 使用 Git Worktrees — 创建孤立的 Git worktrees，带有智能目录选择与安全验证 115.1k ★
- Git Worktree Docs Issue: Dependency Installation — GitHub — Community feedback on official docs with full worktree lifecycle walkthrough 81.1k ★
- Git Worktree Setup — Create isolated git worktrees with instant feedback and background Rust verification 25.5k ★
README
ferretlog 🐾
**`git log` for your Claude Code agent runs.**
Your agent ran for 11 minutes. What did it actually *do*? Right now: scroll. Forever.
$ ferretlog
a3f2b1c9 2026-04-08 09:12 fix the authentication bug [main]
7 calls 2 files 3m56s claude-opus-4-6 2,841 tok ~$0.063
9c1b2d3e 2026-04-07 14:33 add rate limiting to API [main]
9 calls 4 files 6m55s claude-opus-4-6 3,102 tok ~$0.071
e4f5a6b7 2026-04-06 11:02 refactor the database layer [main]
10 calls 4 files 11m13s claude-opus-4-6 4,218 tok ~$0.094`ferretlog` reads the session logs Claude Code already writes to `~/.claude/projects/` and gives you a proper CLI for your agent history. Zero config. Zero deps. Pure stdlib Python. Works on every session you've *ever* run — retroactively.
Install
pip install ferretlogNo API keys. No daemon. No database. Just install and run.
Commands
ferretlog # recent runs, git log style
ferretlog show # full tool-by-tool breakdown
ferretlog diff # side-by-side comparison of two runs
ferretlog stats # aggregate cost, tokens, time across all sessions`show` — replay any run
$ ferretlog show a3f2b1c9
run a3f2b1c9
task fix the authentication bug
date 2026-04-08 09:12
duration 3m56s
model claude-opus-4-6
branch main
tokens in=1,204 out=1,637 cache=84,331 ~$0.0634
files touched:
M src/auth.py
M tests/test_auth.py
tool calls:
00 read src/auth.py
01 read tests/test_auth.py
02 bash $ pytest tests/test_auth.py -x
03 edit src/auth.py
04 bash $ pytest tests/test_auth.py -x
05 edit tests/test_auth.py
06 bash $ pytest tests/ --tb=short`diff` — why did the same prompt go differently?
$ ferretlog diff a3f2b1c9 9c1b2d3e
a3f2b1c9 fix the auth bug │ 9c1b2d3e fixRelated Skills
Init Project Docs
在目前的 git repo 建立 docs/owner/STATE.md 與帳本 log 骨架、加入本地 exclude，並把帳本生命週期指針寫入 repo CLAUDE.md
Parallel Agent Worktree Skill
Portable Agent Skill to plan, spawn, review, and merge parallel CLI agents in isolated git worktrees, with det
Git Context
!git status --short !git branch --show-current !git log -3 --oneline !git diff --stat --- Based on the changes
Git Forensics
You are a git history analyst. Use ONLY git commands to analyze the repository history. Do not read file conte
Think Tools
allowed-tools: Read, Glob, Grep, LS, Bash(python3:), Bash(find:), Bash(git log:), Bash(git diff:)
Daily Standup
Generate a daily standup update. Summarizes yesterday's work from git log, states today's plan, and flags bloc
Related Agents
Flow Git
Use this agent for git operations — atomic commits, rebase, history cleanup, and style detection. Flow detects
Changelog Drafter
Reads git log since last tag, drafts CHANGELOG entry. Groups commits by conventional-commit type, rewrites for
DevOps Triage
Triages a production error alert (service name, error sample, optional deploy sha) into a bounded root-cause v
