$ style-dna analyze ./my_web_app

Analyzed 42 files from './my_web_app' (0 Python, 42 Web).
Style profile saved to: style_profile.json

## Web Conventions
- Detected frameworks/tools: Next.js, React, Tailwind CSS, TypeScript.

### JavaScript / TypeScript
- Use single quotes for JS/TS strings.
- Omit semicolons at end of statements.
- Prefer arrow functions (`const fn = () => {}`).
- Prefer named exports.
- Use path aliases (`@/...`) for imports instead of deep relative paths.
- Prefer `interface` over `type` for object shapes in TypeScript.

### React / Next.js
- Next.js routing: App Router (`app/`).
- Define React components as arrow functions (`const Button = () => ...`).
- Component file naming: PascalCase.
- ~40% of components use 'use client' directive.
- State management: zustand.

### CSS / Styling
- Styling approach: Tailwind CSS utility classes.
- Uses CSS custom properties (`var(--token-name)`) for design tokens.
- Preferred color format: HSL.

uvx style-dna-ghostwriter init

{
  "mcpServers": {
    "style-dna": {
      "command": "uvx",
      "args": ["style-dna-ghostwriter", "mcp"]
    }
  }
}

# Verify a Python, TypeScript, or React file:
style-dna check ./src/components/ProductCard.tsx

# Output:
# FAIL: ProductCard.tsx - 2 violation(s) found:
#   [WARN]  line 12 [style.semicolons] Remove trailing semicolon - this repo omits them.
#   [INFO]  line 24 [style.imports]    Use path aliases (`@/...`) instead of relative paths - repo convention.

# Automatically install pre-commit hook in .git/hooks/
style-dna hook install

# Uninstallation:
style-dna hook uninstall

style-dna show style_profile.json --scope compact

# Output:
# ## Style DNA (Compact)
# - Web: Next.js App Router, state: zustand, styling: tailwind.
# - JS/TS: single quotes, prefer interface, path aliases (@/...).

style-dna monorepo . --out .style-dna/packages/

- name: Extract & Verify Style DNA
  uses: kaifazad/style-dna-ghostwriter@v0.2.0
  with:
    path: "."
    write-convention-files: "true"

style-dna-ghostwriter/
├── style_dna/
│   ├── analyzer.py         # multi-language scanner + workspace boundary guard
│   ├── profile.py          # StyleProfile model + scoped rules + freshness tracking
│   ├── verifier.py         # AST & regex style convention checker & linter
│   ├── monorepo.py         # workspace & multi-package convention analyzer
│   ├── generator.py        # profile -> system prompt -> Claude API call
│   ├── mcp_server.py       # MCP server (tools, scoped resources, prompts)
│   ├── conventions.py      # upserts rules into CLAUDE.md/AGENTS.md/.cursorrules/etc.
│   ├── cli.py              # CLI (init, analyze, show, check, hook, monorepo, mcp)
│   ├── __main__.py         # package entrypoint for python -m style_dna
│   └── extractors/         # Python, JS/TS, React/Next.js, CSS/Tailwind, HTML
├── examples/
│   ├── sample_repo/        # Python test fixture
│   └── sample_web_repo/    # Next.js 14 + React TSX + Tailwind test fixture
└── tests/                  # Complete test suite (153 tests)

# Core only (zero external dependencies):
pip install -e .

# With MCP server support:
pip install -e ".[mcp]"

# With direct Claude code generation support:
pip install -e ".[generate]"

# All features:
pip install -e ".[all]"

# One-shot setup for any repo (Python, React, Next.js, etc.):
style-dna init

# Inspect codebase style rules:
style-dna analyze ./my_repo --out style_profile.json
style-dna show style_profile.json
style-dna show style_profile.json --scope compact     # dense, token-saving summary

# Verify code adheres to extracted conventions:
style-dna check ./src/App.tsx

# Install automatic pre-commit git hook:
style-dna hook install

# Analyze monorepos with per-package rules:
style-dna monorepo . --out .style-dna/packages/

# Direct generation (requires ANTHROPIC_API_KEY):
export ANTHROPIC_API_KEY=sk-...
style-dna generate style_profile.json \
  "Write a React component that displays a product card with add to cart button" \
  --out ProductCard.tsx

from style_dna import analyze_codebase
from style_dna.generator import generate_code

profile = analyze_codebase("./my_repo")
code = generate_code(profile, "Add a custom hook to manage user favorites")

pip install -e ".[dev]"
python -m pytest tests/ -v