/context-status — Check Session Health

SkillAI & models

Lets your agent check how much of its context window has been used and whether a session compaction is coming.

Then ask your AI: use the /context-status skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add it as a step in a pipeline you build on Ahel, or connect Ahel to Claude, ChatGPT, Cursor, Claude Code or Codex and ask your AI to use it.

About this skill

Show current context status and session health. Use to check how much context has been used, whether auto-compact is approaching, and what state will be preserved.

What this skill tells your AI

The instructions your AI receives, as published by pedrohcgs/claude-code-my-workflow in .claude/skills/context-status/SKILL.md and read by Ahel’s review.

Show the current session status including context usage estimate, active plan, and preservation state.

What This Skill Shows

  1. Context usage estimate — Approximate % of context window used
  2. Active plan — Current plan file and status
  3. Session log — Most recent session log
  4. Preservation state — What will survive compaction

Workflow

Step 1: Check the Context Estimate

The context-monitor hook writes its estimate to context-pct.txt (and its counters and threshold flags to context-monitor-cache.json) in this project's session directory:

d=~/.claude/sessions/$(printf '%s' "${CLAUDE_PROJECT_DIR:-$PWD}" | python3 -c 'import sys,hashlib;print(hashlib.md5(sys.stdin.read().encode()).hexdigest()[:8])')
cat "$d/context-pct.txt" 2>/dev/null; cat "$d/context-monitor-cache.json" 2>/dev/null | head -20

Step 2: Find Active Plan

ls -lt quality_reports/plans/*.md 2>/dev/null | head -3

Step 3: Find Session Log

ls -lt quality_reports/session_logs/*.md 2>/dev/null | head -1

Step 4: Report Status

Format the output:

📊 Session Status
─────────────────────────────────
Context Usage:  ~XX% (estimated)
Auto-compact:   [approaching | not imminent]

📋 Active Plan
File:   quality_reports/plans/YYYY-MM-DD_description.md
Status: [draft | approved | in_progress | completed]
Task:   [current unchecked task or "none"]

📝 Session Log
File:   quality_reports/session_logs/YYYY-MM-DD_description.md

✓ Preservation Check
  • Pre-compact hook: [configured | missing]
  • Post-compact restore: [configured | missing]
  • Session state will be saved before compaction

Notes

  • Context % comes from Claude Code's own context_window.used_percentage where the status line shows it; the hook's context-pct.txt holds an estimate from transcript size (falling back to a tool-call count). The built-in /context shows exact usage
  • Actual compaction is triggered by Claude Code automatically
  • All important state is saved to disk (plans, logs, MEMORY.md)

Signals

GitHub stars
2k
Forks
3k
Last commit
Sep 2026
Advanced
Item type
skill
Key
context-status-pedrohcgs
Source
github.com/pedrohcgs/claude-code-my-workflow