session-watchdog
di xbillwatsonx
Productivity & TasksSintesi
Monitor session context levels and proactively save checkpoints before compaction.
Descrizione
Cosa fa questa 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.
Quando usarla
- 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
Esempio di 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.
Installazione
clawhub install xbillwatsonx/session-watchdogEsegui il comando CLI oppure incolla il prompt in Claude Code, Cursor, Codex o nell'agente di coding che usi.