ferretlog 🐾

An Insightful CLI Tool for Tracking Claude Code Agent Runs

ferretlog serves as a dedicated CLI utility that provides a comprehensive overview of your Claude Code agent's activity, resembling the typical git log. Have you ever wondered what your agent did during its runs, instead of endlessly scrolling through lengthy logs? This tool offers clarity by summarizing logs into an intuitive format.

Features

• Effortless Command-Line Access:
  With ferretlog, simply use the command to retrieve recent runs in a familiar git log style:

  $ ferretlog
  

  Outputs include:

    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
  

  This ensures that users can swiftly gain insights on every session ever run, without needing extensive configurations or additional dependencies.

• Detailed Session Breakdown:
  Replay any given session with:

  $ ferretlog show <id>
  

  This command details execution sequences, including each tool called and files modified, which enhances your understanding of agent efficiency.

• Comparative Analysis:
  Discover the differences between runs by using:

  $ ferretlog diff <a> <b>
  

  This command presents a side-by-side comparison, assisting in identifying changes in behavior or performance with ease.

• Statistical Overview:
  Gain insights on your agent's performance over time:

  $ ferretlog stats
  

  Output includes metrics such as total runs, tool calls, and time spent, facilitating data-driven decision making.

How It Works

ferretlog efficiently parses session logs already produced by Claude Code, reconstructing tool call sequences and correlating each run to the closest git commit based on timestamps. It operates independently on your machine, ensuring that no data leaves the local environment, thus respecting privacy and security.

Value Proposition

As the complexity of agent-driven development grows, so does the need for visibility. ferretlog addresses this demand by turning inherently opaque logs into actionable data. By simplifying access to historical agent activity, it empowers users to make informed adjustments and ultimately enhance development workflows.

In summary, ferretlog is designed for developers seeking clarity and efficiency, transforming the way agent runs are analyzed and interpreted.