Borrowing it
Nothing to install: this file belongs to eddiesanjuan/markupr. 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/eddiesanjuan/markupr/main/CLAUDE.mdgit clone --depth 1 https://github.com/eddiesanjuan/markuprWrote 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/eddiesanjuan/markupr/claude-md)<a href="https://agentmods.dev/instructions/eddiesanjuan/markupr/claude-md"><img src="https://agentmods.dev/badge/instructions/eddiesanjuan/markupr/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/eddiesanjuan/markupr/claude-md"><img src="https://agentmods.dev/badge/instructions/eddiesanjuan/markupr/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.02979 | $0.02979 |
| Opus 5 | $0.01489 | $0.01489 |
| Sonnet 5 | $0.00596 | $0.00596 |
| Haiku 4.5 | $0.00298 | $0.00298 |
Grade A, and why
markupr 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 8d 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.
How it starts
The opening of the file, as written. The whole thing — 232 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md - markupR
Project Overview
markupR is a macOS/Windows menu bar app and CLI/MCP tool that intelligently captures developer feedback. It records your screen and voice simultaneously, then uses an intelligent post-processing pipeline to correlate transcript timestamps with the screen recording -- extracting the right frames at the right moments and stitching everything into a structured, AI-ready Markdown document. The output is purpose-built for AI coding agents: every screenshot placed exactly where it belongs, every issue clearly documented.
As of v2.5.0, markupR also ships as:
- CLI tool (
npx markupr analyze ./recording.mov) -- headless video analysis pipeline - MCP server (
npx --package markupr markupr-mcp) -- Model Context Protocol server for AI coding agents (capture screenshots, analyze video, start/stop recordings) - GitHub Action (
eddiesanjuan/markupr-action@v1) -- CI/CD visual feedback on PRs
Version: 2.6.0 License: MIT (Open Source)
Tech Stack
- Framework: Electron + React + TypeScript
- Build: electron-vite + Vite (desktop), esbuild (CLI/MCP)
- Transcription: Local Whisper (default), OpenAI Whisper-1 API (optional cloud)
- AI Analysis: Anthropic Claude API (BYOK or premium tier)
- Testing: Vitest (unit, integration, e2e)
- Package: electron-builder (DMG, NSIS, AppImage)
- Styling: Tailwind CSS
- Schema Validation: Zod
- MCP: @modelcontextprotocol/sdk
Architecture
src/
├── main/ # Electron main process
│ ├── index.ts # Entry point, window management, IPC orchestration
│ ├── SessionController.ts # 7-state FSM with watchdog timer
│ ├── CrashRecovery.ts # Auto-save every 5s, crash detection, recovery dialog
│ ├── ErrorHandler.ts # Centralized error handling
│ ├── HotkeyManager.ts # Global hotkey registration
│ ├── MenuManager.ts # Application menu
│ ├── TrayManager.ts # Menu bar tray icon and status
│ ├── PermissionManager.ts # macOS permission checks
│ ├── AutoUpdater.ts # Auto-update via electron-updater
│ ├── ai/ # AI analysis pipeline (Claude)
│ │ ├── AIPipelineManager.ts # Orchestrates AI analysis (free/byok/premium tiers)
│ │ ├── ClaudeAnalyzer.ts # Claude API integration
│ │ ├── ImageOptimizer.ts # Screenshot optimization for API
│ │ ├── StructuredMarkdownBuilder.ts # AI-enhanced markdown output
│ │ └── types.ts # AI pipeline types
│ ├── analysis/ # Feedback analysis and categorization
│ ├── audio/ # Microphone capture, VAD
│ ├── capture/ # Screen capture via desktopCapturer
│ ├── ipc/ # IPC handler registration and routing
│ ├── output/ # Document generation and export
│ │ ├── MarkdownGenerator.ts # llms.txt-inspired markdown output
│ │ ├── ExportService.ts # Multi-format export (MD, PDF, HTML, JSON)
│ │ ├── ClipboardService.ts # Clipboard bridge (copies file path)
│ │ ├── FileManager.ts # Session file management
│ │ └── sessionAdapter.ts # Type conversion utilities
│ ├── pipeline/ # Post-processing pipeline
│ │ ├── PostProcessor.ts # Pipeline orchestrator (transcribe -> analyze -> extract -> generate)
│ │ ├── TranscriptAnalyzer.ts # Heuristic key-moment detection
│ │ └── FrameExtractor.ts # ffmpeg-based video frame extraction
│ ├── platform/ # Platform-specific code (Windows taskbar)
│ ├── settings/ # Persistent settings with secure API key storage
│ ├── transcription/ # Transcription tier management
│ │ ├── TierManager.ts # Tier selection (Whisper, timer-only)
│ │ ├── WhisperService.ts # Local Whisper integration
│ │ └── ModelDownloadManager.ts # Whisper model download from HuggingFace
│ └── windows/ # Window management (popover, taskbar)
├── cli/ # Headless CLI tool
│ ├── index.ts # CLI entry point (commander-based)
│ ├── CLIPipeline.ts # Video analysis pipeline (ffmpeg + Whisper + markdown)
│ ├── WatchMode.ts # Watch directory for new recordings
│ ├── doctor.ts # System dependency checker (ffmpeg, Whisper, etc.)
│ └── init.ts # Project config scaffolding (.markupr.json)
├── mcp/ # MCP server for AI coding agents
│ ├── index.ts # MCP entry point
│ ├── server.ts # MCP server setup
│ ├── tools/ # MCP tool implementations
│ │ ├── analyzeScreenshot.ts # Analyze a screenshot with Claude
│ │ ├── analyzeVideo.ts # Analyze a video recording
│ │ ├── captureScreenshot.ts # Capture a screenshot
│ │ ├── captureWithVoice.ts # Capture with voice narration
│ │ ├── describeScreen.ts # AI agents can see the user's screen
│ │ ├── pushToGitHub.ts # Push feedback to GitHub Issues
│ │ ├── pushToLinear.ts # Push feedback to Linear
│ │ ├── startRecording.ts # Start a recording session
│ │ └── stopRecording.ts # Stop a recording session
│ ├── session/ # MCP session management
│ ├── capture/ # MCP capture utilities
│ ├── utils/ # MCP utilities
│ ├── resources/ # MCP resource definitions
│ └── types.ts # MCP type definitions
├── renderer/ # React UI
│ ├── App.tsx # Main component with state machine UI
│ ├── AppWrapper.tsx # Root wrapper with providers
│ ├── components/ # UI components
│ │ ├── AnnotationOverlay.tsx # Drawing tools (arrow, circle, rect, freehand, text)
│ │ ├── AudioWaveform.tsx # Real-time audio level visualization
│ │ ├── CrashRecoveryDialog.tsx # Crash recovery UI
│ │ ├── DonateButton.tsx # Rotating donate messages
│ │ ├── ModelDownloadDialog.tsx # Whisper model download UI
│ │ ├── Onboarding.tsx # First-run experience
│ │ ├── SessionHistory.tsx # Session browser
│ │ ├── SessionReview.tsx # Post-recording review/edit
│ │ ├── SettingsPanel.tsx # Settings configuration
│ │ └── ... # Other UI components
│ ├── audio/ # Renderer-side audio capture bridge
│ ├── capture/ # Renderer-side screen recording (MediaRecorder)
│ └── hooks/ # React hooks (theme, animation)
├── preload/ # Context bridge (secure IPC)
└── shared/ # Types shared between processes
├── types.ts # IPC channels, payload types, state types
└── hotkeys.ts # Hotkey configuration types
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.
- 8d ago First seen · 232 lines · 2,979 tokens per session scan A 31dc05b776c3
markupr CLAUDE.md is an instructions file published in the GitHub repository eddiesanjuan/markupr (18 stars, last pushed 4mo ago), licensed MIT. It adds 2,979 tokens to every session, about $0.0149 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-30.
Other instructions, from other repositories
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.
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.
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).
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).
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.
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.