Fast Jev Compaction – selektivní kompaktace kontextu Claude Code

Vytvořeno: 27.9.2026 | Aktualizováno: 27.09.2026 14:39

fast-jev-compaction je plugin a knihovna pro Claude Code, která při zkracování kontextu selektivně vyřazuje staré výsledky nástrojů. Pro rozhodnutí používá Jev místo jediného textového shrnutí celé historie.

Co řeší

Dlouhá relace Claude Code může obsahovat velké výpisy souborů, logů a výsledků příkazů. Běžná kompaktace je nahradí textovým shrnutím. To šetří kontextové okno, ale může ztratit přesné údaje, například cestu k souboru, chybovou hlášku nebo dříve spuštěný příkaz.

Fast Jev Compaction se snaží odstranit jen starší technický obsah, který už není užitečný. Textové zprávy uživatele a asistenta nemění.

Jak funguje

Plugin spojí každé volání nástroje s jeho výsledkem podle tool_use_id. První zprávu relace a nastavený počet nejnovějších zpráv chrání před úpravou.

Pro každé starší nechráněné volání nástroje se Jev rozhodne mezi třemi možnostmi:

ponechat volání i celý výsledek,
ponechat volání, ale výsledek zkrátit na začátek a poznámku o zkrácení,
odstranit volání i odpovídající výsledek.

Výstup pak znovu sestaví tak, aby nezůstal výsledek bez odpovídajícího volání nástroje. Jev vidí stav relace, ale dlouhé výsledky nástrojů se ve vstupu pro rozhodování nahrazují stručnou informací.

Instalace a aktivace

Plugin se instaluje z vlastního Claude Code marketplace:

claude plugin marketplace add tamaratran/fast-jev-compaction
claude plugin install fast-jev-compaction@fast-jev-compaction

Vyžaduje Claude Code ve verzi alespoň 2.1.274, zapnuté function hooks a API klíč TypeSafe. Proměnné musí být nastavené v prostředí, ze kterého se spouští Claude Code:

export CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1
export TYPESAFE_API_KEY="..."

Po instalaci je potřeba Claude Code restartovat, případně v běžící relaci spustit /reload-plugins. API klíč nepatří do zdrojového kódu ani do Git repozitáře.

Použití při práci

Po aktivaci není potřeba volat zvláštní příkaz pluginu. Hook zachytí běžnou ruční kompaktaci:

/compact

Použije se také při automatické kompaktaci, když se zaplní kontextové okno relace. Pokud Jev selže, vrátí neplatnou odpověď nebo kompaktace neušetří dost prostoru, plugin předá práci standardnímu mechanismu kompaktace Claude Code.

Kdy dává smysl

Nástroj je vhodný pro dlouhé technické relace, ve kterých agent opakovaně:

prochází zdrojové soubory,
spouští příkazy a analyzuje logy,
používá MCP nástroje s objemnými výsledky,
potřebuje zachovat konkrétní technické stopy i po zkrácení kontextu.

Přínos bude malý, pokud kontext zaplňují hlavně dlouhé textové zprávy. Tyto zprávy plugin záměrně nemaže ani nezkracuje.

Omezení a práce s daty

Rozhodování neprovádí Claude Code lokálně. Výchozí konfigurace používá model jev-latest přes API TypeSafe. Stav relace tedy odchází k externí službě; před použitím je potřeba posoudit, zda do relace nevstupují data, která tam odesílat nelze.

Jev může starší výsledek vyřadit, i když se později ukáže jako užitečný. Agent musí v takovém případě příslušný nástroj nebo příkaz spustit znovu. Odhad velikosti historie navíc vychází z počtu znaků, ne z přesného tokenizeru.

Obsah