session-watchdog
par xbillwatsonx
Productivity & TasksRésumé
Monitor session context levels and proactively save checkpoints before compaction.
Description
Ce que fait ce skill
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.
Quand l'utiliser
- 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
Exemple de 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-watchdogExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.