Skip to content

v0.2.0

Choose a tag to compare

View all tags
@kelesmert kelesmert released this 04 Aug 16:10
· 51 commits to main since this release
v0.2.0
c5ac9e6

Reporting, a new commands and colour.

Breaking

--provider is removed. The agent is a positional argument.

turnlens --provider codex    # 0.1.x
turnlens codex               # 0.2.0

Naming no agent no longer means Codex. turnlens used to default to Codex
silently. It now asks which agent and lists that agent's sessions, and
turnlens report covers every agent rather than one.

Added

  • turnlens report, which counts what has already been spent across every
    session on the machine, without having watched any of them. It reads the
    agents' own transcripts, so it works whether or not TurnLens has ever run, and
    it writes nothing.
  • Four groupings, one word after report: daily (the default), weekly
    beginning Monday, monthly, and session.
  • --id, to watch or report on one session by full id or unique prefix. It
    works without an agent, because the id says which one.
  • --since and --until, inclusive, YYYY-MM-DD.
  • --json, machine-readable output carrying full model identifiers.
  • --compact, fewer columns whatever the terminal's width.
  • --no-color, alongside NO_COLOR and automatic detection of output that
    is not a terminal.
  • Colour, which only ever repeats what the text already says: headings cyan,
    rules dim, totals bold, and yellow for a turn that could not be priced and a
    turn you interrupted.
  • A summary of the turns a session had already closed, priced and printed on
    selection. They were previously invisible.
  • Codex archived sessions, now read when reporting. Watching still excludes
    them, because an archived session has ended and cannot be followed.

Fixed

  • A lock left behind by a process that is no longer running is reclaimed, and
    TurnLens says so. It previously had to be removed by hand.

Changed

  • The README is substantially rewritten, and now states that costs are
    API-equivalent rather than charges against a subscription.

Two behaviours that decide what a number means

  • A turn counts on the day you sent the prompt, not the day the answer
    finished. Otherwise the day would depend on how long the agent thought.
  • A report prices everything at today's rates. A CSV row keeps the rate of
    its own moment, so a report and a CSV can disagree on purpose.

Unchanged

Node 22 or newer, no runtime dependencies, Linux, macOS and Windows. Session
files are only ever read. Prompt previews stay off by default. The CSV schema and
its 27 columns are untouched, so files written by 0.1.1 are still appended to
rather than rejected.

TurnLens is pre-1.0, where a breaking change raises the minor version.

Full diff: v0.1.1...v0.2.0

Assets 2
Loading