session — Tool Reference

Session lifecycle. Actions: start (bootstrap with context, patterns, and stats), apply (find relevant skills and memories for a task), reflect (report skill effectiveness).

Aliases

Old tool names session_start, apply, and reflect still work as aliases and route to the corresponding action on this tool.

Parameters

Name	Type	Required	Description
`action`	string	Yes	One of `start`, `apply`, `reflect`.
`domain`	string	—	Domain or project to scope the session to.
`context`	string	—	Free-text session context. Used with `start`.
`memory_limit`	number	—	Max memories to return.
`skill_limit`	number	—	Max skills to return.
`format`	string	—	One of `full`, `compact`.
`skill_detail`	string	—	One of `full`, `summary`, `name_only`.
`summarize`	boolean	—	Condense results into a summary.
`task`	string	—	Task description. Used with `apply`.
`limit`	number	—	Maximum number of results.
`skill_id`	string	—	Skill ID to reflect on. Used with `reflect`.
`outcome`	string	—	One of `success`, `failure`. Used with `reflect`.
`notes`	string	—	Outcome notes. Used with `reflect`.

start

Bootstrap a new session. Returns relevant memories, active skills, detected patterns, and usage stats for the given domain or context.

Parameters: domain, context, memory_limit, skill_limit, format, skill_detail, summarize

{
  "name": "session",
  "arguments": {
    "action": "start",
    "domain": "client-reporting",
    "context": "Preparing the weekly client report for Acme Corp",
    "skill_detail": "summary"
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "Session started for domain: client-reporting\n\nRelevant memories (3):\n- Reports go to [email protected] every Friday by 5pm\n- Use the blue brand template with Linear data\n- Include NPS score from dashboard since Q3\n\nActive skills (1):\n- Weekly Client Report (skill_abc123) — 3-step report workflow\n\nPatterns detected: 1 emerging (meeting-notes → 2/3 observations)\n\nStats: 12 memories, 3 skills, 89% skill success rate"
    }
  ]
}

apply

Find memories and skills relevant to a specific task. Use this mid-session when switching contexts or starting a new sub-task.

Parameters: task (required), domain, limit, format, skill_detail, summarize

{
  "name": "session",
  "arguments": {
    "action": "apply",
    "task": "Draft the Q1 metrics section of the client report",
    "domain": "client-reporting",
    "limit": 5
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "Relevant context for task:\n\nSkills:\n- Weekly Client Report (skill_abc123, active) — Step 2: Pull metrics from dashboard, format as table with WoW comparison\n\nMemories:\n- Client switched from Google Analytics to Plausible in January\n- Q1 target is 15% traffic growth, agreed in Dec planning\n- Use percentage formatting, not raw numbers"
    }
  ]
}

reflect

Report whether a skill helped or failed during this session. Feedback is used to track skill effectiveness over time.

Parameters: skill_id (required), outcome (required), notes

{
  "name": "session",
  "arguments": {
    "action": "reflect",
    "skill_id": "skill_abc123",
    "outcome": "success",
    "notes": "Report generated correctly, client confirmed format was right"
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "Reflection recorded for skill_abc123 (Weekly Client Report): success. Lifetime: 8 uses, 87.5% success rate."
    }
  ]
}