unclecode

Cczip — Development skill for Claude Code

Development community

Claude Context Compressor - Optimize Claude conversation history.

How to install Cczip

This entry records only its repository, not the path inside it, so there is no exact command to give. Open unclecode/cczip and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Cczip does

Claude Context Compressor - Optimize Claude conversation history.

Alternatives in Development

Skill Creator — Create new skills, modify existing skills, and measure skill performance 94.1k ★
Hermes Agent Self Evolution — ⚒ Evolutionary self-improvement for Hermes Agent — optimize skills, prompts, and code using DSPy + GEPA 5.2k ★
Analyze Cluster Postmortem — Postmortem analysis of cluster failures → OPTIMIZE PROMPTS to work for EVERY use case 1.7k ★

README

cczip - Claude Context Compressor

Never hit Claude's context limit again. Intelligently compress conversation history with one command.

Installation

npm install -g cczip

Quick Start

# Check your current usage
cczip --context

# Compress by 50% (default)
cczip

# That's it! Your conversation is optimized.

Common Usage Patterns

Managing Multiple Sessions

# List all available chat sessions
cczip --list

# Output:
# ID                                     TOKENS    MSGS  USAGE  MODIFIED
# ────────────────────────────────────────────────────────────────────────
# e93f6920-62eb-446f-92f1-69b30e387ec5  170006   254   85%  Sep 25, 08:57 PM
# 66b1d662-42b8-40f7-bf98-150eaaa08c13   45320    89   23%  Sep 25, 08:49 PM

# Compress a specific session
cczip e93f6920-62eb-446f-92f1-69b30e387ec5

# Compress session with specific amount
cczip e93f6920-62eb-446f-92f1-69b30e387ec5 40%

Compression Options

# Light compression (remove 30%)
cczip 30%
# → Keeps 70% of content, good for when you're at ~70% capacity

# Medium compression (remove 50%) - DEFAULT
cczip
# → Balanced approach, doubles your remaining space

# Heavy compression (remove 70%)
cczip 70%
# → Aggressive cleanup, keeps only 30% most relevant content

# Target specific token count
cczip 100000
# → Compress to exactly 100k tokens

Safety Features

# Preview changes without modifying anything
cczip --preview 40%
# Shows what would be removed, no changes made

# Every compression creates automatic backup
cczip 50%
# → Creates: session-id.jsonl.backup.1234567890

# Restore from backup if needed
cczip --restore
# → Restores most recent backup

Working with Files

# Auto-detect (uses most recent session in current directory)
cczip

# Specific session by ID
cczip e93f6920-62eb-446f-92f1-69b30e387ec5

# Specific file path
cczip /path/to/conversation.jsonl

# With compression amount
cczip conversation.jsonl 40%