Skip to content

tracekit audit: help text and README say it reads Claude Code only #811

Closed

Description

@LoopGlitch26

tracekit audit reads three agents' sessions on main today (Claude Code, Cursor and Cline: READERS in tracekit/audit.py L274, and the "What it reads" table in docs/audit.md), and more readers are in progress (#669 Codex, #715 Gemini CLI). Two places still say it reads Claude Code's only, and one lists the agents by hand, so each new reader has to remember to edit it.

The task

  1. tracekit --help (tracekit/cli.py L457): the audit line says "Claude Code transcripts, or a calls file". Say "your coding agents' transcripts (see docs/audit.md), or a calls file", with no agent list to go stale.
  2. tracekit audit --help (tracekit/audit.py L537-540): the description lists "(Claude Code, Cursor and Cline)" by hand. Build the list from READERS, as the root argument's help below it already does, so a new reader shows up on its own.
  3. README.md L238: "reads Claude Code's sessions on this machine". Say it reads the sessions of the agents in docs/audit.md's readers table.
  4. docs/support.md L33 lists "Claude Code's and Cursor's transcripts and Cline's tasks". Make it "the transcripts of the agents in audit's readers table".

Done when

  • A test in tests/test_audit.py checks that tracekit audit --help names every key of READERS (it fails if someone adds a reader and the help lists agents by hand again).
  • tracekit --help and tracekit audit --help read correctly in a terminal (paste both in the PR).
  • tests/test_docs.py and tests/test_eval_docs.py still pass.

Commits need a DCO sign-off (git commit -s).

Activity

  1. hayatexe commented on Nov 13, 2026

    @hayatexe
    Contributor

    I'd like to take this one (following up from #801). Will build the audit help's agent list from READERS and add the test.

  2. LoopGlitch26 commented on Nov 13, 2026

    @LoopGlitch26
    MemberAuthor

    It's yours, thanks. Building the list from READERS is the right source, so the help and the README can't drift from what audit actually reads. Add the test and sign off your commits (git commit -s).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions