Restore Session
restore_sessionRestores full agent session context in one call — loads checkpoint, plan, milestones, recent learnings, and recent log entries. Use when: starting a new session, switching clients, or waking up an agent after a break. Call this first before any work. Scope: local filesystem. No network access. Not for: restoring only a checkpoint (use memory_restore), reading a single fact (use memory_read).
How to use restore_session
Provide only the required inputs below. Start with the smallest scope that answers the task, then review the risk properties before an agent executes the call.
Risk and execution properties
Read only: yes
Destructive: no
Idempotent: yes
Open world: no — operates locally or through configured services
Inputs
checkpointstringCheckpoint name to restore. Defaults to 'latest'.
Default: "latest"
includearrayWhich sections to include. Omit to include all.
Example input
{
"checkpoint": "latest",
"include": "<array>"
}Browse or search the full 74-tool reference to choose the smallest suitable capability.
Browse all tools →