{"_id":"better-icons","_rev":"6-e0fb5d08b08fc00202c2dd748deb474b","name":"better-icons","dist-tags":{"beta":"1.0.3-beta.2","latest":"1.0.4"},"versions":{"1.0.0":{"name":"better-icons","version":"1.0.0","keywords":["mcp","icons","iconify","svg","ai","cursor","claude","model-context-protocol"],"author":{"name":"bekacru"},"license":"MIT","_id":"better-icons@1.0.0","maintainers":[{"name":"bekacru","email":"Bekacru@gmail.com"}],"homepage":"https://github.com/bekacru/better-icons#readme","bugs":{"url":"https://github.com/bekacru/better-icons/issues"},"bin":{"better-icons":"dist/cli.js"},"dist":{"shasum":"eb7bc873cc64fb9223911a2fa4a703d69d24b7a3","tarball":"https://registry.npmjs.org/better-icons/-/better-icons-1.0.0.tgz","fileCount":5,"integrity":"sha512-/XAG4UFQ9BwPqBci8uWZdw2LW5lWv0/ckPWaRn3K2wcFhxy+U91kp8w6HF+ATc35suvZyhcY6NsNf7bs+vnD2Q==","signatures":[{"sig":"MEUCIGHU91U/XZfTGU0y9g2f45NCpH9KUzClTnQidQxEkZGdAiEA/kqzWx9VCxFuA2lA5i8shWTPxqRWbC3vb/orz1+ee/8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":574968},"main":"dist/cli.js","type":"module","engines":{"node":">=18"},"scripts":{"build":"bun build ./cli.ts --outdir dist --target node --minify","start":"bun run index.ts","prepublishOnly":"bun run build"},"_npmUser":{"name":"bekacru","email":"Bekacru@gmail.com"},"repository":{"url":"git+https://github.com/bekacru/better-icons.git","type":"git"},"_npmVersion":"11.3.0","description":"MCP server for searching and retrieving icons from 200+ icon libraries powered by Iconify","directories":{},"_nodeVersion":"24.0.1","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"peerDependencies":{"typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/better-icons_1.0.0_1769034488379_0.4240254878766394","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"better-icons","version":"1.0.1","keywords":["mcp","icons","iconify","svg","ai","cursor","claude","model-context-protocol"],"author":{"name":"bekacru"},"license":"MIT","_id":"better-icons@1.0.1","maintainers":[{"name":"bekacru","email":"Bekacru@gmail.com"}],"homepage":"https://github.com/bekacru/better-icons#readme","bugs":{"url":"https://github.com/bekacru/better-icons/issues"},"bin":{"better-icons":"dist/index.js"},"dist":{"shasum":"436474ccada75ad76421d0983b1e072586fc90fd","tarball":"https://registry.npmjs.org/better-icons/-/better-icons-1.0.1.tgz","fileCount":4,"integrity":"sha512-SjadW9OpLM+tWbHDaNgrEwKRwQSsKatyYkMk5dYnHk+AMM3kpVD4XSkyGyWTyEIdVJlie0nWESZNDu9zfjjE4g==","signatures":[{"sig":"MEMCIF3D7uHoEBtMzQCpF3TJzdYbjeFUWwSomdtRohwAIw1nAh9w0sX85Fx0KwyeIUKdrucP4MattDrnUwveAuzs5z34","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":637623},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"d8191f4949aa5c5da4dc5268ea4813cbd5d62390","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build ./src/index.ts --outdir dist --target node --minify","prepublishOnly":"bun run build"},"_npmUser":{"name":"bekacru","email":"Bekacru@gmail.com"},"repository":{"url":"git+https://github.com/bekacru/better-icons.git","type":"git"},"_npmVersion":"11.3.0","description":"MCP server for searching and retrieving icons from 200+ icon libraries powered by Iconify","directories":{},"_nodeVersion":"24.0.1","dependencies":{"chalk":"^5.3.0","commander":"^12.0.0","@clack/prompts":"^0.7.0","@modelcontextprotocol/sdk":"^1.25.3"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"peerDependencies":{"typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/better-icons_1.0.1_1769037694244_0.128924514647754","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"better-icons","version":"1.0.2","keywords":["mcp","icons","iconify","svg","ai","cursor","claude","model-context-protocol"],"author":{"name":"bekacru"},"license":"MIT","_id":"better-icons@1.0.2","maintainers":[{"name":"bekacru","email":"Bekacru@gmail.com"}],"homepage":"https://github.com/bekacru/better-icons#readme","bugs":{"url":"https://github.com/bekacru/better-icons/issues"},"bin":{"better-icons":"dist/index.js"},"dist":{"shasum":"98f01a5dcd7011f04b6297c131038c78d28bbfe6","tarball":"https://registry.npmjs.org/better-icons/-/better-icons-1.0.2.tgz","fileCount":4,"integrity":"sha512-yCR30VUlsAhCWb5xvV0FIMoTQoUmw6CWNKrPL4+iXwoUq7k9KjDLQlW0U1ExsI+f6IylI/xBec215WhEXZTJ4g==","signatures":[{"sig":"MEUCIC0DlCVQNnb9ht36mqJwaW6IGRFGfwwMUVN5UdMJWjREAiEAgx3YWPKkCZWInlJr9XBma0af6dBh1yyXbLc3T5Yy5u0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":653421},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"6a5a9f188357be4c74adedc6c32898bb3d6db132","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build ./src/index.ts --outdir dist --target node --minify","prepublishOnly":"bun run build"},"_npmUser":{"name":"bekacru","email":"Bekacru@gmail.com"},"repository":{"url":"git+https://github.com/bekacru/better-icons.git","type":"git"},"_npmVersion":"11.3.0","description":"MCP server for searching and retrieving icons from 200+ icon libraries powered by Iconify","directories":{},"_nodeVersion":"24.0.1","dependencies":{"chalk":"^5.3.0","commander":"^12.0.0","@clack/prompts":"^0.7.0","@modelcontextprotocol/sdk":"^1.25.3"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"peerDependencies":{"typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/better-icons_1.0.2_1769041993065_0.9744124616865173","host":"s3://npm-registry-packages-npm-production"}},"1.0.3-beta.2":{"name":"better-icons","version":"1.0.3-beta.2","keywords":["mcp","icons","iconify","svg","ai","cursor","claude","model-context-protocol"],"author":{"name":"bekacru"},"license":"MIT","_id":"better-icons@1.0.3-beta.2","maintainers":[{"name":"bekacru","email":"Bekacru@gmail.com"}],"homepage":"https://github.com/better-auth/better-icons#readme","bugs":{"url":"https://github.com/better-auth/better-icons/issues"},"bin":{"better-icons":"dist/index.js"},"dist":{"shasum":"96dd47ca57c0efd1d2454880e1a2ad959af10913","tarball":"https://registry.npmjs.org/better-icons/-/better-icons-1.0.3-beta.2.tgz","fileCount":4,"integrity":"sha512-JaCRp+Z4VN+Xz0idF6bFwjerPQlO6pXWfWv3fgAzOe5clqp+s4zHx75fC57uIUNyPXj4l7K9Hv/OdTGgnb58Dg==","signatures":[{"sig":"MEUCIBK1LjT1ADYyJKCF8zSgjY3/czb+MNeDjFwcj1a9zG64AiEAp6gr4PH64M12AJ7VD4IohibW5sAt46mxFKcgc1qZNuA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/better-icons@1.0.3-beta.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":657195},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"4b254d38890ba0b7c95bedf15c80bc48f75e96b2","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build ./src/index.ts --outdir dist --target node --minify","release":"bumpp --commit --push --tag","prepublishOnly":"bun run build"},"_npmUser":{"name":"bekacru","email":"Bekacru@gmail.com"},"repository":{"url":"git+https://github.com/better-auth/better-icons.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for searching and retrieving icons from 200+ icon libraries powered by Iconify","directories":{},"_nodeVersion":"18.20.8","dependencies":{"chalk":"^5.3.0","commander":"^12.0.0","@clack/prompts":"^0.7.0","@modelcontextprotocol/sdk":"^1.25.3"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"bumpp":"^10.4.0","@types/bun":"latest"},"peerDependencies":{"typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/better-icons_1.0.3-beta.2_1769066959354_0.6173343616521079","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"better-icons","version":"1.0.3","keywords":["mcp","icons","iconify","svg","ai","cursor","claude","model-context-protocol"],"author":{"name":"bekacru"},"license":"MIT","_id":"better-icons@1.0.3","maintainers":[{"name":"bekacru","email":"Bekacru@gmail.com"}],"homepage":"https://github.com/better-auth/better-icons#readme","bugs":{"url":"https://github.com/better-auth/better-icons/issues"},"bin":{"better-icons":"dist/index.js"},"dist":{"shasum":"9e0163f28874eb230254e209b3354c31411ba408","tarball":"https://registry.npmjs.org/better-icons/-/better-icons-1.0.3.tgz","fileCount":4,"integrity":"sha512-zXmA+atW2czo9YE0eD3NuI2BBWlKKmB59UzHtL7pFfbDZEUKPdeO4TbkVhXK73PkAJEF3P4s3fQgGgI8BGfNNg==","signatures":[{"sig":"MEQCIBg/Bv2udY2VEGjfzHCGrpDGtY8kJ0q4qKFXrfFyJNHQAiAX4i6yUTK1QsRUF4Tj/wrVwdN8dgO46I8NIAdeTuQdjw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/better-icons@1.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":657188},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"26dbd57ffc02a66440c3800f61ef8f0c79c28e77","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build ./src/index.ts --outdir dist --target node --minify","release":"bumpp --commit --push --tag","prepublishOnly":"bun run build"},"_npmUser":{"name":"bekacru","email":"Bekacru@gmail.com"},"repository":{"url":"git+https://github.com/better-auth/better-icons.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for searching and retrieving icons from 200+ icon libraries powered by Iconify","directories":{},"_nodeVersion":"18.20.8","dependencies":{"chalk":"^5.3.0","commander":"^12.0.0","@clack/prompts":"^0.7.0","@modelcontextprotocol/sdk":"^1.25.3"},"_hasShrinkwrap":false,"devDependencies":{"bumpp":"^10.4.0","@types/bun":"latest"},"peerDependencies":{"typescript":"^5"},"_npmOperationalInternal":{"tmp":"tmp/better-icons_1.0.3_1769067001117_0.45202702584958665","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"better-icons","version":"1.0.4","description":"MCP server for searching and retrieving icons from 200+ icon libraries powered by Iconify","author":{"name":"bekacru"},"license":"MIT","type":"module","main":"dist/index.js","bin":{"better-icons":"dist/index.js"},"scripts":{"build":"bun build ./src/index.ts --outdir dist --target node --minify","dev":"bun run src/index.ts","test":"bun test","prepublishOnly":"bun run build","release":"bumpp --commit --push --tag"},"keywords":["mcp","icons","iconify","svg","ai","cursor","claude","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/better-auth/better-icons.git"},"dependencies":{"@clack/prompts":"^0.7.0","@modelcontextprotocol/sdk":"^1.25.3","chalk":"^5.3.0","commander":"^12.0.0"},"devDependencies":{"@types/bun":"latest","bumpp":"^10.4.0"},"peerDependencies":{"typescript":"^5"},"engines":{"node":">=18"},"_id":"better-icons@1.0.4","gitHead":"4ab36e95dfc818a6e8a2bfc6f8dcf982c1c5c926","bugs":{"url":"https://github.com/better-auth/better-icons/issues"},"homepage":"https://github.com/better-auth/better-icons#readme","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-VivhTcSKAyoOAJV7CntwkNPi+CKeemjB7Rli5kOfoyGJr+I36UN9g2EyRodr7wmfGIkQ4AIZOZxL6phJKSj34Q==","shasum":"6f8e3e9d166d23886820c31f3d877a6e94aca903","tarball":"https://registry.npmjs.org/better-icons/-/better-icons-1.0.4.tgz","fileCount":4,"unpackedSize":657619,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/better-icons@1.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDQgJ08mjaWWRcVmvENqNwGCAPofbdmyT6xwh4sN/cbfAIhAOVSWD91w/uhoIHPM0vHWTcR5NVzpKP4JuYhyJpSHCfl"}]},"_npmUser":{"name":"bekacru","email":"Bekacru@gmail.com"},"directories":{},"maintainers":[{"name":"bekacru","email":"Bekacru@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/better-icons_1.0.4_1769093487357_0.7151462112276468"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-21T22:28:08.226Z","modified":"2026-01-22T14:51:27.814Z","1.0.0":"2026-01-21T22:28:08.603Z","1.0.1":"2026-01-21T23:21:34.404Z","1.0.2":"2026-01-22T00:33:13.284Z","1.0.3-beta.2":"2026-01-22T07:29:19.500Z","1.0.3":"2026-01-22T07:30:01.316Z","1.0.4":"2026-01-22T14:51:27.552Z"},"bugs":{"url":"https://github.com/better-auth/better-icons/issues"},"author":{"name":"bekacru"},"license":"MIT","homepage":"https://github.com/better-auth/better-icons#readme","keywords":["mcp","icons","iconify","svg","ai","cursor","claude","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/better-auth/better-icons.git"},"description":"MCP server for searching and retrieving icons from 200+ icon libraries powered by Iconify","maintainers":[{"name":"bekacru","email":"Bekacru@gmail.com"}],"readme":"# Better Icons\n\nSearch and retrieve 200,000+ icons from 150+ icon collections. Works as an MCP server for AI agents or CLI tool.\n\n## Quick Start\n\n### Add SKills\n\nYou can enable the underlying icons cli usage using skills\n\n```bash\nnpx add-skill better-auth/better-icons\n```\n\n### MCP Server (AI Agents)\n\nConfigure the MCP server to enable icon tools in your AI coding agents.\n\n```bash\nnpx better-icons setup\n```\n\nThis interactively configures the MCP server for:\n- **Cursor**\n- **Claude Code**\n- **OpenCode**\n- **Windsurf**\n- **VS Code (Copilot)**\n\nOr [configure manually](#manual-installation).\n\n### CLI (Direct Usage)\n\nUse the CLI to search and retrieve icons directly from your terminal.\n\n```bash\n# Search for icons\nnpx better-icons search arrow\nnpx better-icons search home --prefix lucide --limit 10\n\n# Get icon SVG (outputs to stdout)\nnpx better-icons get lucide:home > icon.svg\nnpx better-icons get mdi:account --color '#333' --size 24\n\n# JSON output for scripting\nnpx better-icons search settings --json | jq '.icons[:5]'\nnpx better-icons get heroicons:check --json\n```\n\n## Why?\n\nIcons are a common pain point in AI-assisted coding. Models often struggle to know which icons are available, generate correct SVG code, maintain consistent styles, and organize icons properly. Inline SVGs also consume unnecessary tokens.\n\n## Features\n\n- **200,000+ Icons** - Search across 150+ icon collections (Lucide, Heroicons, Material Design, etc.)\n- **Auto-Learning** - Remembers which icon collections you use and prioritizes them in future searches\n- **Project Sync** - Icons are written directly to your icons file (`.tsx`, `.ts`, `.js`) instead of pasting SVG into chat (saves tokens!)\n- **Batch Retrieval** - Get multiple icons at once\n- **Similar Icons** - Find the same icon across different collections and styles\n- **Recent Icons** - Quick access to icons you've used before\n- **Multi-Framework** - React, Vue, Svelte, Solid, and raw SVG exports\n\n## Manual Installation\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"better-icons\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"better-icons\"]\n    }\n  }\n}\n```\n\n### Claude Code (CLI)\n\nAdd to `~/.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"better-icons\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"better-icons\"]\n    }\n  }\n}\n```\n\n## MCP Tools\n\nThe following tools are available when using the MCP server with AI agents.\n\n### `search_icons`\n\nSearch for icons across 150+ icon collections.\n\n```\nSearch for \"arrow\" icons\nSearch for \"home\" icons in the lucide collection\n```\n\n**Parameters:**\n- `query` (required): Search query (e.g., 'arrow', 'home', 'user')\n- `limit` (optional): Maximum results (1-999, default: 32)\n- `prefix` (optional): Filter by collection (e.g., 'mdi', 'lucide')\n- `category` (optional): Filter by category\n\n### `get_icon`\n\nGet the SVG code for a specific icon with multiple usage formats.\n\n```\nGet the SVG for mdi:home\nGet a URL for mdi:home\nGet lucide:arrow-right with size 24\n```\n\n**Parameters:**\n- `icon_id` (required): Icon ID in format 'prefix:name' (e.g., 'mdi:home')\n- `color` (optional): Icon color (e.g., '#ff0000', 'currentColor')\n- `size` (optional): Icon size in pixels\n- `format` (optional): 'svg' (default) or 'url'\n\n**Returns:**\n- Raw SVG code\n- React/JSX component code\n- Iconify component usage\n- Direct SVG URL (when `format: \"url\"`)\n\n### `list_collections`\n\nList available icon collections/libraries.\n\n```\nList all icon collections\nSearch for \"material\" collections\n```\n\n**Parameters:**\n- `category` (optional): Filter by category\n- `search` (optional): Search collections by name\n\n### `recommend_icons`\n\nGet icon recommendations for a specific use case.\n\n```\nWhat icon should I use for a settings button?\nRecommend icons for user authentication\n```\n\n**Parameters:**\n- `use_case` (required): Describe what you need\n- `style` (optional): 'solid', 'outline', or 'any'\n- `limit` (optional): Number of recommendations (1-20)\n\n### `get_icon_preferences`\n\nView your learned icon collection preferences with usage statistics.\n\n```\nShow my icon preferences\nWhat icon collections do I use most?\n```\n\n### `clear_icon_preferences`\n\nReset all learned icon preferences to start fresh.\n\n```\nClear my icon preferences\nReset icon preferences\n```\n\n### `find_similar_icons`\n\nFind similar icons or variations of a given icon across different collections and styles.\n\n```\nFind icons similar to lucide:home\nWhat other arrow icons are there like mdi:arrow-right?\n```\n\n**Parameters:**\n- `icon_id` (required): Icon ID to find variations of\n- `limit` (optional): Maximum number of similar icons (1-50, default: 10)\n\n### `get_icons`\n\nGet multiple icons at once (batch retrieval). More efficient than multiple `get_icon` calls.\n\n```\nGet these icons: lucide:home, lucide:settings, lucide:user\n```\n\n**Parameters:**\n- `icon_ids` (required): Array of icon IDs (max 20)\n- `color` (optional): Color for all icons\n- `size` (optional): Size in pixels for all icons\n\n### `get_recent_icons`\n\nView your recently used icons for quick reuse.\n\n```\nShow my recent icons\nWhat icons have I used recently?\n```\n\n**Parameters:**\n- `limit` (optional): Number of recent icons to show (1-50, default: 20)\n\n### `sync_icon`\n\nGet an icon AND automatically add it to your project's icons file. The recommended way to add icons.\n\n```\nSync the lucide:home icon to my project\nAdd a settings icon to my icons file\n```\n\n**Parameters:**\n- `icons_file` (required): Absolute path to the icons file\n- `framework` (required): 'react', 'vue', 'svelte', 'solid', or 'svg'\n- `icon_id` (required): Icon ID in format 'prefix:name'\n- `component_name` (optional): Custom component name\n- `color` (optional): Icon color\n- `size` (optional): Icon size in pixels\n\n**Returns:**\n- Confirmation that icon was added (or already exists)\n- Import statement to use\n- Usage example\n\n### `scan_project_icons`\n\nScan an icons file to see what icons are already available.\n\n```\nWhat icons are already in my project?\nScan my icons file\n```\n\n**Parameters:**\n- `icons_file` (required): Absolute path to the icons file\n\n## Popular Icon Collections\n\n| Prefix | Name | Style | Icons |\n|--------|------|-------|-------|\n| `mdi` | Material Design Icons | Solid | 7,000+ |\n| `lucide` | Lucide Icons | Outline | 1,500+ |\n| `heroicons` | Heroicons | Both | 300+ |\n| `tabler` | Tabler Icons | Outline | 5,000+ |\n| `ph` | Phosphor Icons | Multiple | 9,000+ |\n| `ri` | Remix Icons | Both | 2,800+ |\n| `fa6-solid` | Font Awesome 6 | Solid | 2,000+ |\n| `simple-icons` | Simple Icons | Logos | 3,000+ |\n\n## CLI Reference\n\n### Search Icons\n\nSearch across 150+ icon collections.\n\n```bash\nbetter-icons search <query> [options]\n```\n\n| Option | Description |\n|--------|-------------|\n| `-p, --prefix <prefix>` | Filter by collection (e.g., `lucide`, `mdi`) |\n| `-l, --limit <number>` | Maximum results (default: 32) |\n| `--json` | Output as JSON for scripting |\n\n### Get Icon\n\nRetrieve a single icon's SVG code.\n\n```bash\nbetter-icons get <icon-id> [options]\n```\n\n| Option | Description |\n|--------|-------------|\n| `-c, --color <color>` | Icon color (e.g., `#ff0000`, `currentColor`) |\n| `-s, --size <pixels>` | Icon size in pixels |\n| `--json` | Output as JSON with metadata |\n\nThe icon ID format is `prefix:name` (e.g., `lucide:home`, `mdi:arrow-right`).\n\n### Setup Commands\n\n```bash\nbetter-icons setup              # Interactive setup wizard\nbetter-icons setup -y           # Auto-confirm (global scope)\nbetter-icons setup -s project   # Setup for current project only\nbetter-icons config             # Show manual config instructions\n```\n\n| Option | Description |\n|--------|-------------|\n| `-y, --yes` | Skip confirmation prompts |\n| `-a, --agent <agents...>` | Specify agents (cursor, claude-code, opencode, windsurf, vscode) |\n| `-s, --scope <scope>` | Config scope: `global` (default) or `project` |\n\n## Development\n\n```bash\n# Install dependencies\nbun install\n\n# Run locally\nbun run dev\n\n# Build\nbun run build\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}