/session-end

hook session-end

Cleanup and persist session state before ending work.

Usage

npx claude-flow hook session-end [options]

Options

• `--session-id, -s <id>` - Session identifier to end
• `--save-state` - Save current session state (default: true)
• `--export-metrics` - Export session metrics
• `--generate-summary` - Create session summary
• `--cleanup-temp` - Remove temporary files

Examples

Basic session end

npx claude-flow hook session-end --session-id "dev-session-2024"

With full export

npx claude-flow hook session-end -s "feature-auth" --export-metrics --generate-summary

Quick close

npx claude-flow hook session-end -s "quick-fix" --save-state false --cleanup-temp

Complete persistence

npx claude-flow hook session-end -s "major-refactor" --save-state --export-metrics --generate-summary

Features

State Persistence

• Saves current context
• Stores open files
• Preserves task progress
• Maintains decisions

Metric Export

• Session duration
• Commands executed
• Files modified
• Tokens consumed
• Performance data

Summary Generation

• Work accomplished
• Key decisions made
• Problems solved
• Next steps identified

Cleanup Operations

• Removes temp files
• Clears caches
• Frees resources
• Optimizes storage

Integration

This hook is automatically called by Claude Code when:

• Ending a conversation
• Closing work session
• Before shutdown
• Switching contexts

Manual usage in agents:

# At session end
npx claude-flow hook session-end --session-id "your-session" --generate-summary

Output

Returns JSON with:

{
  "sessionId": "dev-session-2024",
  "duration": 7200000,
  "saved": true,
  "metrics": {
    "commandsRun": 145,
    "filesModified": 23,
    "tokensUsed": 85000,
    "tasksCompleted": 8
  },
  "summaryPath": "/sessions/dev-session-2024-summary.md",
  "cleanedUp": true,
  "nextSession": "dev-session-2025"
}

See Also

• `hook session-start` - Session initialization
• `hook session-restore` - Session restoration
• `performance report` - Detailed metrics
• `memory backup` - State backup