---
name: run-memory
description: Checkpoint and resume for AI agent runs. Save state after each step; when a run crashes, resume hands back the last step, state and finished items so it picks up where it left off instead of starting over. Free watch-only mode shows exactly what would be saved; Pro (All Access, $49 a month) saves and resumes.
---
# Run Memory

Works with Claude, Codex, ChatGPT, Grok Bot. Bring your own model.

Connect the MCP server at https://memory.cloudforbots.com/mcp (Claude Code: `claude mcp add --transport http run-memory https://memory.cloudforbots.com/mcp`).

## When to use
- `save_checkpoint`: Call after each completed step with the state you would need to continue (cursor, ids done, partial results; up to 256 KB JSON). Pro saves it (last 20 per run, kept 30 days). Free watch-only saves nothing and returns would_save: exactly what would have been stored. Never put passwords or API keys in state.
- `resume`: Call FIRST when a run starts. If a checkpoint exists for run_id (Pro), returns the last step, state and done list: continue from there and skip finished work. If none, start fresh.
- `list_checkpoints`: List recent checkpoints (step, size, time) for one run or all runs on your key.
- `weekly_report`: Draft a plain-English report of the last 7 days: runs, checkpoints saved (Pro) or that would have been saved (free). Read-only; sends nothing.

## Rules
1. Before calling, state in one line what you understood the user wants.
2. Report the tool's `job` and `outcome` lines to the user.
3. If you get `free_limit_reached`, tell the user the free tier is 500/day and share the $49/month All Access link: https://cloudforbots.com/offer