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…

979 ·GitHub
My-claude-code-mods
这是什么？这是 YeonwooSung 为 Claude Code 制作的个人自定义 mod（插件）合集，提供性能分析、上下文浪费分析、带快照的分支式编辑时间线、重复失败检测、置顶备忘、模型努力程度指示器以及一个小型终端游戏等功能。
这是单个工具还是一组独立的插件？它是一组共七个相互独立的 Claude Code 插件（mod），每个都有自己的名称、README 和安装步骤，统一打包在同一个市场仓库里。
怎么安装一个 mod？先把本仓库添加为市场（只需一次），然后按你想安装的 mod 自己的 README，通过 Claude Code 官方 Mods 文档中描述的 plugin@marketplace 机制进行安装。
我需要特定的 Node 或 Claude Code 版本吗？需要——开发和测试要求 Node 22.19.0 或更高版本，并且每个 mod 的引擎测试套件都是针对特定 Claude Code 版本验证的，大多是 2.1.292（Loop Detective 的引擎套件使用 2.1.280）。
所有 mod 都经过完整验证、稳定可靠吗？并不完全是：在抢先体验版的 Claude Code 2.1.280 上，Context Inspector 缺少 session.append，Time Machine 的逐测试项选项会被忽略，Model Effort Band 和 Token Run 的实时像素渲染尚未验证，而且多个 mod 组合使用在真实终端/桌面会话中的整体性能也未经过单元测试套件验证。
agent-profiler 到底测量什么？它展示 Claude Code 会话的时间都花在哪里——模型等待、工具调用、子代理、重复读取——并导出可在 Jaeger 或 Tempo 中查看的 OTLP 追踪数据。
time-machine 能对我的编辑做什么？它把每一次工具调用记录在带 shadow-git 快照的分支时间线上，这样你可以查看任意步骤时文件的样子，弄清是哪次编辑弄坏了测试，还能恢复、分支、对比不同运行以及重跑步骤。
为什么有几个 mod 的文档是韩语的？Context Inspector、Time Machine、Loop Detective、Pin Memo、Model Effort Band 和 Token Run 的文档是韩语（한국어），这反映了作者撰写这些 mod 时自己的工作语言。
token-run 是一个真正能提升效率的功能吗？它是一个轻松有趣的纯本地 ASCII 小游戏，用来打发请求失败或短暂休息时的空闲时间，带有跳跃操作和最高分记录。
What are similar projects?claude-code, gitagent, oh-dsh, memray, claude-devtools, pi-shadow-mind, yazi, kimi-code
Which topics is it in?session, context-window, jest, korean, tracing, opentelemetry, marketplace, claude-code-plugin, debugging, plugin-system, tui, observability
Creator
YeonwooSung
Size
0.8 MB
Stars
979
Updated
CommitOct 17
Age
8d
Commits · 90 Days