AI Agent Config Analyzer

Optimize your CLAUDE.md & AGENTS.md for better instruction following

🔒

100% Client-Side Processing — Your Data Never Leaves Your Browser

This tool runs entirely in your browser using JavaScript. No data is sent to any server.

No uploads: Your config content is never transmitted anywhere
No tracking: No analytics, cookies, or telemetry
No storage: Nothing is saved — refresh the page and it's gone
Open analysis: Token counting uses the cl100k_base tokenizer (same as Claude)

Your Config File

How Analysis Works: All processing happens in your browser: tokenization via js-tiktoken (cl100k_base encoding), regex pattern matching for best practices, and structure analysis via markdown parsing. Zero network requests are made during analysis.

Analysis Results

Paste your CLAUDE.md or AGENTS.md content

Checks based on official best practices from Anthropic, OpenAI, Google & community guidelines

Best Practices Verified — Official Sources Only

📏 Optimal Length

LLMs reliably follow ~150-200 instructions. Keep files under 300 lines and ~1500-2500 tokens for best adherence.

Target: <300 lines, <2500 tokens anthropic.com/engineering/claude-code-best-practices

🏗️ Structure

Use clear markdown headers. Include: Commands, Code Style, Architecture, Testing. Avoid code style rules (use linters instead).

## Commands | ## Architecture | ## Testing docs.anthropic.com/en/docs/claude-code/memory

🔐 Security

Never include API keys, passwords, or secrets. Use environment variables and .gitignore for sensitive data.

❌ api_key = "sk-..." | ✓ Use $API_KEY docs.anthropic.com/en/docs/claude-code/security

📦 Modularity

Use @imports for large configs. Create separate files for different concerns. Max 5 levels of nesting.

@./docs/conventions.md docs.anthropic.com/en/docs/claude-code/memory

⚡ Emphasis

Use IMPORTANT, YOU MUST, NEVER for critical instructions. But don't overuse — dilutes priority signals.

IMPORTANT: Always run tests before commit anthropic.com/engineering/claude-code-best-practices

📝 AGENTS.md Standard

Cross-platform config format for AI coding agents. Supported by OpenAI Codex, Google Gemini CLI, Cursor, and more.

Works across multiple AI tools github.com/anthropics/claude-code/blob/main/AGENTS.md

🔌 API & MCP Integration

Use this analyzer programmatically via URL parameters, REST API, or as an MCP server for Claude Code.

CORS is fully open — call from any origin. Rate-limited to prevent abuse. No API key required.

📎 URL Parameters (100% Client-Side)

Pass content via URL for instant analysis. All processing happens in your browser.

https://claudemd.franzai.com/?c=BASE64_CONTENT&o=json

c or content - Base64URL encoded content

o or output - json or html (default: html)

f or format - auto, claude, or agents

JavaScript: const url = `https://claudemd.franzai.com/?c=${btoa(content)}&o=json`;

🌐 REST API (POST)

POST JSON to the API endpoint for programmatic analysis.

POST https://claudemd.franzai.com/api/analyze

Request Body (JSON): { "content": "# CLAUDE.md\n...", "format": "auto" }

curl example:

curl -X POST https://claudemd.franzai.com/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"content": "# CLAUDE.md\n## Commands\n- npm run dev"}'

🤖 MCP Server (Remote)

Connect Claude Code to the remote MCP server. No local setup required!

Add to Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "claudemd-analyzer": {
      "type": "url",
      "url": "https://claudemd.franzai.com/mcp"
    }
  }
}

Available tool: analyze_config
Claude Code will have access to analyze CLAUDE.md files on demand.

Endpoint: https://claudemd.franzai.com/mcp

Test the endpoint: curl https://claudemd.franzai.com/mcp

📋 Response Format

Both URL params (with o=json) and POST API return this structure:

{
  "success": true,
  "version": "2.1.0",
  "result": {
    "score": 85,
    "grade": "excellent",
    "format": "claude",
    "tokenCount": 150,
    "issues": [...],
    "categoryScores": [...]
  }
}