aura-guard

Monitor Claude context usage and trigger auto-compact at a configurable threshold.

37|7|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/smorky850612/Aurakit --skill aura-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aura-guard
Source: https://github.com/smorky850612/Aurakit/tree/main/skills/aura-guard
Command: npx skills add https://github.com/smorky850612/Aurakit --skill aura-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Monitors Claude context usage to prevent token budget overruns during long interactions, automatically triggering compactness when the limit is approached.

Core Features & Use Cases

  • Automatic context guard that triggers auto-compact when usage crosses the defined threshold.
  • Pre-Compact and Post-Compact hooks that back up transcripts and re-inject context for seamless continuity.
  • Snapshot management with current and backup transcripts stored under .aura/snapshots.

Quick Start

Enable AuraKit Guard and let it auto-compact the context when the threshold is reached.

Frequently Asked Questions about aura-guard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent Claude context token budget overruns during long interactions?

To prevent token budget overruns, you can use an automatic context guard that monitors usage and triggers auto-compact when a defined percentage threshold is reached. This ensures long interactions stay within the context limit.

How do I configure the auto-compact threshold for Claude Code context management?

Configuring the auto-compact threshold requires setting the CLAUDE_AUTOCOMPACT_PCT_OVERRIDE environment variable. This allows you to define the exact context usage percentage that triggers the automatic compaction process.

Can I back up Claude Code transcripts before auto-compact executes?

Yes, you can back up Claude Code transcripts before auto-compact executes using pre-compact and post-compact hooks. These hooks automatically save current and backup transcripts for recovery purposes.

Does the context budget guard work without installing additional dependencies?

The context budget guard works without additional dependencies because it relies entirely on built-in Bash tools. It operates autonomously by monitoring usage and managing snapshots under the .aura/snapshots directory.

How do I recover context after an auto-compact event in Claude Code?

To recover context after an auto-compact event, the guard re-injects context using post-compact hooks. It retrieves the saved snapshots from the .aura/snapshots directory to restore your previous working state seamlessly.

When should I use an automatic context guard for token management?

You should use an automatic context guard for token management during long interactions where context limits are likely to be approached. It automatically triggers compaction at your configured threshold to prevent budget overruns.