🎨 Visual Enhancements
Transform your terminal with modern IDE-like features that make command-line work enjoyable.
- Real-time syntax highlighting with ble.sh
- Smart auto-completions as you type
- Beautiful prompts with Starship
- Error highlighting prevents mistakes
🚀 Productivity Tools
Supercharge your workflow with intelligent history and lightning-fast file navigation.
- Searchable command history with Atuin
- Fuzzy file finding with fzf
- Cross-session sync of command history
- Auto-configuration works immediately
🛡️ Safe & Smart
Enterprise-grade safety features ensure your system stays stable and recoverable.
- Automatic backups of .bashrc
- Syntax error prevention with validation
- Built-in fix utilities for rapid recovery
- Non-destructive installation preserves configs
🐳 Universal Compatibility
Works everywhere - from local development to Docker containers and remote servers.
- Linux distributions (Ubuntu, RHEL, Arch)
- Docker containers and restricted environments
- Remote servers via SSH
- Bash 4.0+ compatibility
🎯 Perfect For
DevOps Engineers, Developers, System Administrators, and Power Users who want a modern terminal experience without the complexity of manual configuration. Ideal for teams wanting standardized, productive terminal environments.
Quick Install (Recommended)
One-command installation that downloads and configures everything automatically:
This method is perfect for most users and includes safety checks and automatic backups.
Manual Installation
For users who prefer to review the script before execution:
Activate Your Enhanced Terminal
After installation, reload your terminal configuration:
Or simply open a new terminal window - everything works automatically!
Installation Options
Customize your installation with these flags:
📋 Prerequisites
TermForge automatically installs required dependencies: curl, git, wget, and gawk. Works on all major Linux distributions with Bash 4.0+.
🐳 Docker & Container Usage
In Docker containers or environments without sudo access, use the --no-sudo flag. TermForge is perfect for development containers and CI/CD environments.
🎨 ble.sh
Bash Line Editor that transforms your shell into an IDE-like experience with real-time features.
- Real-time syntax highlighting
- Smart auto-completion
- Multi-line editing support
- Error highlighting in red
- History search integration
- Vim/Emacs key bindings
⭐ Starship
Fast, customizable cross-shell prompt that's beautiful and informative without being overwhelming.
- Git status integration
- Language version detection
- Directory information
- Execution time display
- Custom themes support
- Lightning-fast rendering
📚 Atuin
Magical shell history replacement that provides searchable, sync-able command history across sessions.
- Sqlite-backed storage
- Cross-session search
- Command context tracking
- Encrypted cloud sync
- Advanced filtering
- Statistics and insights
🔍 fzf
Command-line fuzzy finder that revolutionizes file navigation and command discovery.
- Fuzzy file searching
- Command history filtering
- Directory navigation
- Preview window support
- Custom key bindings
- Integration with other tools
🔧 All Tools Configured
TermForge automatically configures all tools to work together seamlessly. No manual configuration required - everything works immediately after installation.
🔍 Enhanced History Search
Revolutionary command history that learns from your patterns.
↑/↓ # Navigate through results
Tab # Accept suggestion
- Search across all sessions
- Context-aware suggestions
- Frequency-based ranking
📁 Fuzzy File Finding
Lightning-fast file and directory navigation.
Alt+C # Navigate to directories
**<TAB> # Fuzzy completion
- Preview window support
- Recursive directory search
- Custom filtering options
✨ Smart Syntax Highlighting
Real-time feedback as you type commands.
# Invalid commands turn red
# Strings and paths highlighted
- Instant error detection
- Path validation
- Syntax error prevention
🎯 Intelligent Completions
Context-aware suggestions that speed up your workflow.
Tab Tab # Show all options
Shift+Tab # Reverse completion
- Command argument suggestions
- File path completions
- Git branch awareness
💡 Pro Tips
- Double Tab for command help and options
- Ctrl+R then type to search command history
- Alt+. to insert last argument from previous command
- Ctrl+L to clear screen while keeping command
🔧 Quick Fixes
Built-in utilities to resolve common issues instantly.
termforge.sh-uninstall # Clean removal
- Automatic syntax validation
- Backup restoration
- Clean uninstall option
🛡️ Safety Features
Multiple layers of protection for your terminal configuration.
- Timestamped .bashrc backups
- Configuration validation
- Rollback mechanisms
- Non-destructive installation
⚠️ Common Issues
Solutions for the most frequent problems.
- Syntax errors: Run termforge.sh-fix
- Slow startup: Use --lite mode
- Permission issues: Use --no-sudo
- Conflicts: Restore from backup
🔄 Manual Recovery
Emergency procedures for worst-case scenarios.
cp ~/.bashrc.backup.* ~/.bashrc
sed -i '/Terminal Enhancer/,/End Terminal Enhancer/d' ~/.bashrc
⚠️ If Something Goes Wrong
TermForge creates automatic backups of your .bashrc file with timestamps. You can always restore your original configuration using: cp ~/.bashrc.backup.TIMESTAMP ~/.bashrc
✅ Verification Steps
- Check if syntax highlighting works while typing
- Test Ctrl+R for history search functionality
- Verify Ctrl+T opens fuzzy file finder
- Confirm prompt shows git status (if in git repo)
- Test Tab completion for enhanced suggestions
🆘 Getting Help
If you encounter issues not covered here:
- Check the GitHub Issues page
- Run
termforge.sh --helpfor detailed options - Use
termforge.sh --fixfor automatic repairs - Report bugs with system details and error messages