agent-history
v0.3.1
Published
Local CLI for finding and resuming AI agent sessions across local projects.
Downloads
61
Maintainers
Readme
agent-history
agent-history is a terminal CLI for finding and resuming AI agent sessions across local projects.
Install
npx agent-historyUsage
agent-history
agent-history .
agent-history ~/github/example
agent-history ls
agent-history ls .
agent-history show <id>
agent-history resume <id>What it does
- Reads local metadata from Cursor, Claude Code, and Codex session files.
- Browses sessions across all known projects or a single filtered project path.
- Searches indexed local metadata without shelling out to agent CLIs.
- Prints a native resume command for the selected session.
Notes
- Search is live in the browser once activated with
/. qexits the browser.Enterprints the selected session's resume command.
Releasing
Publishing to npm is automated via GitHub Actions when a GitHub release is published:
- Bump
versioninpackage.jsononmain. - Create a GitHub release for that tag (for example
v0.1.1). - The
Publish to npmworkflow runs tests and publishes with provenance.
Repository maintainers must configure an NPM_TOKEN secret with publish access to the agent-history package.
