TRACES.md

A plain-text, append-only format and tiny CLI for recording what an AI agent did

Python📄 MIT⭐ …
Screenshot of TRACES.md

TRACES.md is an open format for recording what AI agents did: one append-only file per task, one line per operation with its tool, action and result, failures included. The traces CLI (Python 3.9+, standard library only) can run a command and record its real exit code, append steps, validate a trace and print stats. The validator exits non-zero when a step marked ok carries a non-zero exit code; I ran it and it reported error E040 on such a trace. I maintain it, and this submission was prepared with AI assistance. It is version 0.1, so expect changes.