Search Documentation
Search across all documentation pages
session_start
Load recent context at the start of a session. Returns recent session summaries (episodic), high-importance facts, active tasks, constraints, available vaults, and recently active agents. Optionally accepts a query for targeted context retrieval. Call this at the beginning of every session to resume where you left off.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| vaultId | string (UUID) | optional | Scope to a specific vault |
| query | string | optional | Optional query to retrieve targeted context via semantic search |
| mode | string | optional | Context profile preset. One of: default, planning, incident, handoff, deep, minimal, none. planning = more facts/tasks, incident = more recent context, handoff = session transfer, deep = maximum context, minimal = lightweight (1 episodic, 2 facts), none = skip all memory queries (vaults + agents only). Explicit max* params override mode. |
| maxEpisodic | integer (0-10) | optional | Max recent session summaries (default depends on mode) |
| maxFacts | integer (0-20) | optional | Max important facts (default depends on mode) |
| maxTasks | integer (0-10) | optional | Max active tasks (default depends on mode) |
| maxConstraints | integer (0-20) | optional | Max constraints (default depends on mode) |
| summaryOnly | boolean | optional | Return memory summaries instead of full content (default: true). Set to false to get full content. |
| includeDocuments | string[] | optional | Which documents to include in the response (default: ["soul"]). Options: soul, instructions, skills, checks. Use read_document to fetch others on demand. |
Returns#
An object containing recent session summaries, important facts, active tasks, constraints, available vaults, recently active agents, and optionally vault documents. The exact shape depends on the mode and parameters used.
Example#
json
{
"tool": "session_start",
"arguments": {
"mode": "planning",
"maxTasks": 10,
"includeDocuments": ["soul", "instructions"]
}
}