Lib.rs

› Command line utilities
#docker #container-management #terminal #management

app dui-cli

An intuitive Docker management CLI built in Rust with full Docker command parity

Owned by ukhan1219.

11 stable releases

4.1.12 Sep 4, 2025
4.0.10 Aug 1, 2025

#1760 in Command line utilities

Download history 93/week @ 2025-07-27 25/week @ 2025-08-03 1/week @ 2025-08-10 668/week @ 2025-08-31 111/week @ 2025-09-07 2/week @ 2025-09-14 8/week @ 2025-09-28 3/week @ 2025-10-05

83 downloads per month

MIT license

230KB
5K SLoC

Rust 3.5K SLoC // 0.0% comments Shell 1.5K SLoC // 0.1% comments Ruby 20 SLoC // 0.1% comments

DUI - Docker User Interface

An intuitive Docker management CLI built in Rust with full Docker command parity and enhanced user experience

Crates.io License: MIT Rust

DUI provides a beautiful, intuitive interface for Docker management with 100% Docker CLI command coverage and enhanced user experience features like tab completion, interactive menus, and real-time visualizations.

✨ Features

🚀 Intelligent Docker Management

  • Auto-Start Docker Daemon - Automatically detects and starts Docker if not running
  • Cross-Platform Support - Works on macOS, Linux, and Windows
  • Smart Error Handling - Provides helpful suggestions when Docker issues occur
  • Graceful Startup - Waits for Docker daemon to be ready before proceeding

🐳 Complete Docker Command Parity

  • All 40+ Docker commands supported with intuitive interfaces
  • Container lifecycle management (create, start, stop, restart, pause, unpause, remove)
  • Advanced container operations (attach, commit, cp, diff, export, kill, port, rename, top, update, wait)
  • Image management (pull, build, tag, push, remove, history, import, load, save)
  • Network and volume management
  • System monitoring and events

🎨 Enhanced User Experience

  • Interactive mode with numbered menus and tab completion
  • Real-time progress indicators for long-running operations
  • Color-coded output for better readability
  • Smart command suggestions and contextual help
  • Beautiful ASCII charts and visualizations
  • Comprehensive error handling with actionable suggestions

🔧 Developer-Friendly Features

  • Tab completion for all commands and container/image names
  • Command history with search functionality
  • Interactive command builders with validation
  • Batch operations and scripting support
  • Real-time monitoring dashboard

🚀 Quick Start

Installation

Using Homebrew (macOS/Linux)

brew install ukhan1219/dui/dui

Using Cargo

cargo install dui-cli

Manual Installation

Download the latest release from GitHub Releases and add the binary to your PATH.

From Source

git clone https://github.com/ukhan1219/dui.git
cd dui
cargo build --release
cargo install --path .

📖 Usage

Basic Commands

Container Management

# List all containers
dui containers list

# Create a new container
dui containers create my-container nginx:latest -p 8080:80 -v /host/path:/container/path -e ENV_VAR=value

# Start a container
dui containers start my-container

# Stop a container
dui containers stop my-container

# Restart a container
dui containers restart my-container

# Pause/Unpause a container
dui containers pause my-container
dui containers unpause my-container

# Remove a container
dui containers remove my-container

# View container logs
dui containers logs my-container

# Execute command in container
dui containers exec my-container /bin/bash

# Inspect container details
dui containers inspect my-container

# Get container information
dui containers info my-container

# Get container size
dui containers size my-container

# Attach to a running container
dui containers attach my-container

# Create image from container changes
dui containers commit my-container my-repo:latest

# Copy files between container and host
dui containers cp my-container /data /backup

# Show container filesystem changes
dui containers diff my-container

# Export container filesystem
dui containers export my-container backup.tar

# Kill a running container
dui containers kill my-container

# List port mappings
dui containers port my-container

# Rename a container
dui containers rename old-name new-name

# Show container processes
dui containers top my-container

# Update container configuration
dui containers update my-container

# Wait for container to stop
dui containers wait my-container

Image Management

# List all images
dui images list

# Pull an image
dui images pull nginx:latest

# Build an image
dui images build /path/to/dockerfile my-image:tag

# Tag an image
dui images tag source-image:tag new-image:tag

# Push an image
dui images push my-image:tag

# Remove an image
dui images remove nginx:latest

# Show image history
dui images history nginx:latest

# Import image from tarball
dui images import backup.tar my-repo:latest

# Load image from tar archive
dui images load nginx.tar

# Save image to tar archive
dui images save nginx:latest nginx.tar

Network & Volume Management

# List Docker networks
dui networks

# List Docker volumes
dui volumes

Resource Monitoring

# View container statistics
dui monitor stats

# View system information
dui monitor system

# Monitor Docker events (real-time)
dui monitor events

# View real-time dashboard
dui monitor dashboard

# Display various charts
dui monitor charts

Visual Charts & Analytics

# CPU usage chart
dui charts cpu

# Memory usage chart
dui charts memory

# Network traffic chart
dui charts network

# Storage usage chart
dui charts storage

# Container status chart
dui charts status

# Image size chart
dui charts images

# System pie chart
dui charts pie

# Real-time dashboard
dui charts dashboard

Interactive Mode

# Launch interactive mode with tab completion
dui interactive

In interactive mode, you can use simplified commands with full tab completion:

  • containers - List containers with interactive menu
  • images - List images with interactive menu
  • networks - List networks
  • volumes - List volumes
  • stats - Show statistics
  • system - Show system information
  • events - Monitor Docker events
  • dashboard - Show real-time dashboard
  • charts - Display all charts
  • cpu-chart - CPU usage chart
  • memory-chart - Memory usage chart
  • pie-chart - System pie chart
  • help - Show help
  • exit - Exit interactive mode

Examples

# Quick container overview
dui containers list

# Create and run a new web server
dui containers create web-server nginx:latest -p 8080:80
dui containers start web-server

# Advanced container operations
dui containers commit my-app my-repo:latest
dui containers cp my-app /data /backup
dui containers export my-app backup.tar
dui containers top my-app

# Image operations
dui images history nginx:latest
dui images save nginx:latest nginx.tar
dui images load nginx.tar

# Monitor resource usage with charts
dui charts cpu
dui charts memory

# Interactive session with tab completion
dui interactive
> containers
> start 1
> stats
> charts
> exit

🎯 Features in Detail

Advanced Container Management

  • Container Creation: Create containers with port mappings, volume mounts, and environment variables
  • Container Inspection: Detailed container information and configuration
  • Size Analysis: Container disk usage and resource consumption
  • Exec Support: Execute commands inside running containers
  • Comprehensive Lifecycle: Full container lifecycle management
  • Advanced Operations: Attach, commit, copy, diff, export, kill, port mapping, rename, process monitoring, update, wait

Visual Analytics & Charts

  • CPU Usage Charts: Real-time CPU consumption with color-coded bars
  • Memory Usage Charts: Memory consumption with percentage and absolute values
  • Network Traffic Charts: Network I/O visualization
  • Storage Usage Charts: Disk usage analytics
  • Status Charts: Container state distribution
  • Image Size Charts: Docker image size analysis
  • System Pie Charts: Overall system resource distribution
  • Real-time Dashboard: Live system overview

Interactive Mode Features

  • Tab Completion: Intelligent command and container/image name completion
  • Interactive Menus: Numbered lists for easy container/image selection
  • Command History: Persistent command history
  • Syntax Highlighting: Color-coded command input
  • Smart Suggestions: Context-aware command suggestions
  • Real-time Feedback: Immediate feedback for all operations

Network & Volume Management

  • Network Listing: View all Docker networks with details
  • Volume Management: List and inspect Docker volumes
  • Resource Discovery: Easy discovery of Docker resources

🔧 Technical Architecture

Core Components

  • CLI Layer (main.rs): Command parsing and routing with comprehensive argument handling
  • Docker Integration (docker.rs): Complete Docker API wrapper with 40+ command implementations
  • User Interface (ui.rs): Enhanced UI with color-coded output and interactive menus
  • Tab Completion (completion.rs): Intelligent command completion using rustyline
  • Visual Charts (charts.rs): Real-time chart rendering with ASCII art
  • Utilities (utils.rs): Shared helper functions and validation

Dependencies

  • clap: Command-line argument parsing
  • colored: Terminal color support
  • rustyline: Interactive line editing with tab completion
  • crossterm: Cross-platform terminal manipulation
  • tui: Terminal UI components
  • serde: Serialization/deserialization
  • tokio: Async runtime (optional)

Build Configuration

  • Rust Version: 1.70.0+
  • Optimization: LTO enabled for release builds
  • Panic Strategy: Abort on panic for smaller binaries
  • Code Generation: Single codegen unit for better optimization

🚀 Performance & Reliability

  • Fast Startup: Optimized binary with minimal dependencies
  • Memory Efficient: Low memory footprint for long-running sessions
  • Error Handling: Comprehensive error handling with user-friendly messages
  • Validation: Input validation for all commands and parameters
  • Cross-Platform: Works on macOS, Linux, and Windows

📚 Documentation

  • Updated README with all features and examples
  • Comprehensive command reference
  • Interactive mode guide
  • Setup and deployment documentation (see SETUP.md)
  • Contributing guidelines

🤝 Contributing

We welcome contributions! Please see our contributing guidelines:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Make your changes and add tests
  4. Commit your changes: git commit -m 'Add amazing feature'
  5. Push to the branch: git push origin feature/amazing-feature
  6. Open a Pull Request

Development Setup

# Clone the repository
git clone https://github.com/ukhan1219/dui.git
cd dui

# Build the project
cargo build

# Run tests
cargo test

# Install locally
cargo install --path .

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Built with Rust
  • Uses clap for command-line argument parsing
  • Uses rustyline for interactive line editing
  • Uses colored for terminal colors
  • Uses tui-rs for terminal UI components

DUI - Making Docker management beautiful and intuitive! 🐳✨

Dependencies

~7–20MB
~227K SLoC