add-compact
Add /compact command for manual context compaction. Solves context rot in long sessions by forwarding the SDK's built-in /compact slash command. Main-group or trusted sender only.
Best for Long-running agent deployme…Works with GitHub
⌘source
- author
@qwibitai- language
- TypeScript
★27kstars
12kforks
Apr 18, 2026
✦overview.md
Key Features
- ·Adds /compact slash command for manual context compaction
- ·Fights context rot in long-running sessions
- ·Uses Claude Agent SDK's built-in /compact functionality
- ·Maintains session continuity with new session ID
- ·Main-group or trusted sender authorization only
Use Cases
- →Long-running agent sessions where context accumulates and needs periodic compaction
- →Development sessions that span multiple hours or days and risk context overflow
- →Production deployments where agents need to maintain session continuity while managing context limits
Best for
- ✓Long-running agent deployments
- ✓Production systems with persistent sessions
- ✓Teams managing context-heavy workflows
Not ideal for
- !One-off or short-lived sessions
- !Unauthorized users outside main-group
FAQs
name
add-compact
description
Add /compact command for manual context compaction. Solves context rot in long sessions by forwarding the SDK's built-in /compact slash command. Main-group or trusted sender only.
Add /compact Command
Adds a /compact session command that compacts conversation history to fight context rot in long-running sessions. Uses the Claude Agent SDK's built-in /compact slash command — no synthetic system prompts.
Session contract: /compact keeps the same logical session alive. The SDK returns a new session ID after compaction (via the init system message), which the agent-runner forwards to the orchestrator as newSessionId. No destructive reset occurs — the agent retains summarized context.
Phase 1: Pre-flight
Check if src/session-commands.ts exists:
test -f src/session-commands.ts && echo "Already applied" || echo "Not applied"
If already applied, skip to Phase 3 (Verify).
Phase 2: Apply Code Changes
Merge the skill branch:
git fetch upstream skill/compact
git merge upstream/skill/compact
Note:
upstreamis the remote pointing toqwibitai/nanoclaw. If using a different remote name, substitute accordingly.
This adds:
src/session-commands.ts(extract and authorize session commands)src/session-commands.test.ts(unit tests for command parsing and auth)
$install
1-click copynpx skills add qwibitai/nanoclaw --skill add-compactSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.