name	emergency-compact
description	Emergency context compaction - truncate older messages and force compaction when hitting context limits.
metadata	{"aethervault":{"emoji":"🗜️","requires":{"bins":["jq"]}}}

Emergency Compact

Force context compaction by truncating older messages when the normal compaction fails or context overflow persists.

When to Use

Use this skill when:

Context overflow (413 "Prompt is too long") keeps happening
Normal auto-compaction fails
Session is stuck at high context usage
User explicitly asks to force compaction or reduce context

Quick Emergency Procedure

Step 1: Check Current Context Status

# Find current session ID
AETHERVAULT_HOME="${AETHERVAULT_HOME:-$HOME/.aethervault}"
if [ ! -d "$AETHERVAULT_HOME" ] && [ -d "$HOME/.aethervault" ]; then
  AETHERVAULT_HOME="$HOME/.aethervault"
fi
AGENT_DIR="$AETHERVAULT_HOME/agents/main"
SESSION_ID=$(jq -r '."agent:main:main".sessionId' "$AGENT_DIR/sessions/sessions.json")
SESSION_FILE="$AGENT_DIR/sessions/${SESSION_ID}.jsonl"

# Count messages and estimate size
echo "Session: $SESSION_ID"
wc -l "$SESSION_FILE"
du -h "$SESSION_FILE"

Step 2: Create Truncated Backup and Force Reduce

# Backup current session
cp "$SESSION_FILE" "${SESSION_FILE}.backup.$(date +%s)"

# Keep only last N messages (adjust N as needed - start with 50)
KEEP_LINES=50
TOTAL=$(wc -l < "$SESSION_FILE")
SKIP=$((TOTAL - KEEP_LINES))

if [ $SKIP -gt 0 ]; then
  # Create truncated version: keep header (first line) + last N lines
  head -1 "$SESSION_FILE" > "${SESSION_FILE}.tmp"
  tail -n $KEEP_LINES "$SESSION_FILE" >> "${SESSION_FILE}.tmp"
  mv "${SESSION_FILE}.tmp" "$SESSION_FILE"
  echo "Truncated from $TOTAL to $((KEEP_LINES + 1)) lines"
else
  echo "Session already small enough ($TOTAL lines)"
fi

Step 3: Add Truncation Notice

# Add a notice that context was truncated
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
NOTICE='{"type":"message","timestamp":"'"$TIMESTAMP"'","message":{"role":"user","content":[{"type":"text","text":"[SYSTEM: Context was emergency-truncated due to overflow. Older messages were removed to allow conversation to continue. Use /memory or session-logs skill to access older context if needed.]"}]}}'
echo "$NOTICE" >> "$SESSION_FILE"

Alternative: Aggressive Truncation (Nuclear Option)

If the above doesn't work, keep only the essential:

# Keep only session header and last 10 messages
KEEP_LINES=10
head -1 "$SESSION_FILE" > "${SESSION_FILE}.tmp"
tail -n $KEEP_LINES "$SESSION_FILE" >> "${SESSION_FILE}.tmp"
mv "${SESSION_FILE}.tmp" "$SESSION_FILE"

# Add notice
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
echo '{"type":"message","timestamp":"'"$TIMESTAMP"'","message":{"role":"user","content":[{"type":"text","text":"[SYSTEM: Emergency truncation performed - context reduced to last 10 messages. Use /memory for context recovery.]"}]}}' >> "$SESSION_FILE"

After Truncation

Wait a moment - The session file watcher will pick up changes
Send any message - This will trigger the session to reload
Compaction should now succeed - With reduced context, auto-compact works

Prevention Tips

Set contextWindow lower than actual limit (e.g., 150K for 200K limit)
Use /memory to checkpoint important context before it's compacted
For long sessions, periodically use /new to start fresh

Troubleshooting

If truncation doesn't help:

Check if session file is locked: ls -la ${SESSION_FILE}.lock
Remove lock if stale: rm ${SESSION_FILE}.lock
Restart aethervault: systemctl restart aethervault

One-Liner for Quick Fix

AETHERVAULT_HOME="${AETHERVAULT_HOME:-$HOME/.aethervault}" && [ -d "$HOME/.aethervault" ] && [ ! -d "$AETHERVAULT_HOME" ] && AETHERVAULT_HOME="$HOME/.aethervault" && AGENT_DIR="$AETHERVAULT_HOME/agents/main" && SESSION_ID=$(jq -r '."agent:main:main".sessionId' "$AGENT_DIR/sessions/sessions.json") && SF="$AGENT_DIR/sessions/${SESSION_ID}.jsonl" && cp "$SF" "$SF.bak" && (head -1 "$SF"; tail -50 "$SF") > "$SF.tmp" && mv "$SF.tmp" "$SF" && echo "Truncated to 50 messages"

Más de este repositorio

mismo repositorio

ds9-pr-testing

sunilkgrao/aethervault

Validate DS9 code on a branch or PR against a realistic local stack and browser. Use when Sunil or a triage flow asks whether a DS9 fix actually works, or before claiming a branch/PR is tested. Bootstraps a PR checkout from a known-good DS9 checkout, copies working env/config, selects affected services, starts the minimum stack, verifies health, exercises the real route in a browser, inspects downloads/artifacts, and reports concrete evidence.

2026-03-180

ds9-triage

sunilkgrao/aethervault

Triage DS9 bugs and PR requests coming from Sunil in Slack. Use when Sunil asks Linus to inspect a DS9 issue, prepare a fix, create a PR, or verify a fix. Route any real local validation through the ds9-pr-testing skill instead of improvising.

2026-03-180

jira-eng-board

sunilkgrao/aethervault

Create, read, update, and manage Jira issues in the ENG project at tribble-ai.atlassian.net, including attachments, comments, transitions, and epic/child issue setup. Use when you need to create tickets from feature descriptions, search recent ENG requests, update fields or status, or generate an epic with supporting tickets.

2026-03-170

tribble-desktop-triage

sunilkgrao/aethervault

Triage Engage desktop / Tribble Desktop bugs and PR requests coming from Sunil in Slack. Use when Sunil asks Linus to inspect the Electron desktop app, prepare a fix, create a PR, or verify a fix.

2026-03-170

slack-media-analysis

sunilkgrao/aethervault

Analyze screenshots, MP4/video/audio attachments, raw PDFs, screen recordings, and voice notes from Slack, Telegram, and other inbound channels with preprocessing, transcript extraction, keyframes, thread context, and Gemini-first multimodal reasoning. Use when Sunil asks Linus what is happening in a recording, screenshot, PDF, voice note, or other media evidence.

2026-03-160

ds9-prod-debug

sunilkgrao/aethervault

Inspect DS9 production safely from raoDesktop using Azure, App Insights, Key Vault, and the readonly Postgres lane. Use when Sunil asks Linus to investigate a production Tribble / DS9 issue without making product changes.

2026-03-150

name	emergency-compact
description	Emergency context compaction - truncate older messages and force compaction when hitting context limits.
metadata	{"aethervault":{"emoji":"🗜️","requires":{"bins":["jq"]}}}

Emergency Compact

Force context compaction by truncating older messages when the normal compaction fails or context overflow persists.

When to Use

Use this skill when:

Context overflow (413 "Prompt is too long") keeps happening
Normal auto-compaction fails
Session is stuck at high context usage
User explicitly asks to force compaction or reduce context

Quick Emergency Procedure

Step 1: Check Current Context Status

# Find current session ID
AETHERVAULT_HOME="${AETHERVAULT_HOME:-$HOME/.aethervault}"
if [ ! -d "$AETHERVAULT_HOME" ] && [ -d "$HOME/.aethervault" ]; then
  AETHERVAULT_HOME="$HOME/.aethervault"
fi
AGENT_DIR="$AETHERVAULT_HOME/agents/main"
SESSION_ID=$(jq -r '."agent:main:main".sessionId' "$AGENT_DIR/sessions/sessions.json")
SESSION_FILE="$AGENT_DIR/sessions/${SESSION_ID}.jsonl"

# Count messages and estimate size
echo "Session: $SESSION_ID"
wc -l "$SESSION_FILE"
du -h "$SESSION_FILE"

Step 2: Create Truncated Backup and Force Reduce

# Backup current session
cp "$SESSION_FILE" "${SESSION_FILE}.backup.$(date +%s)"

# Keep only last N messages (adjust N as needed - start with 50)
KEEP_LINES=50
TOTAL=$(wc -l < "$SESSION_FILE")
SKIP=$((TOTAL - KEEP_LINES))

if [ $SKIP -gt 0 ]; then
  # Create truncated version: keep header (first line) + last N lines
  head -1 "$SESSION_FILE" > "${SESSION_FILE}.tmp"
  tail -n $KEEP_LINES "$SESSION_FILE" >> "${SESSION_FILE}.tmp"
  mv "${SESSION_FILE}.tmp" "$SESSION_FILE"
  echo "Truncated from $TOTAL to $((KEEP_LINES + 1)) lines"
else
  echo "Session already small enough ($TOTAL lines)"
fi

Step 3: Add Truncation Notice

# Add a notice that context was truncated
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
NOTICE='{"type":"message","timestamp":"'"$TIMESTAMP"'","message":{"role":"user","content":[{"type":"text","text":"[SYSTEM: Context was emergency-truncated due to overflow. Older messages were removed to allow conversation to continue. Use /memory or session-logs skill to access older context if needed.]"}]}}'
echo "$NOTICE" >> "$SESSION_FILE"

Alternative: Aggressive Truncation (Nuclear Option)

If the above doesn't work, keep only the essential:

# Keep only session header and last 10 messages
KEEP_LINES=10
head -1 "$SESSION_FILE" > "${SESSION_FILE}.tmp"
tail -n $KEEP_LINES "$SESSION_FILE" >> "${SESSION_FILE}.tmp"
mv "${SESSION_FILE}.tmp" "$SESSION_FILE"

# Add notice
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")
echo '{"type":"message","timestamp":"'"$TIMESTAMP"'","message":{"role":"user","content":[{"type":"text","text":"[SYSTEM: Emergency truncation performed - context reduced to last 10 messages. Use /memory for context recovery.]"}]}}' >> "$SESSION_FILE"

After Truncation

Wait a moment - The session file watcher will pick up changes
Send any message - This will trigger the session to reload
Compaction should now succeed - With reduced context, auto-compact works

Prevention Tips

Set contextWindow lower than actual limit (e.g., 150K for 200K limit)
Use /memory to checkpoint important context before it's compacted
For long sessions, periodically use /new to start fresh

Troubleshooting

If truncation doesn't help:

Check if session file is locked: ls -la ${SESSION_FILE}.lock
Remove lock if stale: rm ${SESSION_FILE}.lock
Restart aethervault: systemctl restart aethervault

One-Liner for Quick Fix

AETHERVAULT_HOME="${AETHERVAULT_HOME:-$HOME/.aethervault}" && [ -d "$HOME/.aethervault" ] && [ ! -d "$AETHERVAULT_HOME" ] && AETHERVAULT_HOME="$HOME/.aethervault" && AGENT_DIR="$AETHERVAULT_HOME/agents/main" && SESSION_ID=$(jq -r '."agent:main:main".sessionId' "$AGENT_DIR/sessions/sessions.json") && SF="$AGENT_DIR/sessions/${SESSION_ID}.jsonl" && cp "$SF" "$SF.bak" && (head -1 "$SF"; tail -50 "$SF") > "$SF.tmp" && mv "$SF.tmp" "$SF" && echo "Truncated to 50 messages"