Zig Vibe - CLI Starter Framework

Production-ready CLI starter for vibecoders, written in Zig with comprehensive features: file operations, text processing, templates, encoding detection, log analysis, and performance optimization.

Features

• CLI Framework: Argument parsing, subcommands, configuration system
• File Operations: view, write, edit, glob, grep with safety validation
• Text Processing: transform, search, replace, regex with Unicode support
• Project Templates: CLI, library, web app boilerplate generation
• Log Analysis: Pattern detection, format auto-detection, level classification
• Encoding Support: Detection, conversion (UTF-8/16, Latin-1, etc.)
• Data Extraction: CSV/structured field extraction with custom delimiters
• Performance: Memory tracking, benchmarking, static linking

Quick Start

git clone https://github.com/erayack/zig-vibe.git && cd zig-vibe
zig build run
./zig-out/bin/zig-vibe --help

Key Commands

# File operations
./zig-vibe view file.txt -o 10 -l 20    # View with pagination
./zig-vibe glob "**/*.zig"              # Find files
./zig-vibe grep "error" -f "*.log"      # Search content

# Project templates  
./zig-vibe new cli my-tool              # Create CLI project
./zig-vibe templates                    # List templates

# Text processing
./zig-vibe transform "text" uppercase   # Transform text
./zig-vibe regex search "\d+" data.txt  # Regex operations
./zig-vibe extract data.csv "1,3"       # Extract fields

# Analysis
./zig-vibe analyze app.log -l error     # Log analysis
./zig-vibe encode detect file.txt       # Encoding detection

Build & Test

zig build                               # Development build
zig build -Doptimize=ReleaseFast       # Optimized build
zig build test                         # Run tests
zig build bench                        # Benchmarks

Architecture

Core Modules: cli.zig, fileops.zig, text.zig, regex.zig, templates.zig, encoding.zig, logs.zig, performance.zig

Template System: Variable substitution, built-in templates, extensible definitions

Performance: Streaming operations, optimized algorithms, single binary deployment

Documentation

• Getting Started Guide - Comprehensive setup and usage guide
• File Operations - Complete guide to file system operations
• Architecture Overview - System design and module relationships
• API Reference - Detailed API documentation
• Performance Guide - Optimization and benchmarking