better-icons

# Better Icons Search and retrieve icons from 200+ libraries via Iconify. ## Installation Before using any `better-icons` commands, ensure the tool is available in the environment. **Option 1 — Install globally (recommended, matches all examples below):** ```bash # Using npm npm install -g better-icons # Using Bun (faster) bun add -g better-icons ``` **Option 2 — Run without installing (prefix every command with `npx` or `bunx`):** ```bash # Using npx (npm) npx better-icons search arrow --limit 10 npx better-icons get lucide:home > icon.svg # Using bunx (Bun — faster) bunx better-icons search arrow --limit 10 bunx better-icons get lucide:home > icon.svg ``` > **For AI agents:** Prefer the global install so that `better-icons` is on `$PATH` and the commands below work as-is. Run the install step once during environment setup, then use the commands without `npx`/`bunx`. ## CLI ```bash # Search icons better-icons search <query> [--prefix <prefix>] [--limit <n>] [--json] # Search and download all found icons as SVG files better-icons search <query> -d [dir] [--color <color>] [--size <px>] # Get icon SVG (outputs to stdout) better-icons get <icon-id> [--color <color>] [--size <px>] [--json] # Setup MCP server for AI agents better-icons setup [-a cursor,claude-code] [-s global|project] ``` ## Examples ```bash better-icons search arrow --limit 10 better-icons search home --json | jq '.icons[0]' better-icons get lucide:home > icon.svg better-icons get mdi:home --colo...