Session persistence for Claude Code with session chaining, ID generation, tag extraction, and flow context building. Replaces 5+ session scripts with direct MCP tools.
14 tools with complete schemas and descriptions, but quality is uneven. All tools have input schemas with types and descriptions, meeting baseline requirements. However, descriptions are often terse (10-50 chars) and lack actionable context for LLM selection. Tool names follow verb_noun convention well (session_save, session_load, etc.). Parameter descriptions are present but minimal, many lack format constraints, ranges, or dependency hints. Output schemas are not documented in the source. Error handling is basic (success/failure flags) without recovery guidance. Security validation (_safe_component) is strong for path traversal, but no audit logging visible. Composition is reasonable, tools are single-purpose, but some could be batched (e.g., session_tag accepts array but session_add_work_item does not). No tool annotations beyond readOnlyHint visible in the provided code snippet.
Accumulate data into a session's context.
Add a work item to a session.
Archive a session by moving it to an archive directory.
Mark a work item as complete.
Create a new session with auto-generated ID.
Finalize a session and mark it as complete.
Get the accumulated context for a session.
Output schemas not documented. Tools return success/failure dicts but LLMs cannot see what fields to expect in responses. Breaks downstream tool chaining and forces agents to guess field names.
Descriptions are terse (10-60 chars) and lack actionable context. E.g., 'List all sessions in a project' does not explain when to call this vs session_query, or what structure is returned. LLMs cannot distinguish similar tools.
Parameter descriptions lack format constraints and ranges. E.g., 'session_id' has no length limits, pattern, or character restrictions. 'data_type' accepts 'summary'|'state'|'context' but this is not declared as an enum in the schema.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
Link two sessions together in a chain.
List all sessions in a project.
Load session data from disk with corruption recovery.
Query sessions by metadata criteria.
Save session data to disk atomically.
Search sessions by tags.
Add or update tags on a session.
Error handling is minimal. Tools return {success: false, error: '...'} but do not guide recovery. E.g., if session_load fails due to corruption, the error does not suggest calling session_query to find a valid session or session_create to start fresh.
No audit logging or permission checks visible. Destructive operations (session_archive, session_finalize) do not log who called them or verify authorization. Compliance and incident response are at risk.