Tool reference · Sessions & episodes
session_init
Loads the most recent unread end-of-session summary for a project so a new session can pick up where the last one stopped.
local stdio server writes
When to use
- At the start of a session, before you begin work on a project.
- You want the next steps and pitfalls the previous session left behind.
- You want to peek at the last summary without marking it as read (pass mark_consumed: false).
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
project | string | "general" | — |
mark_consumed | boolean | true | — |
Example
Arguments
{
"project": "my-api"
}Result shape
{
"id": "9f1c2a7e4b0d4c1f8e2a6b3c5d7e9f01",
"session_id": "sess-2026-09-24-a",
"project": "my-api",
"summary": "Moved JWT validation into middleware and fixed refresh-token expiry.",
"highlights": [
"Auth middleware merged"
],
"pitfalls": [
"Refresh tokens are stored in UTC; do not compare with local time"
],
"next_steps": [
"Add rate limiting to /auth/refresh"
],
"open_questions": [],
"ended_at": "2026-09-24T18:02:11Z",
"consumed": 0,
"markdown_stale": false
}Returns {"message": "no pending summary"} when there is nothing to resume. By default the summary is marked consumed so it is not returned twice.
Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.
Server description
The description the server sends to your agent in tools/list, captured from the v14.7.0 source:
At session start: return the most recent unconsumed end-of-session summary with highlights / pitfalls / next_steps.