Proactive session capacity monitoring and management for OpenClaw. Prevents context window lockups by warning at configurable thresholds (75%, 85%, 90%, 95%), automatically backing up sessions before resets, and managing session resumption prompts. Use when working on long-running projects, managing multiple conversation channels (Discord, Telegram, webchat), or preventing lost work from full context windows. Includes CLI tools for capacity checks, cross-session dashboards, archive management, and session resumption. Supports any model or provider.
Proactive session capacity monitoring and management for OpenClaw. Prevents context window lockups by warning at configurable thresholds (75%, 85%, 90%, 95%), automatically backing up sessions before resets, and managing session resumption prompts. Use when working on long-running projects, managing multiple conversation channels (Discord, Telegram, webchat), or preventing lost work from full context windows. Includes CLI tools for capacity checks, cross-session dashboards, archive management, and session resumption. Supports any model or provider.
{"openclaw":{"emoji":"🌊","version":"1.3.6","disable-model-invocation":false,"capabilities":["session-monitoring","capacity-warnings","session-backup","session-resumption","multi-agent-support","auto-detection","file-operations-local"],"requires":{"bins":"[Truncated]","anyBins":"[Truncated]","config":"[Truncated]","env":"[Truncated]"},"install":["[Truncated]"],"credentials":{"required":false,"types":"[Truncated]","notes":"No external credentials required. Operates on local OpenClaw session files only."}}}
Tide Watch 🌊
Proactive session capacity monitoring for OpenClaw.
⚠️ Security & Architecture Notice
Tide Watch is a HYBRID SKILL with two operational modes:
Mode 1: Directives-Only (Recommended for Most Users)
Description: AGENTS.md and HEARTBEAT.md directives only Code Execution:NONE - Uses OpenClaw's built-in tools only (no CLI installation) File Access: Reads OpenClaw session files via agent's built-in tools Installation: Copy template directives to workspace config files Security: Lowest risk - no code installation or execution required
What it does:
✅ Monitors session capacity via session_status tool
✅ Warns at thresholds (75%, 85%, 90%, 95%)
✅ Auto-loads resumption prompts on session reset
✅ All operations through OpenClaw's native tools
Mode 2: CLI Tools (Optional)
Description: Node.js command-line tools for manual management Code Execution:YES - Executable JavaScript code File Access: Direct read/write to ~/.openclaw/agents/main/sessions/ Installation:git clone + npm link (requires Node.js) Security: Moderate risk - requires code inspection before install
What it does:
CLI commands: tide-watch status, tide-watch dashboard, etc.
Manual capacity checks
Session archive management
Resumption prompt editing (⚠️ see CVE-2026-001 below)
Mode Comparison
Feature
Directives-Only
CLI Tools
Node.js required?
❌ No
✅ Yes (14+)
Installation
Copy templates
npm link
Code execution
❌ None
✅ JavaScript
File access
Via built-in tools
Direct filesystem
Security risk
Lowest
Moderate
Use case
Passive monitoring
Active management
Choose Directives-Only if: You only need capacity warnings and resumption prompts. Choose CLI Tools if: You need manual session management, archiving, or dashboard views.
🚨 CRITICAL SECURITY NOTICE: CVE-2026-001
Vulnerability: Shell injection in editResumePrompt function Affected Version: v1.0.0 ONLY Current Version: v1.0.1 (PATCHED) Severity: HIGH (CVSS 7.8) Status: ✅ FIXED
Summary: v1.0.0 contained a shell injection vulnerability in the CLI's resume-prompt edit command. An attacker who could control the --session parameter could execute arbitrary commands. This has been fixed in v1.0.1 by replacing execSync with spawnSync.
If you installed v1.0.0:Update immediately to v1.0.1.
# Human-readable vs full precision
tide-watch dashboard # 18.7k/128k (easy to scan)
tide-watch dashboard --raw-size # 18,713/128,000 (exact)# Auto-detect current session (v1.3.4+)export OPENCLAW_SESSION_ID="17290631-4"
tide-watch check --current # Check THIS session
tide-watch check --current --json # JSON for heartbeat scripts# Session-specific archiving (v1.3.3+)
tide-watch archive --session abc123 --dry-run # Preview
tide-watch archive --session abc123 # Archive one
tide-watch archive --session a --session b # Archive multiple# Partial ID matching (v1.3.3+)
tide-watch check --session 17290631-4 # Matches 17290631-42fe-40c0-...# Multi-agent filtering
tide-watch dashboard --agent kintaro # Kintaro sessions only
tide-watch report --exclude-agent main # All except main
Runtime Requirements
Mode 1 (Directives-Only):
Node.js: Not required
npm: Not required
Dependencies: None
Binary: None
Installation: Copy templates to workspace config files
Mode 2 (CLI Tools - Optional):
Node.js: v14.0.0 or later required
npm: Any recent version
Dependencies:
Development: jest@^30.2.0 (for testing only)
Runtime: None (zero production dependencies)
Binary:tide-watch (installed globally via npm link)
Installation:git clone + npm link
Why zero runtime dependencies?
Uses only Node.js built-in modules (fs, path, child_process)
No external API clients
No network libraries
Minimal attack surface
Recommendation
Most users should use Directives-Only Mode. This provides automatic capacity monitoring without installing any code. Only install CLI tools if you specifically need manual capacity management features.
What It Does
Monitors your OpenClaw session context windows and warns you before they overflow:
🟡 75% — Heads up, consider wrapping up soon
🟠 85% — Recommend finishing current task and resetting
🔴 90% — Session will lock soon, ready to reset
🚨 95% — Critical! Save to memory NOW
Installation
Step 1: Add Monitoring Directive to AGENTS.md
Copy the directive template from AGENTS.md.template and add it to your workspace AGENTS.md file:
# From your workspace root (~/clawd or similar)cat skills/tide-watch/AGENTS.md.template >> AGENTS.md
Or manually add the monitoring section from the template.
This tells me (your agent) what to look for and when to warn you.
Step 2: Add Heartbeat Task to HEARTBEAT.md
Copy the heartbeat template from HEARTBEAT.md.template and add it to your workspace HEARTBEAT.md file:
# From your workspace root (~/clawd or similar)cat skills/tide-watch/HEARTBEAT.md.template >> HEARTBEAT.md
Or manually add the Tide Watch heartbeat section from the template.
This tells me to check capacity automatically on a schedule.
Step 3: Configure Settings (Optional)
Default settings work for most users, but you can customize in your AGENTS.md:
