Skip to content
Agentmart
Submit a tool

Session Steward

Review and safely clean local Codex and Claude Code sessions

Connector by mallikcheripally · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 5
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/mallikcheripally-session-steward

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Review and safely clean local Codex and Claude Code sessions

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
4 read · 2 write · 1 delete · 1 not yet classified
Secrets
None asked for
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 8

Read from the source code; the running server may list different tools.

Read 4 · Look things up without changing anything.

  • find_sessions
  • get_overview
  • inspect_session
  • list_backups

Write 2 · Create, change, send or run things.

  • manage_settings
  • restore_backup

Delete 1 · Delete, drop, revoke or wipe things.

  • manage_automatic_cleanup

Not yet classified 1 · We could not tell from the name and description.

  • clean_sessions

Tools (8)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • clean_sessionsClean sessions

    Clean exact local Codex or Claude Code sessions by ID after an explicit user request. Session Steward revalidates them, creates a recovery backup, deletes only supported session-owned data, verifies the result, and automatically restores the backup if cleanup fails.

  • find_sessionsFind sessions

    Find local Codex and/or Claude Code chats, threads, conversations, and sessions. Use for old, unused, inactive, large, workspace-specific, active, archived, or cleanup-candidate requests. Results are compact and paged; fetch all pages only when explicitly requested, paging each provider separately after an initial all-provider call.

  • get_overviewGet session overview

    Get Codex and/or Claude Code totals: recognized on-disk bytes, session counts, active versus archived counts, provider types, and paged workspace totals. Optionally include Session Steward settings, Keep totals, storage compatibility, and automatic-cleanup status.

  • inspect_sessionInspect session

    Inspect one exact Codex or Claude Code session. Always returns safe metadata and relationships; optionally reads a bounded recent timeline and/or measured token, model, cache, compaction, and storage-composition data.

  • list_backupsList recovery backups

    List bounded local Session Steward recovery backups for one provider. Use before restore or when the user asks what cleanup can be undone. Results omit filesystem paths; fetch all pages only when explicitly requested.

  • manage_automatic_cleanupManage automatic cleanup

    Create, update, remove, run, start, or stop bounded automatic cleanup. Read schedules and scheduler status with get_overview includeAutomaticCleanup. Saving requires an inactivity threshold and per-run cap; each run resolves current matches and uses normal backup, verification, and recovery.

  • manage_settingsManage Session Steward settings

    Change Session Steward's provider settings or Keep protections. Keep affects only Session Steward cleanup; Codex or Claude Code can still remove kept data. Read current settings or Keep totals with get_overview first.

  • restore_backupRestore recovery backup

    Restore one exact local Session Steward recovery backup after an explicit user request. First call list_backups and use an exact restorable backup ID. Restore preserves current files before overwriting them and verifies the result.

Signals

Stars
5
Forks
0
Open issues
0
Last commit
Sep 24, 2026 (1 month ago)
Last release
Sep 24, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.mallikcheripally/session-steward
Version
0.12.0
Auth
No auth
Packages
npm session-steward
License
MIT
Repository
github.com/mallikcheripally/session-steward
Website
github.com/mallikcheripally/session-steward#readme
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Session Steward MCP server. Agent Mart. https://agentmart.dev/connectors/mallikcheripally-session-steward (last updated 2026-10-24)