# Session Steward

Review local Codex and Claude Code sessions, inspect their related records, and plan cleanup. Useful when you need to sort through sessions across workspaces before removing them.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: mallikcheripally
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mallikcheripally/session-steward
- Updated: 2026-09-24
- HTML: https://affpapa.org/en/nevibecode/mcp/session-steward

## What it does

Session Steward reads the local `~/.codex` and `~/.claude` folders. Filter sessions by activity, workspace, archive status, name, or ID, then inspect a timeline of messages, file changes, and commands. It can also show recognized session storage and token use.

Before deleting, the server builds a plan of related records for you to review and confirm. It makes a local recovery backup, checks the result, and leaves storage it cannot identify untouched. Node.js 24.15 or newer is required. The MCP process runs locally, but your client may send session details—including messages and workspace paths—to its AI provider.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add session-steward -- npx -y session-steward
```

### Codex

**Platform CLI**
```bash
codex mcp add session-steward -- npx -y session-steward
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "session-steward": {
            "command": "npx",
            "args": [
                "-y",
                "session-steward"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "session-steward": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "session-steward"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add session-steward npx -y session-steward
```

## When to use it
- find inactive sessions across workspaces
- sort large sessions by storage size
- inspect a session timeline before removal
- clean related session records from a reviewed plan
- restore session data from a backup

## Example prompts
- Find inactive Codex and Claude Code sessions, grouped by workspace.
- Show this session's timeline and token use before cleanup.
- Prepare a cleanup plan for the selected sessions and wait for my approval.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md