dev: automated commit - 2025-09-06 17:51:28

local-bin/README.md

@@ -0,0 +1,84 @@
+# Local Bin Scripts
+
+This directory contains custom scripts that are installed to `~/.local/bin/` via Stow.
+
+## Font Manager
+
+Enhanced font management script with advanced features:
+
+### Features
+- **Archive Management**: Extract, list, and manage font archives
+- **Backup System**: Automatic backups before cleaning
+- **URL Installation**: Install fonts directly from URLs
+- **Status Monitoring**: View current font status and logs
+- **Error Handling**: Comprehensive error checking and logging
+- **Color Output**: Colored terminal output for better UX
+
+### Usage
+
+```bash
+# Basic commands
+font-manager list              # List available fonts
+font-manager extract <name>    # Extract specific font
+font-manager all               # Extract all fonts
+font-manager clean             # Clean active fonts (with backup)
+font-manager status            # Show current status
+
+# Advanced commands
+font-manager backup            # List backups
+font-manager restore <name>    # Restore from backup
+font-manager install <url>    # Install from URL
+```
+
+### Zsh Integration
+
+The following aliases and functions are available:
+
+```bash
+# Aliases
+fm    # font-manager
+fml   # font-manager list
+fms   # font-manager status
+fmc   # font-manager clean
+fma   # font-manager all
+
+# Functions
+font-switch <name>    # Quick font switching
+font-preview <name>  # Font preview
+```
+
+### Directory Structure
+
+```
+~/.local/share/fonts/
+├── archives/     # Font archives (.tar.gz)
+├── active/       # Extracted fonts
+├── backups/      # Automatic backups
+└── font-manager.log  # Operation log
+```
+
+### Examples
+
+```bash
+# Switch to JetBrains Mono
+font-switch jetbrains-mono
+
+# Install font from GitHub
+font-manager install https://github.com/JetBrains/JetBrainsMono/releases/download/v2.304/JetBrainsMono-2.304.zip
+
+# Preview a font
+font-preview fira-code
+
+# Check status
+fms
+```
+
+### Installation
+
+The script is automatically installed via Stow:
+
+```bash
+stow local-bin
+```
+
+This creates the necessary directory structure and installs the script to `~/.local/bin/font-manager`.