agent-trace is an open-source command-line transcript utility created by ertygiq. It is designed to inspect, parse, and export execution logs from AI coding agents and harness sessions into uniform, plain-text streams. The tool operates without HTML rendering or rich terminal user interfaces, focusing purely on raw, legible text output. In daily developer workflows, agent-trace reads session transcript files generated by supported agent harnesses (such as Cursor project session logs). It unwraps structured metadata—including user queries, tool execution calls, thinking traces, and timestamps—and prints them sequentially to standard output. Because the tool operates on standard I/O, developers can pipe logs directly into command-line utilities like grep, less, or head, or pass complete execution context to another LLM for code review and auditing. What distinguishes agent-trace from terminal-based interactive agents is its focus as an observability and evaluation harness layer. Instead of generating code or managing interactive loops, it normalizes disparate agent session formats across environments without external runtime overhead. Implemented in Python using only the standard library, it avoids dependency conflicts and includes defensive stream handling such as BrokenPipeError suppression. agent-trace is free and open-source software licensed under the MIT License. It is lightweight and can be installed directly via standard Python tooling or uv.
Tags: ai agent, cli, developer tools, OpenSource, terminal