rpriven
4cf7feba69
- Add menu option 9: Security Research Info - Display comprehensive info about toolbelt and tmux-recon - Add post-install message recommending security tools - Update README with Security Research Tools section - Document recommended installation flow for security researchers This integrates fresh with the complementary security tool ecosystem: - toolbelt: Security tool installer for Kali/Debian - tmux-recon: Pentesting automation and environment setup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
224 lines
8.5 KiB
Markdown
224 lines
8.5 KiB
Markdown
# Fresh - Linux System Setup Tool
|
|
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](https://www.gnu.org/software/bash/)
|
|
|
|
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](https://github.com/rpriven/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](https://github.com/rpriven/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
|
|
|
|
```bash
|
|
# 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
|
|
```bash
|
|
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
|
|
```bash
|
|
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
|
|
```bash
|
|
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
|
|
```bash
|
|
./fresh.sh
|
|
# Select option 2: Standard
|
|
# Gets you modern CLI tools for daily use
|
|
```
|
|
|
|
### Developer Workstation
|
|
```bash
|
|
./fresh.sh
|
|
# Select option 3: Developer
|
|
# Includes all productivity tools + development environment
|
|
```
|
|
|
|
### Enhanced Workflow Setup
|
|
```bash
|
|
./fresh.sh
|
|
# Select option 8: Enhanced Shell
|
|
# Adds advanced shell commands and workflows
|
|
```
|
|
|
|
### Complete AI Infrastructure
|
|
```bash
|
|
./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](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. 🚀
|