my-claude-code-mods README

The project's README from github.com/YeonwooSung/my-claude-code-mods. As one markdown file: README.md.

My Claude Code Mods

Claude Code Mods Overview Create Claude Code Mods

Mods

Development

Use Node 22.19.0 or later. Dependencies are pinned in package-lock.json.

npm ci --ignore-scripts
npm test                  # core logic, no Claude Code installation/account required
CLAUDE_BIN=/path/to/claude npm run test:adapters  # full engine suites, including adapters
npm run typecheck         # requires engine-generated declarations in each .claude-plugin/types

npm test maps the core tests' claude-code/testing import to Node's test runner and Jest's expect; it does not emulate engine events. Files run sequentially so the existing performance assertions do not compete with other test processes. CI runs this independent core suite. Engine type declarations are generated locally and remain untracked; use the declarations belonging to the engine under test. See each mod's development instructions for generation/setup.

Validation target Compatibility
Node core tests Node 22.19.0; TypeScript transformation flag required
Original three engine test suites Verified with Claude Code 2.1.292
Pin Memo engine suite Verified with Claude Code 2.1.292; render trees and Button presses on terminal/Desktop
Loop Detective engine suite Verified with Claude Code 2.1.280; TypeScript checks use local 2.1.292 declarations
Model Effort Band engine suite Verified with Claude Code 2.1.292; terminal/Desktop render trees, live pixels unverified
Token Run engine suite Verified with Claude Code 2.1.292; terminal/Desktop Client keys, buttons and frame clock, live pixels unverified
Early-access Claude Code 2.1.280 Profiler works; Context Inspector lacks session.append, and Time Machine's per-test options are ignored
Live terminal/desktop UI and simultaneous mods Requires a separate interactive integration run; unit suites do not establish UI compatibility

Installation uses plugin@marketplace as described in the official Mods documentation. Add this marketplace once, then install the desired mod using its README.

For a controlled overhead comparison, use a disposable representative large repository at one fixed commit and the same Claude engine/model/permission settings. Run the same workload under four configurations: no mods, profiler only, Time Machine only, and all three. Load mods explicitly with --plugin-dir while other installed plugins are disabled; reset files and recorder stores outside the timed interval. Use a warm-up and at least five measured repetitions per configuration, alternate run order, and record wall time, tool-call count, model tokens and snapshot average. Include no-change mutating calls and actual edits. Report median/p95 and separate model latency from snapshot/hook time. The existing 20k-span/item tests bound analysis cost but do not measure combined engine overhead; no four-mode performance result is claimed here.

my-claude-code-mods (YeonwooSung/my-claude-code-mods)

Searching Database…

Что это такое?Личная коллекция кастомных «модов» (плагинов) для Claude Code, которые добавляют такие вещи, как профилирование производительности, анализ расхода контекста, ветвящуюся шкалу правок со снапшотами, обнаружение повторяющихся сбоев, закреплённые заметки, индикатор усилий модели и небольшую игру в терминале. Автор — YeonwooSung.
Это один инструмент или набор отдельных плагинов?Это набор из семи независимых плагинов (модов) для Claude Code, у каждого своё название, README и шаг установки, а все они собраны вместе в одном репозитории-маркетплейсе.
Как установить мод?Один раз добавьте этот репозиторий как маркетплейс, затем установите нужный мод по его собственному README через механизм plugin@marketplace, как описано в официальной документации по модам Claude Code.
Нужна ли какая-то конкретная версия Node или Claude Code?Да — для разработки и тестов нужен Node 22.19.0 или новее, а наборы тестов каждого мода проверены на конкретной сборке Claude Code, чаще всего 2.1.292 (для набора тестов Loop Detective используется 2.1.280).
Все ли моды полностью проверены и стабильны?Не совсем: в раннем доступе Claude Code 2.1.280 у Context Inspector отсутствует session.append, а у Time Machine игнорируются опции для отдельных тестов; отрисовка живых пикселей у Model Effort Band и Token Run не проверена, а совокупная производительность нескольких модов в реальном терминале или десктопной сессии юнит-тестами не подтверждена.
Что именно измеряет agent-profiler?Он показывает, на что уходит время сессии Claude Code — ожидание модели, вызовы инструментов, субагенты, повторные чтения, — и экспортирует трейсы в формате OTLP, которые можно смотреть в Jaeger или Tempo.
Что time-machine умеет делать с моими правками?Он записывает каждый вызов инструмента на ветвящуюся шкалу времени со снапшотами shadow-git, так что можно посмотреть, какими файлы были на любом шаге, выяснить, какая правка сломала тест, восстановить состояние, ветвиться, сравнивать прогоны и перезапускать шаги.
Почему несколько модов документированы на корейском?Context Inspector, Time Machine, Loop Detective, Pin Memo, Model Effort Band и Token Run задокументированы на корейском (한국어) — это рабочий язык автора для этих модов.
token-run — это настоящая функция для продуктивности?Это несерьёзная полностью локальная ASCII-игрушка, которая заполняет паузы при сбоях запросов или коротких перерывах: с управлением для прыжков и сохранением лучшего результата.
Size
0.8 MB
Stars
979
Updated
CommitOct 17
Age
8d
Commits · 90 Days