clearjson CLAUDE.md

Project instructions for ClearJSON, a privacy-focused Chrome extension that displays JSON data in a readable form. They describe its code structure, design rules, tests, and related tools.

In plain words
What is it for?
Use them when changing ClearJSON code, user-interface styles, Chrome extension files, tests, or its MCP server (a tool interface for working with JSON).
Why use it?
They give a coding agent the project context and constraints needed to make changes that fit the existing extension. This reduces guesswork about architecture, styling, and validation.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/wayknow/clearjson/claude-md
Clone the repo
git clone --depth 1 https://github.com/wayknow/clearjson
Per session 1,241 This file is loaded in full into every session.
When invoked 1,241 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5 $0.01241 $0.01241
Opus 5 $0.00620 $0.00620
Sonnet 5 $0.00248 $0.00248
Haiku 4.5 $0.00124 $0.00124

Measured 2d ago against content hash 21c145e543eb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

clearjson CLAUDE.md scanned grade A with 0 findings 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 2d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 74 lines

How it starts

The opening of the file, as written. The whole thing — 74 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ClearJSON — 隐私优先的浏览器 JSON 查看器

Chrome 扩展(MV3)。v1.0.0 免费版已上架 Chrome Web Store。

项目概览

  • 技术栈:Vanilla JS + IIFE 模块模式,零框架依赖,CSS 变量驱动主题
  • 测试npm test(136 个单元测试,Node 原生 test runner,零外部依赖)
  • 当前状态:无技术债,所有核心 + Pro 功能已实现
  • MCP Serverclearjson-mcp/ — 7 个 JSON 工具 + 3 个许可证管理工具,已发布 npm v1.1.0(npx -y clearjson-mcp
  • 详细状态STATUS.md
  • 功能列表features.md
  • Agent-First 路线AGENT_FIRST.md

关键架构

  • 模块通过 manifest.json 的 js 数组按序加载,挂载到 window.ClearJSON 命名空间
  • 加载顺序:parser.js → tokenizer.js → themes.js → license.js → export.js → jwt.js → stream-parser.js → virtual-tree.js → tree.js → content.js
  • Pro 功能门控:ClearJSON.License.isActive()
  • 开发模式绕过 Pro:localStorage.setItem('clearjson_pro_dev', '1')
  • 本地测试服务器:node test-data/server.js(端口 8765,自动启用 Pro)
  • 许可证服务器:Cloudflare Worker + D1,域名 api.wayknow.tech/clearjson/
  • 竞品定位:替代被卖后注入广告的 JSON Formatter;商业模式:免费核心 + Pro 订阅($2.99/月 或 $19.99/年)
  • 不做:AI、JSON Diff、JSONPath 查询、高级编辑、云端同步、用户账号(注:订阅制已做,2026-08-15 起;JSON Diff/JSONPath 是 2.0 路线图)

设计系统

所有 UI 相关任务必须遵循以下规范。

Chrome 扩展约束

  • 技术栈:Vanilla HTML/CSS/JS,零框架,零构建步骤
  • 样式:全部写在 .css 文件,禁止内联 style 属性
  • Popup 窗口:最大宽度 400px,紧凑布局,无滚动条溢出
  • 图标:内联 SVG 或 PNG,禁止外部字体/图标库(CSP 限制)
  • 字体栈:system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif
  • 颜色:暗色主题为主,CSS 变量定义,支持通过 prefers-color-scheme 响应
  • 禁止:外部 CSS/JS CDN、Google Fonts、第三方 UI 库

视觉规范

  • 间距:4px 基数系统(4, 8, 12, 16, 24, 32)
  • 圆角:按钮/输入框 6px,卡片 12px,模态框 16px
  • 阴影:仅用于模态和浮动元素,0 4px 12px rgba(0,0,0,0.3)
  • 边框:1px rgba(255,255,255,0.08) 分隔线
  • 主色调:#3B82F6(操作按钮)、#10B981(成功)、#EF4444(危险)
  • 背景层级:#0F0F0F(底层)→ #1A1A1A(卡片)→ #242424(悬浮)

动画与微交互

  • 仅 CSS transition,禁止 JS 动画库
  • 时长 ≤ 200ms,使用 ease-outcubic-bezier(0.4, 0, 0.2, 1)
  • 仅操作 transformopacity,避免触发布局重排
  • 按钮 hover:opacity 0.8 → 1.0,或 translateY(-1px)
  • 加载状态:CSS 脉冲动画,禁止 GIF/视频
  • 尊重 prefers-reduced-motion

组件规范

  • 按钮:明确 hover/active/focus-visible 状态,focus 用 2px outline
  • 输入框:可见标签 + 错误状态,placeholder 颜色 #6B7280
  • 卡片:一致的内边距(16px),无突兀阴影
  • 图标按钮:24×24pt,aria-label 必须
  • Toast 通知:底部居中,自动消失(3s),CSS slide-up 进入

Read the full file on GitHub · 74 lines

Changes

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.

  1. 2d ago First seen · 74 lines · 1,241 tokens per session scan A 21c145e543eb

Subscribe to this mod's changes

clearjson CLAUDE.md is an instructions file published in the GitHub repository wayknow/clearjson (0 stars, last pushed 14d ago), licensed MIT. It adds 1,241 tokens to every session, about $0.0062 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

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).

microsoft/vscode · 6,785 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,182 tokens

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.

langchain-ai/langchain · 4,345 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

next.js AGENTS.md

Instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens