What is normies CLAUDE.md?

A project instruction file for Normies, an AI desktop app designed to help non-technical users build, automate, and connect tools. The project is a monorepo, meaning one repository contains several related applications and shared packages.

Use it to understand the repository layout, package relationships, development commands, and conventions for the Electron app, web viewer, shared code, documentation, and bundled extensions.

It explains how the apps and shared packages fit together, reducing guesswork when changing code across the project.

How yuchenbigpen1/normies configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to yuchenbigpen1/normies. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/yuchenbigpen1/normies/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/yuchenbigpen1/normies

Made for: Claude Code.

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

README.md

[![agentmods](https://agentmods.dev/badge/instructions/yuchenbigpen1/normies/claude-md/github.svg)](https://agentmods.dev/instructions/yuchenbigpen1/normies/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/yuchenbigpen1/normies/claude-md"><img src="https://agentmods.dev/badge/instructions/yuchenbigpen1/normies/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.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/yuchenbigpen1/normies/claude-md"><img src="https://agentmods.dev/badge/instructions/yuchenbigpen1/normies/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 1,136 This file is loaded in full into every session.

When invoked 1,136 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

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.

Model	Per session	Once invoked
Fable 5.1	$0.01136	$0.01136
Opus 5	$0.00568	$0.00568
Sonnet 5	$0.00227	$0.00227
Haiku 4.5	$0.00114	$0.00114

Measured 9d ago against content hash 9d5774998027, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

normies 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 9d 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 · 95 lines

How it starts

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

CLAUDE.md - Normies

Claude Code for people who aren't engineers — an AI desktop app that helps non-technical users build, automate, and connect tools.

Monorepo Structure

normies/
├── apps/
│   ├── electron/              # Electron desktop app (main + renderer)
│   └── viewer/                # Web viewer for shared sessions
├── packages/
│   ├── core/                  # Shared TypeScript types (@normies/core)
│   ├── shared/                # Core business logic — agent, auth, config, MCP, prompts, sessions (@normies/shared)
│   ├── ui/                    # Shared React UI components (@normies/ui)
│   └── mermaid/               # Mermaid diagram renderer (@normies/mermaid)
├── superpowers/               # Skills, hooks, and agents bundled with the app
├── scripts/                   # Build, release, and dev scripts
├── docs/                      # Mintlify documentation site
└── claude-code-prompt-improver/  # Claude Code plugin for prompt improvement

How Packages Connect

@normies/shared is the heart — contains agent logic, auth, config, MCP, sessions, prompts
@normies/core provides shared types consumed by shared and electron
Electron app → @normies/shared → @normies/core
Viewer app → @normies/ui
Superpowers are loaded at runtime by the agent (skills, hooks, agents)

Key Commands

All commands run from the monorepo root with bun:

bun test — run tests
bun run typecheck — typecheck shared package
bun run typecheck:all — typecheck core + shared
bun run electron:dev — start electron in dev mode
bun run electron:build — build electron app
bun run viewer:dev — start viewer in dev mode
bun run lint — lint electron + shared

Conventions

Package manager: bun — NOT npm/yarn/pnpm
Monorepo: npm workspaces (defined in root package.json), symlinked via postinstall script
TypeScript: .ts extensions in imports, strict mode, allowImportingTsExtensions
Package imports: @normies/core, @normies/shared, @normies/ui, @normies/mermaid
Subpath exports in shared: @normies/shared/agent, @normies/shared/config, @normies/shared/credentials, @normies/shared/mcp, @normies/shared/sources, @normies/shared/statuses, @normies/shared/utils
UI stack: React 18, Tailwind CSS v4, Radix UI primitives, Jotai for state, Lucide icons
Build tooling: esbuild for electron, Vite for viewer/marketing

Read the full file on GitHub · 95 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.

9d ago First seen · 95 lines · 1,136 tokens per session scan A 9d5774998027

Subscribe to this mod's changes

normies CLAUDE.md is an instructions file published in the GitHub repository yuchenbigpen1/normies (4 stars, last pushed 5mo ago), licensed Apache-2.0. It adds 1,136 tokens to every session, about $0.0057 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.

Claude Code ai-agents codex-cli context-engineering electron mcp

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.

vercel/next.js · 7,296 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,153 tokens

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

normies: Instructions file for Claude Code