Crust Shell Overview
Crust Shell is a modern, feature-rich terminal shell written in Python that enhances your command-line experience with beautiful output, intelligent features, and AI integration.
🌟 What is Crust Shell?
Crust Shell is an interactive command-line shell that uses Bash as the scripting language, while providing additional functionality and a much more visually appealing interface. It’s designed to make terminal work more productive and enjoyable.
🎯 Key Features
🎨 Rich Terminal Interface
- Colorful Output: Uses the Rich Python library for beautiful, colored terminal output
- Structured Display: Tables for directory listings, system information, and more
- Status Indicators: Clear visual feedback for commands and operations
🔧 Enhanced Command Experience
- Smart Prompt: Shows current directory, git repository info, branch, and virtual environment
- Built-in Commands: Extended functionality beyond standard shell commands
- Command Aliases: Customizable command shortcuts and aliases
📦 Package Management Integration
- Multi-Platform Search: Search packages across PyPI, AUR, APT, npm, and many more
- Package Availability: Quick check if packages exist in different repositories
- Cross-Platform Support: Works with package managers from different ecosystems
🤖 AI Integration
- Question Assistant: Ask questions and get AI-powered help with
.question - System Troubleshooting: Dedicated troubleshooting mode with AI guidance
- Command Execution: AI can suggest and execute commands with your permission
🔄 Git Integration
- Repository Detection: Automatically detects git repositories
- Branch Information: Shows current branch in the prompt
- Repository Name: Displays the current repository name
📊 System Information
- Disk Usage: Beautiful table display of disk usage (
disk usage) - USB Devices: List connected USB devices (
lsusb) - Directory Listings: Enhanced
lscommand with table format
🏗️ Architecture
Core Components
- Main Shell Loop: Interactive command processing and execution
- Rich UI: Beautiful terminal output and formatting
- Configuration System: Dynamic configuration loading and management
- AI Integration: Cohere API integration for intelligent assistance
Modular Design
- Base Module: Core console and table functionality
- Config Finder: Locates and loads configuration files
- Package Checker: Multi-platform package availability checking
- Troubleshooting: AI-powered system diagnostics
🎪 Use Cases
For Developers
- Enhanced Development Workflow: Better git integration and virtual environment support
- Package Discovery: Quickly find packages across different ecosystems
- AI Code Assistance: Get help with commands and troubleshooting
For System Administrators
- System Monitoring: Enhanced system information display
- Troubleshooting: AI-assisted problem diagnosis and resolution
- Cross-Platform Tools: Consistent interface across different systems
For Power Users
- Customization: Extensive alias and configuration options
- Productivity: Streamlined common tasks with enhanced commands
- Visual Feedback: Clear, colored output for better information parsing
🔮 Future Vision
Crust Shell aims to be:
- Intelligent: Learn from usage patterns and provide smart suggestions
- Extensible: Easy plugin system for custom functionality
- Cross-Platform: Consistent experience across Linux, macOS, and Windows
- Community-Driven: Open source with community contributions and extensions
🚀 Getting Started
Ready to try Crust Shell? Check out the Installation Guide to get started, then explore the User Guide to learn about all the features and commands available to you.
Crust Shell - Making the terminal beautiful and intelligent