Borrowing it
Nothing to install: this file belongs to lookfree/cc-harness. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/lookfree/cc-harness/main/CLAUDE.mdgit clone --depth 1 https://github.com/lookfree/cc-harnessWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/lookfree/cc-harness/claude-md)<a href="https://agentmods.dev/instructions/lookfree/cc-harness/claude-md"><img src="https://agentmods.dev/badge/instructions/lookfree/cc-harness/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/lookfree/cc-harness/claude-md"><img src="https://agentmods.dev/badge/instructions/lookfree/cc-harness/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.03406 | $0.03406 |
| Opus 5.5 | $0.01362 | $0.01362 |
| Sonnet 5.5 | $0.00681 | $0.00681 |
| Haiku 4.5 | $0.00341 | $0.00341 |
Grade B, and why
cc-harness CLAUDE.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Reads agent configuration directoriesmediumAgent snooping
.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.
- **plugin 是否启用** → `~/.claude/settings.json` 的 `enabledPlugins`(plugin 级,不是版本级)。 How it starts
The opening of the file, as written. The whole thing — 82 lines — stays where its author put it; the contents beside it link to each section on GitHub.
cc-harness
围绕 Claude Code 的桌面工具。Electron + React + TypeScript,双模式(桌面 Electron / Web Express)。
定位正在演进:从一年前的"Claude Code 配置浏览器"重做成 "Harness 工作台"——配置 / 调试 / 观测 / 编排 / 教学 五件事。详细方向、路径、按版本对齐的功能缺口、以及每个功能的可执行 spec,全部在 docs/:
docs/cc-harness演进路径.md—— 产品方向、五支柱、Phase 0/1/2/3 划分(先读这个)。docs/harness-ide-spec/README.md—— 22 个实现 spec 的索引(spec001–022)+ 状态 + 依赖关系。docs/harness-ide-spec/功能版本对照表.md—— 功能 ID(ORCH/OBS/HOOK/PERM/MODEL/SKILL/MISC)↔ Claude Code 版本 ↔ 项目覆盖状态。
动代码前先看对应 spec(spec 引了真实 file:line、给了类型 diff 和验收标准)。改了方向/功能后回头更新这三份文档。
工作方式
- 想清楚再写:先说清假设;有多种理解就摆出来让我选,别默默挑一个;有更简单的做法就直说、该反对就反对;不清楚就停下来问,别猜。
- 最简实现:解决问题的最少代码,不加没要求的功能/抽象/配置/防御。单次使用就别造抽象。写完若 200 行能压到 50,就重写。和项目"不做什么"哲学一致(Thin Harness)。
- 外科手术式改动:只动该动的,每一行改动都能追溯到需求。别顺手"改进"相邻代码/注释/格式,别重构没坏的东西,跟现有风格走。只清理自己改动产生的孤儿(import/变量);遇到无关的既有死代码——提一句,别删(除非明确要求)。
- 目标驱动:把任务变成可验证的成功标准再做。多步任务先列简短计划,每步带验证点(改 X → 验证:Y)。spec 的"验收标准"就是现成的成功标准,照着 loop 到通过。
跑起来
npm install
npm run electron:dev # 桌面端(主模式)
npm run web:dev # Web 模式(Express :3001 + Vite :5173)
npm run electron:build # 出包
⚠️ 已知 build 时序 bug(spec001 修):electron:dev 里 copy:preload 可能在 vite 首次 build 出 dist-electron/ 之前就跑,cp 失败 → preload 没拷过去 → window.electronAPI 全断、IPC 不通。首次启动若 Electron 窗口空白/报 Preload error,先 mkdir -p dist-electron && cp electron/preload.cjs dist-electron/preload.cjs 再重启。彻底修见 spec001。
架构
electron/services/file-manager*.ts # 核心:扫描/读写 ~/.claude 和项目 .claude 配置。
# 按域拆成继承链(base→plugins→skills→agents→hooks→mcp→commands→claudemd→FileManager);
# FileManager 仍是单例门面,对外 API 不变。新增方法放对应 domain 文件,跨域共享的低层 helper 放 base(protected)。
electron/services/provider-manager.ts
electron/ipc/*.ts # 每个域一个 registerXxxHandlers(ipcMain, fileManager)
electron/preload.cjs # contextBridge(必须 .cjs)
server/index.ts # Web 模式 REST,镜像 IPC
src/pages/*.tsx # Dashboard/Skills/Agents/Hooks/MCP/Commands/ClaudeMd/Graph/Models/Settings
src/lib/api.ts # 统一 API,自动探测 Electron(IPC) / Web(HTTP)
shared/types/*.ts # 主进程/渲染进程共享类型
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 82 lines · 3,406 tokens per session scan B aa61d090e129
cc-harness CLAUDE.md is an instructions file published in the GitHub repository lookfree/cc-harness (50 stars, last pushed 2mo ago), licensed MIT. It adds 3,406 tokens to every session, about $0.0136 per session on Opus 5.5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).
vscode model-prompts.instructions.md
Model-specific prompt authoring and registry guidelines.