Durable Run Style (druns) is a stylish CLI wrapper for long-running tasks that provides a beautiful terminal interface with real-time system monitoring, execution timers, and detailed process information.
Features
- Beautiful Terminal UI: Built with Ratatui for a polished, professional interface
- Real-Time Monitoring: Track CPU usage, memory consumption, and disk I/O as your command runs
- Execution Timer: Precise timing of command execution
- Advanced Process Management: Sophisticated process spawning and management
- Output Logging: Capture and display command output in real-time
- Configurable Layout: Customize the display to match your preferences
- Network Monitoring (Experimental): Track network usage during command execution
- Animated Graphics: Visual feedback with smooth animations
Installation
Via Cargo (Recommended)
cargo install --git https://github.com/durableprogramming/durable-run-style.git
From Pre-built Binaries
Download the latest release from the releases page.
From Source
git clone https://github.com/durableprogramming/durable-run-style.git
cd durable-run-style
cargo build --release
The binary will be available at target/release/druns
.
Usage
Basic Usage
Simply prefix any command with druns
:
druns ls -la
Development Workflows
Monitor long-running development tasks:
# Watch Docker Compose services
druns docker compose up
# Run test suites
druns cargo test
# Build projects
druns npm run build
System Tasks
Track resource usage for intensive operations:
# Database migrations
druns rails db:migrate
# Video encoding
druns ffmpeg -i input.mp4 output.mp4
# Data processing
druns python process_data.py
Demo
Try the graphics demo to see the interface:
druns gfx-demo
What It Monitors
- Execution Time: Precise duration tracking from start to finish
- CPU Usage: Real-time CPU utilization percentage
- Memory Usage: Current memory consumption
- Disk I/O: Read and write operations
- Process Status: Running, completed, or failed states
- Command Output: Live output streaming
- Network Usage (Experimental): Network activity monitoring
Use Cases
- CI/CD Pipelines: Monitor resource usage in build and deployment scripts
- Development: Track compilation times and resource consumption
- System Administration: Observe system impact of maintenance tasks
- Data Processing: Monitor long-running data analysis or transformation jobs
- Container Management: Watch Docker and container operations
- Testing: Track test suite execution with detailed metrics
Philosophy
Durable Run Style is built on principles of:
- Clarity: Clear, readable presentation of system information
- Usefulness: Provide actionable metrics that help diagnose issues
- Beauty: A terminal interface thatโs pleasant to look at
- Performance: Minimal overhead while monitoring
Development
Requirements
- Rust 2024 edition
- Unix-like operating system (Linux, macOS)
Building
cargo build --release
Testing
cargo test
Contributing
Contributions are welcome! Please read our contributing guidelines before submitting pull requests.
- Fork the repository
- Create a feature branch (
git checkout -b feature/my-feature
) - Make your changes
- Ensure tests pass (
cargo test
) - Commit your changes
- Push to your fork
- Open a pull request
License
MIT License - see LICENSE.md for details.
Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
Support
For bugs, feature requests, or questions, please open an issue on GitHub.
Acknowledgments
Built with:
- ratatui - Terminal UI framework
- crossterm - Terminal manipulation
- tokio - Async runtime
- sysinfo - System monitoring
Special thanks to the Rust community for their excellent tools and documentation.
GitHub
๐ Created October 2025 | ๐ Updated October 2025