svgl-cli

name	svgl-cli
description	Manage SVGL via CLI - svg, categories. Use when user mentions 'svgl', 'svg logo', 'brand logo', 'fetch svg', 'logo for excalidraw', or wants to search/download SVG logos from svgl.app.
category	devtools

svgl-cli

Setup

If svgl-cli is not found, install and build it:

bun --version || curl -fsSL https://bun.sh/install | bash
npx api2cli bundle svgl
npx api2cli link svgl

No authentication required - the SVGL API is open.

Always use --json flag when calling commands programmatically.

Resources

svg

Action	Command	Key Flags
list	svgl-cli svg list	--limit <n>, --search <query>, --category <name>, --fields, --json
search	svgl-cli svg search <query>	--limit <n>, --fields, --json
get	svgl-cli svg get <name>	--no-optimize, --json
excalidraw	svgl-cli svg excalidraw <name>	--dark, --json

categories

Action	Command	Key Flags
list	svgl-cli categories list	--fields, --json

Key Commands

svgl-cli svg search supabase --json       # Search by name
svgl-cli svg get react                     # Get raw SVG markup
svgl-cli svg excalidraw neon --json        # Get Excalidraw-compatible base64 data
svgl-cli svg list --category database      # List by category
svgl-cli categories list --json            # List all categories

Excalidraw Integration

svg excalidraw <name> returns a JSON object with fileId and fileData ready to inject into an Excalidraw .excalidraw file's files dict. Use --dark for dark variant logos.

Output Format

--json returns: { "ok": true, "data": {...}, "meta": { "total": N } }

Quick Reference

svgl-cli --help
svgl-cli svg --help
svgl-cli svg <action> --help

Global flags: --json, --format <text|json|csv|yaml>, --verbose, --no-color, --no-header