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.
Activity
- Latest release
- 4mo ago
- Total releases
- 12
- Cadence
- ~2 days
- Last 12 months
- 12
Reach
- Stars
- —
Details
- License
- BSD-2-Clause
- First release
- Jan 21, 2026
| Version | Released | |
|---|---|---|
0.3.0
minor
| ||
0.2.4
patch
| ||
0.2.3
patch
| ||
0.2.0
minor
| ||
0.2.2
patch
| ||
0.2.1
patch
| ||
0.1.7
patch
| ||
0.1.6
patch
| ||
0.1.4
patch
| ||
0.1.3
patch
| ||
0.1.1
patch
| ||
0.1.0
initial
|