Skip to content
TakoAPI
Back to skills

session-watchdog

by xbillwatsonx

Productivity & Tasks
638Downloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Monitor session context levels and proactively save checkpoints before compaction.

Description

What This Skill Does

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.

When to Use It

  • 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

Example Workflow

INPUT

User asks: How much context do we have left?

AGENT
  1. 1

    Run session_status to retrieve contextTokens value

  2. 2

    Compare tokens against defined thresholds (Safe / Warning / Critical / Full)

  3. 3

    If above 160k, read the current memory/YYYY-MM-DD.md file

  4. 4

    Append checkpoint with decisions, pending tasks, and modified file paths

  5. 5

    Alert user with current percentage and ask whether to continue, restart, or pause

OUTPUT

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-watchdog

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links