IcoGenie CLI
Generate production-ready SVG icons from your terminal. Perfect for automation, CI/CD pipelines, and rapid prototyping.
npm install -g @icogenie/cliInstallation
Global Install (Recommended)
npm install -g @icogenie/cliInstalls the CLI globally, making icogenie available everywhere.
One-time Use (npx)
npx @icogenie/cli generate "rocket ship"Run without installing. Great for trying it out.
Requires: Node.js 18 or later
Quick Start
Install the CLI
Install globally to use from any directory.
npm install -g @icogenie/cliLogin to your account
Opens your browser to authenticate securely.
icogenie loginGenerate an icon
Describe the icon you want in natural language.
icogenie generate "a friendly robot assistant"Export to SVG
Convert your preview to production-ready SVG and PNG formats.
icogenie export <generation-id>How It Works
The CLI uses a two-step workflow: generate a preview first, then export to production formats. This lets you review the icon before committing to the full export cost.
Generate Preview
1 creditGenerate a watermarked preview to see if you like the result. The preview is saved locally with a unique ID.
icogenie generate "rocket ship launching"Output: ~/.icogenie/drafts/abc123.../preview.png
Review Preview
freeOpen the preview image to check if it matches your vision. Not happy? Generate another variation.
open ~/.icogenie/drafts/abc123.../preview.pngExport to SVG
5 creditsHappy with the preview? Export it to production-ready SVG and PNG formats. Use the generation ID from step 1.
icogenie export abc123...Output:
icon.svg - Scalable vector graphic
png/icon-16.png, icon-32.png, icon-192.png, icon-512.png
meta.html - Ready-to-use HTML meta tags
Tip: For bundles, the same workflow applies. Use icogenie bundle to generate previews, then icogenie export with the bundle ID to export all icons.
Commands
Authentication
icogenie loginAuthenticate with IcoGenie. Opens your browser for secure sign-in.
icogenie loginicogenie logoutSign out and clear your local session.
icogenie logouticogenie whoamiDisplay your current user information and email.
icogenie whoamiGeneration
icogenie generateGenerate an icon from a text prompt. Costs 1 credit per generation.
icogenie generate "rocket ship" --variations 4 --style outlineOptions
-v, --variationsNumber of variations(1, 2, 4) default: 1-s, --styleIcon style(solid, outline) default: solid-o, --outputCustom output path(path) default: ~/.icogenie/draftsicogenie bundleGenerate a bundle of icons from a description. AI analyzes your needs and creates a consistent set. Costs 1 credit per icon for preview.
icogenie bundle "social media icons for my app" --count 10 --style solidOptions
-c, --countTarget number of icons(2-20) default: auto-determined-s, --styleIcon style(solid, outline) default: solid-o, --outputCustom output directory(path) default: ~/.icogenie/draftsicogenie exportExport a generated icon or bundle to SVG and PNG formats. Single icons cost 5 credits, bundles cost 4 credits per icon (20% discount).
icogenie export abc123def --output ./my-iconsOptions
-o, --outputOutput directory(path) default: current directoryAccount
icogenie creditsCheck your current credit balance.
icogenie creditsicogenie billingOpen the billing page in your browser to purchase more credits.
icogenie billingCredits
Single Icons
Preview Generation
Generate a preview image from your prompt
Export to SVG
Convert to production-ready SVG + PNG assets
Bundles (20% discount)
Bundle Preview
Generate previews for all icons in your bundle
Bundle Export
Export all icons to SVG + PNG (20% off single price)
New accounts receive 8 free credits to get started. Purchase more credits when you run out.
Ready to generate your first icon?