Fresh - Linux System Setup Tool

A comprehensive, interactive installation script for setting up new Linux systems and VPS instances with modern CLI tools and enhanced productivity workflows.

🚀 Features

• Multiple Installation Tiers: Choose from Minimal, Standard, Developer, or Full setups
• Modern CLI Tools: Includes the latest productivity tools like fzf, ripgrep, bat, eza, atuin
• Enhanced Shell Configuration: Advanced aliases and workflows for power users
• PAI Integration: Optional Personal AI Infrastructure setup with voice server and Claude integration
• Interactive Menus: User-friendly selection process with progress tracking
• Smart Detection: Automatically detects your system and installs appropriate packages

🛠️ Installation Tiers

📦 Minimal

Essential tools for any Linux system:

• curl, wget, git, unzip, tree, tmux, htop, nano, jq

🔧 Standard

Common CLI productivity tools:

• Minimal + fzf, ripgrep, fd, bat, eza, btop, zoxide, atuin

👨‍💻 Developer

Development tools and languages:

• Standard + build-essential, cmake, nodejs, docker, python3-pip

🎯 Full

Everything including security and multimedia:

• Developer + keepassxc, lynis, ffmpeg, yt-dlp, taskwarrior

🚀 Enhanced Shell

Advanced shell configuration with:

• Context Manager (cm): Navigate and search knowledge bases with fzf
• Smart File Operations: Enhanced file browsing with syntax highlighting
• Git Integration: Visual git log browser and enhanced workflows
• Process Management: Interactive process browser and management
• Smart History: Atuin integration for intelligent command history

🤖 PAI Setup

Complete Personal AI Infrastructure including:

• Voice server with ElevenLabs integration
• Enhanced Claude Code configuration
• AI workflow automation tools
• Enhanced Shell configuration included

🔒 Security Research Tools

Fresh provides a solid foundation for security research environments. For comprehensive pentesting and security tools, check out these complementary projects:

toolbelt - Security Tool Installer

Comprehensive security tool installer with:

• Full pentesting arsenal for Kali Linux
• Security essentials for Debian/Ubuntu
• Interactive menu with pre-built profiles (Bug Bounty, CTF, Full Pentest)
• APT, Go, Python, Docker, and /opt tools
• Scripts collection (linpeas, winpeas, PowerView, etc.)

Best for: Bug bounty hunting, CTF competitions, penetration testing, security research

tmux-recon - Pentesting Automation

Pentesting automation and shell environment with:

• Advanced tmux configuration for pentesting workflows
• Zsh setup with security-focused plugins
• Automated reconnaissance scripts
• ProjectDiscovery tool integration
• Oh-my-tmux pentesting environment

Best for: Setting up pentesting shell environment, automated recon workflows, security research productivity

Recommended Flow for Security Researchers

1. Install fresh (Standard or Developer tier) - Modern CLI foundation
2. Install toolbelt - Comprehensive security tools
3. Install tmux-recon - Pentesting automation & environment

Run fresh and select option 9 for detailed information about these tools.

📋 Quick Start

# Clone the repository
git clone https://github.com/rpriven/fresh.git
cd fresh

# Make executable and run
chmod +x fresh.sh
./fresh.sh

🎛️ Menu Options

┌─────────────────────────────────────────────────────────────────────┐
│                        FRESH - Linux Setup                         │
├─────────────────────────────────────────────────────────────────────┤
│  1. Minimal          - Essential CLI tools for any Linux system    │
│  2. Standard         - Minimal + modern productivity tools         │
│  3. Developer        - Standard + development tools                │
│  4. Full             - All tools + security, multimedia, utils     │
│  5. Custom           - Choose specific tool categories             │
│  6. Show Tools       - Display available tools by category         │
│  7. PAI              - Install Personal AI Infrastructure          │
│  8. Enhanced Shell   - Install enhanced shell commands only        │
│  9. Security Research - Info about pentesting & security tools     │
│  0. Exit                                                           │
└─────────────────────────────────────────────────────────────────────┘

💡 Enhanced Shell Commands

After installing Enhanced Shell configuration, you'll have access to:

📂 Context Management

cm          # Browse all contexts with fzf preview
cms         # Search content across all contexts
cmr         # Show recently modified contexts
cmn         # Create new context file
cmt         # Display context directory tree

🔍 Advanced File Operations

fzfg        # Grep with ripgrep + jump to line in editor
fzfd        # Directory browser with tree preview
vp          # File browser with bat syntax highlighting
gfzf        # Git log browser with commit preview
psg         # Process browser with fzf selection

📚 Smart Tools

h           # Smart history search with atuin
findcmd     # Search available commands

🔧 Requirements

• OS: Ubuntu/Debian-based Linux distributions
• Package Manager: apt (dpkg-based systems)
• Privileges: sudo access for package installation
• Shell: Bash 4.0+ (Enhanced Shell features work with bash/zsh)

📁 What Gets Installed

Core Tools

• File Management: bat (syntax highlighting), eza (modern ls), fd (fast find)
• Search: fzf (fuzzy finder), ripgrep (fast grep), ag (silver searcher)
• Navigation: zoxide (smart cd), atuin (smart history)
• System: btop (system monitor), dust (disk usage), procs (process viewer)

Development

• Languages: Node.js, Python 3, build tools
• Containers: Docker, Docker Compose
• Version Control: Git, tig (git browser)
• Editors: Micro, Nano

Security & Utilities

• Security: Lynis, AIDE, KeePassXC
• Multimedia: FFmpeg, yt-dlp
• Productivity: TaskWarrior, NCurses Disk Usage

🎯 Usage Examples

Quick Productivity Setup

./fresh.sh
# Select option 2: Standard
# Gets you modern CLI tools for daily use

Developer Workstation

./fresh.sh
# Select option 3: Developer
# Includes all productivity tools + development environment

Enhanced Workflow Setup

./fresh.sh
# Select option 8: Enhanced Shell
# Adds advanced shell commands and workflows

Complete AI Infrastructure

./fresh.sh
# Select option 7: PAI
# Installs complete AI infrastructure + enhanced shell

🔗 Integration

Fresh integrates seamlessly with:

• Dotfiles: Install your personal configurations after Fresh setup
• Shell Frameworks: Works with Oh My Zsh, Prezto, or standalone configs
• Package Managers: Complements Homebrew, Nix, or other package managers
• CI/CD: Use in automation scripts for consistent environment setup

🤝 Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for:

• Additional tool suggestions
• New installation tiers
• Platform support (CentOS, Arch, etc.)
• Bug fixes and improvements

📝 License

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

🙏 Acknowledgments

• Thank you to Daniel Miessler for building and open-sourcing PAI (https://github.com/danielmiessler/PAI)
• Built for modern Linux productivity workflows
• Inspired by the need for consistent, reproducible development environments
• Integrates the best modern CLI tools available

---

Fresh - Because every new system deserves a fresh start with the right tools. 🚀