🧠 @septum-jdr/claude-context-session

Context manager for Claude Code that optimizes token usage by keeping only the latest conversation window.

✨ Features

• Global SQLite storage (~/.claude-context-session)
• Keeps the latest 10 prompts
• Automatic generation of .claude/context.md
• Per-session token reduction
• Compact status output:

◉ 7/10  ↓82%   1.4k tokens

• Works with Claude Interactive Mode
• No wrappers / no proxies
• Safe for updates
• Compatible with WSL / Linux / macOS

📦 Requirements

• Node.js ≥ 20

Check version:

node -v

🚀 Local Installation (WSL / Linux / macOS)

npm install
npm run build
npm install -g .

Verify installation:

which claude-context-session

🤖 Enable in Claude

Edit:

~/.claude/settings.json

Add:

{
  "promptCommand": "claude-context-session"
}

Restart Claude.

📟 Statusline Integration

In your statusline.sh:

PLUGIN_STATUS=$(claude-context-session status 2>/dev/null)
OUT+=" ${SEP} ${PLUGIN_STATUS}"

⚙️ How it Works

Each prompt:

1. Stored in SQLite
2. Only the last 10 prompts are kept (auto-prune)
3. .claude/context.md is updated
4. Claude loads the reduced context automatically
5. Token savings calculated per session

🗑️ Uninstall

npm uninstall -g @septum-jdr/claude-context-session

📄 License

MIT