When to reach for it
Use it to find recent local agent work or compose session metadata with other command-line tools.
How it works
It reads local session metadata, normalizes both providers into a shared shape, and applies the requested limit after combining them. Provider failures produce a nonzero exit rather than a misleading partial result.
Trace this to the source ↗Where its responsibility ends
It does not modify history, build an index, or parse complete transcripts. Listing a session does not bind it to a task.
Setup & first use
Install a release wheel or the source checkout with Python 3.11 or newer. The README’s first command is agent-sessions list.
Open the owner’s instructions ↗Exact files & reviewed version
This explanation follows the recorded source snapshot reviewed on 17 September 2026.
e49694a3ada59bccbe32dad8a4221bf1f1cc313a ↗
Public repository.