Session Management

What is a Session?

A session tracks work across time, terminals, and context compaction. Key features:

1. Unique ID: Format YYYYMMDD_HHMM_XXXX (e.g., 20251208_1147_2d6q)
2. Stable ID: Short reference s_XXXX (e.g., s_2d6q)
3. Work Items: Everything done during the session
4. Agenda: Structured handoff document
5. Subsessions: Work blocks within a session

Session Lifecycle

/recover → session.current → Continue or Start New
    ↓
Work (items logged automatically)
    ↓
session.agenda_update (track progress)
    ↓
session.end (auto-generates summary)

Key Tools

• session.start - Start new session
• session.current - Get active session
• session.continue_session - Resume by ID
• session.end - End and summarize
• session.item - Log work item
• session.agenda - View agenda
• session.sync - Multi-terminal sync

Multi-Terminal Support

Sessions survive across: - Multiple terminal windows - Different devices - Context compaction - Time gaps (continue next day)

Agenda Structure

✅ Completed: [items done]
🔵 In Progress: [current work]
📌 Next Steps: [planned work]
🚫 Blockers: [issues]
📝 Notes: [context]

Auto-Linking

When you create items (Track projects, KB entries, etc.), they auto-link to the current session for tracking.