ukiryu

Ukiryu is a platform-adaptive command execution framework that transforms CLI tools into declarative APIs. It provides the "OpenAPI" for command-line interfaces, enabling cross-platform tool integration with type safety and structured results. Key features: * Declarative YAML profiles define tool behavior, eliminating hardcoded command strings * Platform-adaptive execution across macOS, Linux, and Windows * Shell-aware command formatting for bash, zsh, fish, PowerShell, and cmd * Type-safe parameter validation with automatic coercion * Version routing support with semantic version matching (via Versionian) * Interface contracts allow multiple tools to implement the same abstract API * Structured Result objects with success/failure information instead of parsing stdout * Comprehensive error handling under Ukiryu::Errors namespace The Ukiryu ecosystem consists of: * ukiryu gem - The runtime framework * ukiryu/register - Collection of YAML tool profiles * ukiryu/schemas - JSON Schema for validation Use Ukiryu to integrate command-line tools like ImageMagick, FFmpeg, Inkscape, Ghostscript, and more into your Ruby applications with consistent, predictable interfaces.