context-saver

name	context-saver
description	Token-saving execution layer (v6). Runs skill commands in sandboxed subprocesses where compact summaries enter the context window while full output is FTS-indexed. Session continuity via SQLite events + snapshots (16KB default budget, auto-log from execute, restore fallback). Supports intent filtering, batch execution, and progressive memory loading. Use for data-heavy ops; always snapshot before compact and restore/recent on resume.
metadata	{"emoji":"🪶","requires":{"bins":["python3"],"env":[]}}

Context Cooler — Token Optimization

Reduces token consumption by 70-98% through sandboxed execution, intent filtering, and session continuity.

Core Concept

Instead of dumping raw API responses (3-50 KB) into context, Context Saver:

1. Runs skill commands in subprocesses
2. Captures full output
3. Extracts only relevant fields based on intent
4. Returns compact summaries (100-500 bytes)
5. Indexes full output in FTS5 for on-demand retrieval

Commands

Sandboxed Skill Execution

# Run any skill command with automatic summarization
python3 scripts/ctx_run.py --skill my-api --cmd "dashboard" [--intent "check error rate"]
python3 scripts/ctx_run.py --skill my-api --cmd "list-items" [--intent "find failures"]
python3 scripts/ctx_run.py --skill my-api --cmd "search users" --intent "inactive accounts over 90 days"

# Run with explicit summary fields
python3 scripts/ctx_run.py --skill my-api --cmd "dashboard" --fields "active_users,error_rate,uptime"

Batch Execution (Multiple Skills in One Call)

python3 scripts/ctx_batch.py --commands '[
  {"skill": "my-api", "cmd": "dashboard", "fields": ["active_users","error_rate"]},
  {"skill": "analytics-engine", "cmd": "metrics", "intent": "summary"},
  {"skill": "health-monitor", "cmd": "check", "intent": "failures only"}
]'

Session Event Tracking

# Log a session event
python3 scripts/ctx_session.py log --type "action" --priority critical --data '{"operation":"deploy","service":"api-v2"}'

# Build compaction snapshot (called before conversation compacts)
python3 scripts/ctx_session.py snapshot

# Restore from snapshot (called on session resume; falls back across sessions)
python3 scripts/ctx_session.py restore

# List recent events / rotate session id
python3 scripts/ctx_session.py recent --limit 10
python3 scripts/ctx_session.py new

# View session stats
python3 scripts/ctx_session.py stats

Context Search (Query Indexed Data)

python3 scripts/ctx_search.py "error rate spike" [--source my-api]
python3 scripts/ctx_search.py "failed deployments" --source last-run

Context Stats

python3 scripts/ctx_stats.py
# Shows: total bytes saved, calls made, avg compression ratio, session events

How It Saves Tokens

Operation	Without Context Saver	With Context Saver	Savings
Dashboard summary	3 KB JSON	120 B summary	96%
List items (50 records)	5 KB JSON	300 B summary	94%
Search results (200 hits)	20-50 KB	500 B filtered	97%
Multi-skill pipeline	23 KB (4 calls)	2 KB (1 batch)	91%
Session cold start	20 KB workspace files	2 KB snapshot	90%

When to Use

• Any data-heavy skill command (APIs, analytics, search)
• Multi-step pipelines (daily reports, status checks)
• Session resumption after compaction
• When context window is running low
• Don't use for small operations (<500 bytes output)
• Don't use when you need full raw data for editing/modification