session-watchdog
von xbillwatsonx
Productivity & TasksKurzbeschreibung
Monitor session context levels and proactively save checkpoints before compaction.
Beschreibung
Was dieser Skill macht
Monitors token usage in active Claude sessions and triggers checkpoint saves to memory files before context compaction occurs. Tracks four threshold levels from safe to full (0–197k+ tokens) and prompts the user to continue, restart, or pause when nearing limits.
Saves context state before compaction happens automatically, giving users a choice instead of silently losing conversation history.
Wann du ihn einsetzt
- Checking remaining context before starting a large file edit
- Saving pending tasks before a long conversation compacts
- Answering 'how much context is left?' mid-session
- Preserving decisions and configurations across session boundaries
- Starting a new session with a recap of unresolved issues
Beispiel-Workflow
User asks: How much context do we have left?
- 1
Run session_status to retrieve contextTokens value
- 2
Compare tokens against defined thresholds (Safe / Warning / Critical / Full)
- 3
If above 160k, read the current memory/YYYY-MM-DD.md file
- 4
Append checkpoint with decisions, pending tasks, and modified file paths
- 5
Alert user with current percentage and ask whether to continue, restart, or pause
Context is at ~82% (160k tokens). Checkpoint saved to memory/2026-03-19.md with pending tasks and recent decisions. User prompted to choose next step.
Installation
clawhub install xbillwatsonx/session-watchdogFühre den CLI-Befehl aus oder füge den Prompt in Claude Code, Cursor, Codex oder deinen Coding-Agenten ein.