# Custom Font Tap — Cursor / LLM context

Read PROJECT.md first for full project description, layout, and workflows.

This repo follows multi-LLM conventions: PROJECT.md (canonical), .github/copilot-instructions.md (GitHub Copilot), .claude/skills/project-context/ (Claude Code / Agent SDK). See PROJECT.md § "LLM / agent context files".

Summary:
- This repo is a Homebrew tap for custom fonts. Fonts live in font_files/font-<name>/ with subdirs ttf/, otf/, web/, other_files/.
- Formula/*.rb are generated by .fontfoldercleanup/create_homebrew_formula.py — do not edit them by hand.
- To add a font: run `uv run add-font <path_or_name>` (or put folder in font_files/, run cleanup_font_folders.py then create_homebrew_formula.py). Then run `uv run pytest tests/` to validate.
- Scripts: Python 3 in .fontfoldercleanup/ (cleanup_font_folders.py, create_homebrew_formula.py). CLI: uv run add-font (tap_cli).