### Create Project Setup Instructions with Icons (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This example illustrates using the iconics CLI to generate markdown for project setup instructions. It suggests icons related to 'settings' and then uses 'toolbox' and 'settings' icons for the installation and configuration sections of the documentation.

```bash
icon suggest settings
# → settings, options, control-panel, toolbox

icon use toolbox settings
```

--------------------------------

### Quick Start Bash Commands for Icon Usage

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

Provides essential bash commands for using the 'icon' tool. This includes getting icon suggestions, exporting icons, and generating markdown for documentation. It's designed for a quick and efficient workflow.

```bash
# 1. Get suggestions
icon suggest <context>

# 2. Export and get markdown
icon use <icon1> <icon2> <icon3>

# 3. Paste the generated markdown into documentation

# That's it!
```

--------------------------------

### Add API Documentation with Icons (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This example demonstrates how to use the iconics CLI to suggest and then use icons for API documentation. It starts by suggesting relevant icons for 'api' and then uses 'network' and 'database' icons to create markdown elements for API endpoints.

```bash
icon suggest api
# → network, cloud, globe, server, database

icon use network database
```

--------------------------------

### Example CSV Format for Bulk Import (CSV)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This is an example of the CSV format required for the `import-csv` command. Each row represents an icon with its ID, semantic name, tags, category, and description. This format facilitates batch processing of icon metadata.

```csv
id,semantic,tags,category,description
Phone,phone,"telephone,call,mobile,contact",ui,Phone icon for calls
Printer,printer,"print,document,office",tools,Printer icon
Calculator,calculator,"math,numbers,compute",tools,Calculator icon
```

--------------------------------

### Example Markdown Usage in Documentation

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

Demonstrates how to integrate icons within markdown documentation files using the 'icon' command's output. This is useful for creating visually appealing and informative documentation.

```markdown
# Project Documentation

## ![info](.github/assets/icons/info.png) Overview
...

## ![toolbox](.github/assets/icons/toolbox.png) Installation
...

## ![settings](.github/assets/icons/settings.png) Configuration
...
```

--------------------------------

### Initialize Icon Catalog (Shell)

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

Creates the initial JSON catalog file for storing icon metadata. It defines the version, an empty array for icons, and a list of predefined categories. This is the starting point for managing icons.

```shell
cat > icon-catalog.json << 'EOF'\
{
  "version": "1.0",
  "icons": [],
  "categories": ["files", "network", "security", "tools", "ui", "emoji"]
}
'EOF'

```

--------------------------------

### Initial Directory Setup

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

Commands to set up the initial directory structure for the icon library. This includes creating necessary subdirectories for categorized icons, raw files, and thumbnails, and moving existing PNG and GIF files into the `raw` directory.

```bash
cd /home/zack/dev/icons

# Create initial structure
mkdir -p catalog/{files,network,security,tools,ui}
mkdir raw thumbnails
mv *.png *.gif raw/
```

--------------------------------

### Get Icon Information (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This command retrieves detailed information about a specific icon, including its tags, description, file status, and the projects it's used in.

```bash
icon i <name>
# Shows: tags, description, file status, projects using it
```

--------------------------------

### Show Library Statistics (CLI)

Source: https://context7.com/johnzfitch/iconics/llms.txt

Displays comprehensive statistics about the icon library, including the total number of icons, cataloged vs. uncataloged counts, and a breakdown of icons by category with examples.

```bash
icon stats

# Output:
# === Icon Library Statistics ===
# Total icons in library: 3,369
# Cataloged: 3,372 (100.0%)
# Uncataloged: 0
# 
# === Category Breakdown ===
# 
# UI (2,969 icons):
#   • info
#   • warning
#   • arrow-up
#   • arrow-down
#   • checkbox
#   • home
#   • menu
#   • close
#   • success
#   • error
#   ... and 2,959 more
# 
# FILES (179 icons):
#   • folder
#   • document
#   • pdf
#   • photo
#   • video
#   • archive
#   • blueprint
#   • bookmark

```

--------------------------------

### Create an Icon Template (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This command creates a reusable template for icon families, allowing definition of common tags and categories once. This streamlines applying consistent metadata to icon variants. The example shows creating an 'arrow' template.

```bash
python3 icon-manager.py create-template arrow \
  --tags navigation direction pointer movement \
  --category ui
```

--------------------------------

### Get Icon Information via CLI

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

Retrieves detailed information about a specific icon using its semantic name. Outputs include metadata, file paths, and usage information. Requires the icon-manager.py script.

```bash
python3 icon-manager.py info <semantic-name>

# Example:
python3 icon-manager.py info lock
```

--------------------------------

### Example CSV for Applying Templates (CSV)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This CSV format is used with the `apply-template` command. It lists icon variants within a family, providing their ID, semantic name, any extra tags specific to the variant, and a description. This allows for customization while leveraging a common template.

```csv
# arrow-icons.csv
id,semantic,extra_tags,description
Up,arrow-up,upward vertical,Upward arrow
Down,arrow-down,downward vertical,Downward arrow
Left,arrow-left,leftward horizontal,Left arrow
Right,arrow-right,rightward horizontal,Right arrow
```

--------------------------------

### Get Icon Information (CLI and Python Manager)

Source: https://context7.com/johnzfitch/iconics/llms.txt

Retrieves detailed information about a specific icon, including its ID, semantic name, file path, category, description, tags, and usage in projects. Supports shorthand aliases for the command.

```bash
# Get info about lock icon
icon info lock

# Output (using Python manager):
# === Icon: lock ===
# ID: Lock
# Semantic Name: lock
# Filename: raw/Lock.png
# Category: security
# Description: Padlock icon for security
# Tags: security, padlock, locked, protection
# Used In: 3 project(s)
#   - my-app
#   - security-docs
#   - api-gateway
# File Status: ✓ Exists

# Get info about network icon
icon i network

# Shorthand alias
icon i database
```

--------------------------------

### Add a New Icon to the Catalog (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This command adds a new icon to the catalog with its ID, semantic name, tags, category, and description. It utilizes optional flags for tags, category, and description. The example shows adding a 'Key' icon.

```bash
python3 icon-manager.py add <icon-id> <semantic-name> \
  --tags <tag1> <tag2> ... \
  --category <category> \
  --description "Description"
```

--------------------------------

### Validate Icon Catalog Integrity

Source: https://context7.com/johnzfitch/iconics/llms.txt

Check the icon catalog for any integrity issues, such as missing source files or broken symbolic links. The 'icon validate' command performs these checks and reports any found problems, guiding you to fix them.

```bash
icon validate
```

```bash
# Using Python manager
python3 icon-manager.py validate
```

--------------------------------

### Icon Manager CLI - Basic Features

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

Outlines the core features planned for the `icon-manager.py` command-line tool, including searching for icons, exporting them to projects, adding/updating tags, listing icons by category, and providing usage statistics.

```bash
# icon-manager.py features:
- search: Find icons by tag/name
- export: Copy icons to project
- tag: Add metadata to icon
- list: Show all icons in category
- stats: Usage statistics
```

--------------------------------

### Icon Manager CLI - Search and Export

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

Illustrates the command-line interface (CLI) usage of the `icon-manager.py` script for searching icons based on keywords and exporting selected icons to a specified project directory with semantic naming.

```bash
# Search for icons
./icon-manager.py search "security lock"
# Output: lock.png (raw/686.png), shield.png (raw/893.png)

# Export to project
./icon-manager.py export eero-reverse-engineering lock shield network
# Copies to project/.github/assets/icons/ with semantic names
```

--------------------------------

### Apply a Template to Icons (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This command applies a previously created template to a list of icons specified in a CSV file. The CSV should include icon IDs, semantic names, and any extra tags or descriptions specific to each icon variant. This ensures consistent metadata application for icon families.

```bash
python3 icon-manager.py apply-template arrow arrow-icons.csv
```

--------------------------------

### Icon Manager CLI - Add, Tag, and Stats

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

Shows commands for managing the icon catalog using the `icon-manager.py` script. This includes adding new icons with tags and categories, updating existing icons' metadata, and generating statistical reports on icon usage.

```bash
# Add new icon
./icon-manager.py add new-icon.png --tags "cloud,upload" --category "network"

# Update existing
./icon-manager.py tag 100.png --tags "document,file,text"

# Generate report
./icon-manager.py stats
# Shows usage across projects, most used icons, etc.
```

--------------------------------

### Create Icon Symlinks (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

Uses bash commands to create symbolic links for icons. This command navigates to the icon directory and then creates links from the raw icon files to categorized directories within the catalog. This organizes icons by category for easier access.

```bash
cd /home/zack/dev/icons
ln -s raw/686.png catalog/security/lock.png
ln -s raw/893.png catalog/security/shield.png
ln -s raw/940.png catalog/ui/info.png
ln -s raw/438.png catalog/network/connection.png

```

--------------------------------

### Troubleshooting: Search for Alternative Icons (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

If an icon is not found, this command helps users search for alternative icons by a keyword. It's part of the troubleshooting process for missing icons.

```bash
# Search for alternatives
icon search <keyword>
```

--------------------------------

### Exiftool for Metadata Tagging

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

Demonstrates using the `exiftool` command-line utility to add metadata tags to an image file. The `-Comment` tag is used here to store a comma-separated list of tags.

```bash
exiftool -Comment="security,lock,padlock" 100.png
# Add EXIF metadata tags
```

--------------------------------

### Add Icons to Catalog via CLI

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

Adds a new icon to the catalog by providing its filename, semantic name, tags, category, and description. This command is used for contributing new icons. Requires the icon-manager.py script.

```bash
python3 icon-manager.py add "Filename" "semantic-name" \
  --tags relevant tags here \
  --category appropriate-category \
  --description "Clear description"
```

--------------------------------

### Export Icons to a Project (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This command exports specified icons to a target project directory, assigning them semantic names. It takes the project path and a list of icon names as arguments. Icons are copied to `<project>/.github/assets/icons/`.

```bash
python3 icon-manager.py export <project-path> <icon1> <icon2> ...
```

--------------------------------

### View Icon Library Statistics (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This command displays detailed statistics about the icon library, including catalog coverage, category breakdowns, most used icons, and project usage summaries. It provides insights into the library's completeness and utilization.

```bash
python3 icon-manager.py stats
```

--------------------------------

### Icon Catalog JSON Structure

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

Defines the structure for the `icon-catalog.json` file, which holds metadata for each icon including its ID, filename, semantic name, tags, category, size, description, and usage information. It also includes a section for defining categories and associated tags.

```json
{
  "icons": [
    {
      "id": "100",
      "filename": "100.png",
      "semanticName": "document",
      "tags": ["file", "document", "text", "page"],
      "category": "files",
      "size": "16x16",
      "description": "Text document icon",
      "usedIn": ["eero-reverse-engineering"]
    },
    {
      "id": "10",
      "filename": "10.png",
      "semanticName": "emoji-smile",
      "tags": ["emoji", "face", "happy", "smile"],
      "category": "emoji",
      "size": "16x16",
      "description": "Smiling emoji face"
    }
  ],
  "categories": {
    "files": ["document", "folder", "archive"],
    "network": ["connection", "wifi", "ethernet"],
    "security": ["lock", "shield", "key"],
    "tools": ["wrench", "gear", "settings"],
    "navigation": ["arrow", "pointer", "direction"],
    "communication": ["email", "chat", "phone"],
    "media": ["image", "video", "audio"],
    "emoji": ["faces", "emotions"],
    "development": ["code", "bug", "test"]
  }
}
```

--------------------------------

### Troubleshooting: Check Available Icons (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

These commands are used for troubleshooting icon availability issues. 'icon recent' shows recently added icons, and 'icon stats' provides library statistics.

```bash
# Check what's available
icon recent
icon stats
```

--------------------------------

### Export Specific Icons via CLI

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

Exports a list of specified icons to a target project directory. Requires the icon-manager.py script.

```bash
python3 icon-manager.py export ~/dev/your-project icon1 icon2 icon3
```

--------------------------------

### Apply Icon Template with Python Manager

Source: https://context7.com/johnzfitch/iconics/llms.txt

Apply a previously created template to multiple icon variants by providing the template name and a CSV file containing icon-specific details like ID, semantic name, extra tags, and description. This enables bulk cataloging with template consistency.

```bash
# Create CSV with template-specific details (arrow-icons.csv):
# id,semantic,extra_tags,description
# Up,arrow-up,upward vertical,Upward arrow for navigation
# Down,arrow-down,downward vertical,Downward arrow for navigation
# Left,arrow-left,leftward horizontal,Left arrow for navigation
# Right,arrow-right,rightward horizontal,Right arrow for navigation

# Apply arrow template
python3 icon-manager.py apply-template arrow arrow-icons.csv
```

```bash
# Apply social media template
python3 icon-manager.py apply-template social social-icons.csv
```

--------------------------------

### Python Script for CSV Generation and Import

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

Illustrates Python scripts used for managing the icon catalog. 'generate-csv' creates suggestions from uncataloged icons, and 'import-csv' imports reviewed icon data. These are key for expanding and maintaining the icon library.

```bash
# Auto-generate suggestions from uncataloged icons
cd /home/zack/dev/iconics
python3 icon-manager.py generate-csv batch.csv --limit 100

# Review and edit the CSV, then import
python3 icon-manager.py import-csv batch.csv
```

--------------------------------

### Search Icons by Tag or Name (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This command searches for icons based on provided tags or semantic names. It takes a query string as input and returns matching icons. No specific output format is detailed, but it's expected to list relevant icons.

```bash
python3 icon-manager.py search <query>
```

--------------------------------

### List Icons in a Category (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This command lists all icons available within a specified category. It's useful for exploring the range of icons in a particular theme.

```bash
icon list security
```

--------------------------------

### View Recent Icons via CLI

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

Displays a list of recently cataloged icons. Allows specifying the number of icons to display using the --limit option. Requires the icon-manager.py script.

```bash
python3 icon-manager.py recent [--limit <N>]

# Examples:
python3 icon-manager.py recent           # Show last 20 icons
python3 icon-manager.py recent --limit 50  # Show last 50 icons
```

--------------------------------

### Show Library Statistics (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This command displays statistics about the iconics library, such as the total number of icons and categories available.

```bash
icon stats
```

--------------------------------

### List Icons in a Category (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This command lists all icons belonging to a specified category. It requires a category name as an argument. Available categories include files, network, security, tools, ui, emoji, and development.

```bash
python3 icon-manager.py list <category>
```

--------------------------------

### Update Eero Project with Icons (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

This bash script updates the Eero project by removing old icons, creating a new assets directory, and copying specific icons from the icon catalog into the Eero project's assets. This integrates the managed icons into the target project.

```bash
cd ~/dev/eero
rm -rf .github/assets/icons
mkdir -p .github/assets/icons
cp /home/zack/dev/icons/catalog/security/{lock,shield}.png .github/assets/icons/
cp /home/zack/dev/icons/catalog/ui/info.png .github/assets/icons/
cp /home/zack/dev/icons/catalog/network/connection.png .github/assets/icons/

```

--------------------------------

### Search for Icons by Keyword (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This command searches the iconics library for icons matching a given keyword. It helps users find relevant icons when they don't know the exact name.

```bash
icon search <keyword>
```

--------------------------------

### Create Icon Template with Python Manager

Source: https://context7.com/johnzfitch/iconics/llms.txt

Define reusable templates for icon families by specifying a name, tags, and category. This facilitates consistent icon management. Multiple templates can be created, such as 'arrow', 'social', and 'file-type'.

```bash
# Create arrow template for navigation icons
python3 icon-manager.py create-template arrow \
  --tags navigation direction pointer movement \
  --category ui
```

```bash
# Create social media template
python3 icon-manager.py create-template social \
  --tags social-media sharing platform connect \
  --category ui
```

```bash
# Create file type template
python3 icon-manager.py create-template file-type \
  --tags file document format \
  --category files
```

--------------------------------

### Search for Icons via CLI

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

Searches for icons based on a given keyword. This command is typically executed after navigating to the iconics directory. Requires the icon-manager.py script.

```bash
cd /path/to/iconics
python3 icon-manager.py search <keyword>
```

--------------------------------

### Bulk Import Icons from CSV (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This command imports multiple icons from a CSV file, offering a faster alternative to individual commands. The CSV file must follow a specific format: id,semantic,tags,category,description. It supports automatic duplicate detection.

```bash
python3 icon-manager.py import-csv icons-to-import.csv
```

--------------------------------

### Manually Specify Project Directory (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

If the iconics CLI incorrectly detects the project root, this command shows how to manually navigate to the correct directory before using 'icon use'. This ensures icons are placed and referenced correctly.

```bash
cd /path/to/correct/project
icon use lock shield
```

--------------------------------

### Add Security Section with Icons (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This snippet shows the process of adding a security section to documentation using the iconics CLI. It suggests security-related icons and then uses 'lock', 'shield', and 'key' to generate markdown for security features like encrypted communication and authentication.

```bash
icon suggest security
# → lock, shield, key, protection, certificate

icon use lock shield key
```

--------------------------------

### Python Icon Manager Class

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

A Python class designed for managing icon files. It includes methods for scanning directories, generating thumbnails, tagging icons, searching the catalog, and exporting icons for specific projects. Dependencies include PIL (Pillow) for image manipulation and hashlib for hashing.

```python
# icon-manager.py
import json
import os
from PIL import Image
import hashlib

class IconManager:
    def scan_icons(self, directory):
        # Scan all PNGs, generate thumbnails
        pass

    def tag_icon(self, icon_id, tags, semantic_name):
        # Add metadata to catalog
        pass

    def search(self, query):
        # Search by tags, semantic name, category
        pass

    def export_for_project(self, icon_ids, project_name):
        # Copy selected icons to project with semantic names
        pass

```

--------------------------------

### Export Icons by Category via CLI

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

Exports all icons belonging to a specified category. Useful for themed projects or UI kits. Requires the icon-manager.py script and the path to the project where icons will be exported.

```bash
python3 icon-manager.py export-category <project-path> <category>

# Example:
python3 icon-manager.py export-category ~/dev/my-app security
```

--------------------------------

### Show Recently Added Icons (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This command displays a list of the most recently added icons to the iconics library. The number argument specifies how many recent icons to show.

```bash
icon recent 10
# Shows last 10 added icons
```

--------------------------------

### ImageMagick Identify Command

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

Uses the ImageMagick `identify` command to extract image dimensions (width and height) for all PNG files in the current directory. This is useful for cataloging icon sizes.

```bash
identify -format "%f %wx%h\n" *.png
# Get dimensions for all icons
```

--------------------------------

### Tag Existing Icons (JSON)

Source: https://github.com/johnzfitch/iconics/blob/master/ICON_MANAGEMENT_PLAN.md

Provides a JSON structure to update the icon catalog with specific icon details. Each icon object includes an ID, filename, semantic meaning, tags, and category. This is used to enrich the catalog with already identified icons.

```json
{
  "icons": [
    {"id": "686", "filename": "raw/686.png", "semantic": "lock", "tags": ["security","lock","padlock"], "category": "security"},
    {"id": "893", "filename": "raw/893.png", "semantic": "shield", "tags": ["security","shield","protection"], "category": "security"},
    {"id": "940", "filename": "raw/940.png", "semantic": "info", "tags": ["info","information","help"], "category": "ui"},
    {"id": "438", "filename": "raw/438.png", "semantic": "network", "tags": ["network","connection","tower"], "category": "network"}
  ]
}

```

--------------------------------

### View Icon Usage History

Source: https://context7.com/johnzfitch/iconics/llms.txt

The 'icon history' command displays the usage history of icons for the current project, including the last used timestamp and a list of icons. It can also be used with the Python manager to specify a project path.

```bash
# Show icon usage history for current project
icon history
```

```bash
# Using Python manager
python3 icon-manager.py history /path/to/project
```

--------------------------------

### Batch Export Multiple Icons (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This command shows how to export multiple specified icons at once using the iconics CLI. It's useful for adding several related icons to documentation efficiently.

```bash
icon use lock shield key certificate database network
```

--------------------------------

### View Popular Icons

Source: https://context7.com/johnzfitch/iconics/llms.txt

Retrieve a list of the most frequently used icons across all projects. You can specify the number of top icons to display (default is 10). The Python manager allows specifying a limit.

```bash
# Show top 10 most popular icons
icon popular
```

```bash
# Show top 20
icon popular 20
```

```bash
# Using Python manager
python3 icon-manager.py popular --limit 15
```

--------------------------------

### Re-export Last Used Icons

Source: https://context7.com/johnzfitch/iconics/llms.txt

The 'icon again' command re-exports the icons that were last used in the project. This is useful for quick access to recently utilized icon assets.

```bash
# Re-export last used icons
icon again
```

--------------------------------

### Use Icons in README Markdown

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

Illustrates how to embed icons within a Markdown README file using image syntax. The path to the icon file should be correct relative to the README.

```markdown
# Your Project

## ![Shield](.github/assets/icons/shield.png) Security

Security features documented here...

## ![Network](.github/assets/icons/network.png) Architecture

Network architecture details...
```

--------------------------------

### Export UI Icons

Source: https://context7.com/johnzfitch/iconics/llms.txt

Exports UI icons from the project. This command is used to retrieve a specific category of icons. No external dependencies are explicitly mentioned.

```bash
icon cat ui
```

--------------------------------

### Add Single Icon to Catalog (Python Manager)

Source: https://context7.com/johnzfitch/iconics/llms.txt

Adds a single icon to the catalog with its semantic name, tags, category, and description. Requires the icon source file to exist in the 'raw/' directory. Outputs confirmation messages and the path to the saved catalog.

```python
# Add a single icon using Python manager
python3 icon-manager.py add "Phone" "phone" \
  --tags telephone call mobile contact communication \
  --category ui \
  --description "Phone icon for calls and contact information"

# Output:
# ✓ Added icon Phone (phone)
#   → Created symlink: catalog/ui/phone.png
# ✓ Catalog saved to /home/zack/dev/iconics/icon-catalog.json

# Add security icon
python3 icon-manager.py add "Fingerprint" "fingerprint" \
  --tags security biometric authentication identity \
  --category security \
  --description "Fingerprint icon for biometric authentication"

# The icon source file must exist in raw/ directory as Phone.png
```

--------------------------------

### Show Recently Cataloged Icons (CLI and Python Manager)

Source: https://context7.com/johnzfitch/iconics/llms.txt

Displays a list of recently added icons to the catalog, including their names, categories, and addition dates. Allows specifying the number of icons to display. Can also be invoked using the Python manager.

```bash
# Show last 20 icons (default)
icon recent

# Output:
# === Recently Cataloged Icons ===
# 
# arrow-right-circle      (ui)        Added: 2025-10-27
# arrow-left-circle       (ui)        Added: 2025-10-27
# battery-full            (tools)     Added: 2025-10-26
# wifi-signal             (network)   Added: 2025-10-26
# folder-open             (files)     Added: 2025-10-25
# ...

# Show last 50 icons
icon recent 50

# Using Python manager
python3 icon-manager.py recent --limit 10
```

--------------------------------

### Export Security Icons Category (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This command demonstrates how to export all icons belonging to a specific category, 'security', using the iconics CLI. It will download all icons associated with security features into the current directory.

```bash
icon cat security
# Exports all 11 security icons
```

--------------------------------

### Auto-Generate CSV from Filenames (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This command scans uncataloged icons, parses filenames to suggest semantic names and tags, guesses categories, and creates an editable CSV file. It's designed to significantly speed up the cataloging process. A limit can be specified for the number of icons to process.

```bash
python3 icon-manager.py generate-csv suggested-icons.csv --limit 50
```

--------------------------------

### Bulk Import Icons from CSV (Python Manager)

Source: https://context7.com/johnzfitch/iconics/llms.txt

Imports multiple icons into the catalog from a CSV file. This method is significantly faster than individual imports. The CSV file must have specific columns: id, semantic, tags, category, and description. Outputs confirmation for each added icon and the catalog save status.

```python
# Create CSV file (icons.csv):
# id,semantic,tags,category,description
# Phone,phone,"telephone,call,mobile,contact",ui,Phone icon for calls
# Printer,printer,"print,document,office",tools,Printer icon
# Calculator,calculator,"math,numbers,compute",tools,Calculator icon
# Globe,globe,"world,earth,international,global",network,Globe icon

# Import the CSV
python3 icon-manager.py import-csv icons.csv

# Output:
# ✓ Added icon Phone (phone)
#   → Created symlink: catalog/ui/phone.png
# ✓ Added icon Printer (printer)
#   → Created symlink: catalog/tools/printer.png
# ✓ Added icon Calculator (calculator)
#   → Created symlink: catalog/tools/calculator.png
# ✓ Added icon Globe (globe)
#   → Created symlink: catalog/network/globe.png
# ✓ Catalog saved

# Use provided template
cp icon-import-template.csv my-batch.csv
# Edit my-batch.csv in spreadsheet software
python3 icon-manager.py import-csv my-batch.csv
```

--------------------------------

### Auto-Generate CSV from Filenames (Python Manager)

Source: https://context7.com/johnzfitch/iconics/llms.txt

Automatically generates a CSV file with AI-suggested metadata (names, tags, descriptions) based on icon filenames. This is a faster method for initial cataloging. The generated CSV can then be reviewed and imported. Supports limiting the number of icons processed.

```python
# Generate CSV with AI-suggested metadata for 100 uncataloged icons
python3 icon-manager.py generate-csv suggested-batch.csv --limit 100

# Output:
# Analyzing uncataloged icons in raw/...
# Generated suggestions for 100 icons
# ✓ Saved to suggested-batch.csv
# 
# Review and edit the CSV, then import with:
#   python3 icon-manager.py import-csv suggested-batch.csv

# Example generated CSV content:
# id,semantic,tags,category,description
# arrow_up,arrow-up,"arrow,up,upward,navigation,direction",ui,Upward arrow icon
# arrow_down,arrow-down,"arrow,down,downward,navigation,direction",ui,Downward arrow icon
# file_pdf,pdf,"document,pdf,file,adobe",files,PDF document icon

# Edit in spreadsheet software to improve suggestions
# Then import
python3 icon-manager.py import-csv suggested-batch.csv

# Generate smaller batch
python3 icon-manager.py generate-csv batch-50.csv --limit 50
```

--------------------------------

### Validate Icon Catalog Integrity (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/README.md

This command checks the icon catalog for various integrity issues, such as missing source files, broken symlinks, and directory structure problems. It helps ensure the catalog is well-maintained and functional.

```bash
python3 icon-manager.py validate
```

--------------------------------

### Export Security Icons using Python Manager

Source: https://context7.com/johnzfitch/iconics/llms.txt

Exports icons from the 'security' category using the Python manager script. It specifies the destination directory for the exported icons.

```python
python3 icon-manager.py export-category ~/dev/my-app security
```

--------------------------------

### Generate Markdown Without Exporting Icons (Bash)

Source: https://github.com/johnzfitch/iconics/blob/master/CLAUDE.md

This command generates markdown for specified icons without exporting the icon files themselves. This is useful when the icons are already present in the project directory.

```bash
icon md lock shield
# Just generates markdown, no export
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.