Mallik Cheripally
All open source

session-steward

A local session manager for Codex and Claude Code. Review, understand, and clean up sessions safely, without anything leaving the machine.

For anyone running Codex or Claude Code locally, day after day.

npm install --global session-steward
GitHubnpm

Why it exists

AI coding tools can accumulate hundreds or thousands of local sessions. A single session leaves behind transcripts, history, logs, checkpoints and linked artifacts, scattered across several stores, so cleaning up by hand reliably misses related data.

Everything happens on your own machine, and nothing is removed without being shown to you first.

Three ways to use it

  • Browser

    Default

    Opens locally and runs on your own machine: session counts, storage used, timelines and token breakdowns.

  • Terminal

    CLI

    An interactive terminal interface, with JSON listing for scripting and either provider selectable.

  • MCP

    ChatGPT · Claude

    Drive the same review-and-cleanup flow from ChatGPT or Claude, without installing another package.

What you can do with it

  • See what is there

    Session counts and the storage used, across both Codex and Claude Code.

  • Find what is stale

    Sessions inactive for 30, 60 or 90 days, filtered by workspace, name or ID.

  • Read a session back

    A timeline of what was asked, what changed and which commands ran.

  • See what it cost

    Token usage per session, split into fresh input, cached input, cache writes and output.

What it leaves alone

The boundary is explicit, and the tool errs toward leaving things where they are.

  • Sign-in data and saved API credentials
  • Configuration, plugins, caches and custom prompts
  • Project files, Git repositories and worktrees
  • Conversations stored in your ChatGPT or Claude account
  • Anything outside the reviewed cleanup plan