elb-pr/claudikins-automatic-context-manager

README preview

![Claudikins ACM Banner](assets/banner.png)

> **v1.1.1-beta** - Native hooks implementation. This is beta software - expect rough edges. Please [report bugs here](https://github.com/elb-pr/claudikins-automatic-context-manager/issues).

**Automatic context management for Claude Code.** Monitors token usage and triggers at 60% context saturation, prompting for session handoff with an auto-generated summary that opens in a fresh session.

## Requirements

Claude Code CLI and Python 3.

## Why

LLM attention weights distribute across all context tokens. As context fills, per-token attention decreases and earlier information receives less weight during generation.

## What It Does

1. Statusline displays current context percentage
2. At 60% threshold, creates flag file for `UserPromptSubmit` hook
3. Hook injects context prompting Claude to use `AskUserQuestion` for handoff confirmation
4. On confirmation, captures structured state (todos, modified files, git status)

View full repository on GitHub →