session-watchdog

TotalClaw 作者 totalclaw

监视会话上下文级别并在压缩之前主动保存检查点。在以下情况下使用：(1) 会话上下文超过容量的 80%，(2) 用户询问会话状态或内存，(3) 在每个新会话开始时检查上下文，或 (4) 在可能使上下文超过阈值的长任务之前。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~xbillwatsonx-session-watchdog

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~xbillwatsonx-session-watchdog/file -o xbillwatsonx-session-watchdog.md

## 概述（中文）

监视会话上下文级别并在压缩之前主动保存检查点。在以下情况下使用：(1) 会话上下文超过容量的 80%，(2) 用户询问会话状态或内存，(3) 在每个新会话开始时检查上下文，或 (4) 在可能使上下文超过阈值的长任务之前。

## 原文

# Session Watchdog

Monitors context levels, warns before compaction, and saves checkpoints to preserve important information.

## Context Thresholds

| Level | Tokens | Action |
|-------|--------|--------|
| Safe | 0-140k | Normal operation |
| **Warning** | 140k-160k | Warn user, save checkpoint |
| Critical | 160k-197k | Warn + stop unless urgent |
| Full | 197k+ | Compaction imminent |

## Check Context

Before each session and periodically during long conversations:

```
session_status
```

Check the `contextTokens` field from the response.

## Checkpoint Protocol

When approaching 80% (160k tokens):

1. **Save checkpoint to memory file:**
   - Read current memory/YYYY-MM-DD.md
   - Add key context: decisions, pending tasks, important details
   - Write back to memory file

2. **Alert user:**
   Say: "⚠️ Approaching context limit (~160k tokens). Saving checkpoint to memory before continuing."

3. **Ask user:**
   - Continue and accept compaction?
   - Summarize and restart fresh?
   - Pause until ready?

## What to Save

Essential information that must survive compaction:

- **Decisions made** in this conversation
- **Pending tasks** not yet completed
- **Important context** (project state, configurations, preferences)
- **Files modified** and their paths
- **Unresolved issues** requiring follow-up

## When to Trigger

- At session start
- After every 30k tokens of conversation
- Before initiating large tasks (file edits, multiple operations)
- When user asks "how much context do we have left?"

## Memory File Format

```
# YYYY-MM-DD

## Session Checkpoint (at X% context)

### Decisions
- Decision 1
- Decision 2

### Pending
- [ ] Task 1
- [ ] Task 2

### Important Context
- Project state: ...
- Last file modified: ...

### Unresolved
- Issue needing follow-up
```