# Send 🦄 Unicon CLI to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "unicon",
    "name": "🦄 Unicon CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/charlesrhoward/unicon",
    "canonicalUrl": "https://clawhub.ai/charlesrhoward/unicon",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/unicon",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=unicon",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/cli-commands.md",
      "references/config-file.md",
      "references/api-reference.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "unicon",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-13T02:38:41.429Z",
      "expiresAt": "2026-05-20T02:38:41.429Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=unicon",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=unicon",
        "contentDisposition": "attachment; filename=\"unicon-0.2.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "unicon"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/unicon"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/unicon",
    "downloadUrl": "https://openagent3.xyz/downloads/unicon",
    "agentUrl": "https://openagent3.xyz/skills/unicon/agent",
    "manifestUrl": "https://openagent3.xyz/skills/unicon/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/unicon/agent.md"
  }
}
```
## Documentation

### Unicon

Unicon is a unified icon library providing 19,000+ icons from 9 popular libraries. Unlike traditional npm packages that bundle thousands of icons, Unicon generates only the icons you need.

### Quick Start

# Install CLI globally
npm install -g @webrenew/unicon

# Or use directly with npx
npx @webrenew/unicon search "dashboard"

### Core Commands

CommandDescriptionunicon search <query>AI-powered semantic search (supports --pick for interactive selection)unicon get <name>Get single icon to stdout, file, or clipboard (--copy)unicon info <name>Show detailed icon informationunicon preview <name>ASCII art preview in terminalunicon bundleBundle multiple icons (supports --stars for favorites)unicon initCreate .uniconrc.json config (--interactive for wizard)unicon syncRegenerate bundles (--watch for auto-sync)unicon add <name>Add bundle to configunicon star <name>Add icon to favoritesunicon auditFind unused/missing icons in projectunicon sourcesList available icon librariesunicon categoriesList icon categoriesunicon cacheManage local cacheunicon skillInstall AI assistant skills

### Output Formats

FormatExtensionUse Casereact.tsxReact/Next.js (auto-detected)vue.vueVue 3 SFC (auto-detected)svelte.svelteSvelte components (auto-detected)svg.svgRaw SVG markupjson.jsonData/programmatic use

Note: CLI auto-detects your framework from package.json and uses the appropriate format.

### Icon Sources

SourceIconsDescriptionlucide1,900+Beautiful & consistentphosphor1,500+6 weights availablehugeicons1,800+Modern outlined iconsheroicons292Tailwind Labstabler4,600+Pixel-perfect strokefeather287Simple and cleanremix2,800+Multiple categoriessimple-icons3,300+Brand logosiconoir1,600+Modern outlined icons

### Add Icons to a React Project

# 1. Initialize config (interactive wizard)
unicon init --interactive

# 2. Search for icons interactively
unicon search "navigation arrows" --pick

# 3. Add bundle to config
unicon add nav --query "arrow chevron menu"

# 4. Generate components
unicon sync

# 5. Import and use
# import { ArrowRight, Menu } from "./src/icons/nav"

### Get a Single Icon Quickly

# Output to stdout (auto-detects framework)
unicon get home

# Copy to clipboard directly
unicon get home --copy

# Save to file
unicon get settings --format react -o ./Settings.tsx

# Different framework
unicon get home --format vue -o ./Home.vue

### Interactive Search with Selection

# Search and pick icons interactively
unicon search "dashboard" --pick

# Then choose action: copy, save, star, or create bundle

### Bundle by Category

# Bundle all dashboard icons (tree-shakeable by default)
unicon bundle --category Dashboards -o ./src/icons

# Bundle specific icons by search
unicon bundle --query "social media" --format svg -o ./public/icons

# Bundle all favorited icons
unicon bundle --stars -o ./src/icons/favorites

# Single file mode (not tree-shakeable)
unicon bundle --query "ui" --single-file -o ./icons.tsx

### Favorites System

# Star icons for later
unicon star home
unicon star settings
unicon star user

# Bundle all starred icons
unicon bundle --stars -o ./src/icons/favorites

# View favorites
unicon favorites

### Watch Mode for Development

# Auto-regenerate when config changes
unicon sync --watch

### Audit Project Usage

# Find unused bundled icons and missing imports
unicon audit

### Preview Icons in Terminal

# ASCII art preview
unicon preview home

# Custom size
unicon preview star --width 24

### Tree-Shaking Benefits

Unlike npm install lucide-react which downloads thousands of icons:

Generates only the icons you need as individual files
No external dependencies to ship
True tree-shaking with one component per file
Import only what you use: import { Home } from "./icons"

### Web Interface

Browse and copy icons at: https://unicon.sh

Visual search with AI
One-click copy (SVG, React, Vue, Svelte)
Filter by library and category
Bundle builder for multiple icons

### References

CLI Commands - All commands and options
Config File - .uniconrc.json schema
API Reference - REST endpoints

### AI Assistant Integration

Install Unicon skills for AI coding assistants:

# List supported assistants
unicon skill --list

# Install for specific assistant
unicon skill --ide claude      # Claude Code
unicon skill --ide cursor      # Cursor
unicon skill --ide windsurf    # Windsurf

# Install for all supported assistants
unicon skill --all

### Supported AI Assistants

IDEDirectoryClaude Code.claude/skills/unicon/SKILL.mdCursor.cursor/rules/unicon.mdcWindsurf.windsurf/rules/unicon.mdAgent.agent/rules/unicon.mdAntigravity.antigravity/rules/unicon.mdOpenCode.opencode/rules/unicon.mdCodex.codex/unicon.mdAider.aider/rules/unicon.md

Once installed, ask your AI assistant: "Add a home icon to my project"

### Cache

Icons are cached locally at ~/.unicon/cache for 24 hours:

unicon cache --stats   # Show cache info
unicon cache --clear   # Clear cache
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: charlesrhoward
- Version: 0.2.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-13T02:38:41.429Z
- Expires at: 2026-05-20T02:38:41.429Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/unicon)
- [Send to Agent page](https://openagent3.xyz/skills/unicon/agent)
- [JSON manifest](https://openagent3.xyz/skills/unicon/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/unicon/agent.md)
- [Download page](https://openagent3.xyz/downloads/unicon)