🚀 OS Post-Install Scripts

Transform your fresh OS installation into a fully configured development environment in minutes!

Quick Start • What Gets Installed • Documentation • Contributing

---

🎯 Quick Start

Prerequisites

Important: This project requires modern tools. See REQUIREMENTS.md for details.

• Bash 4.0+ (macOS users need to upgrade)
• Git 2.25+
• jq 1.6+

Quick Install (Auto-installs requirements)

git clone https://github.com/BragatteMAS/os-postinstall-scripts
cd os-postinstall-scripts
./quick-setup.sh  # Handles requirements automatically

Manual Install (Requires prerequisites)

git clone https://github.com/BragatteMAS/os-postinstall-scripts
cd os-postinstall-scripts
./setup.sh  # Will check requirements first

Profile-Based Install

./setup.sh --profile=developer-minimal  # Minimal setup
./setup.sh --profile=data-scientist     # Data science tools

---

📦 What Gets Installed

🛠️ Development Tools

• Version Control: Git, Git LFS, GitHub CLI
• Containers: Docker, Docker Compose, Podman
• Languages: Python, Node.js, Rust, Go, Java
• Editors: VS Code, Vim, Neovim
• Build Tools: Make, CMake, GCC

🦀 Modern CLI Tools

Traditional	Modern	Description
cat	bat	Syntax highlighting
ls	eza	Icons & Git status
find	fd	Intuitive & fast
grep	ripgrep	Blazing fast
cd	zoxide	Smart navigation

Install all Rust tools: ./scripts/install/rust-tools.sh

🎨 Shell Configuration

• Zsh with Oh My Zsh
• Starship prompt
• 1700+ lines of optimizations
• 100+ aliases and functions
• Auto-completions and suggestions

📱 Applications

• Browsers: Firefox, Chrome, Brave
• Communication: Discord, Slack, Telegram
• Productivity: Obsidian, LibreOffice, Flameshot
• Media: VLC, Spotify, OBS Studio
• Utilities: Timeshift, Stacer, Htop

🤖 AI Development Tools

• MCPs (Model Context Protocol) - 7 essential tools: - context7 - Always up-to-date documentation
  • fetch - Intelligent web requests
  • sequential-thinking - Structured reasoning
  • serena - Semantic code search
  • fastapi - FastAPI documentation and examples
  • A2A - Google A2A (AI to AI) tools
  • system-prompts-and-models-of-ai - Optimized prompts library
• BMAD Method v4.31.0 - Complete project management
  • Easy installation with ./scripts/install/bmad.sh
  • Supports Claude Code and Cursor IDEs
  • Easy updates with ./tools/update/bmad.sh
  • Automatic backup before updates
  • Version checking and comparison
• Auto-configuration for Claude Desktop
• Slash commands in Claude (/generate-prp, /execute-prp)

Install: ./scripts/install/ai-tools.sh or choose option 9 in setup menu

---

🖥️ Supported Systems

• ✅ Linux: Ubuntu 20.04+, Pop!_OS, Mint, Fedora, Arch
• ✅ Windows: Windows 11 (PowerShell)
• 🚧 macOS: Basic support (expanding)

---

⚡ Features

• 🎯 One-command setup - Get running in minutes
• 📦 Smart package management - APT, Snap, Flatpak, Winget
• 🔒 Security first - Safe APT lock handling, no forced removals
• 🧪 Tested - CI/CD with GitHub Actions
• 📝 Well documented - Clear guides and examples
• 🛠️ Modular - Install only what you need
• 🔄 Idempotent - Safe to run multiple times
• 🤖 AI-Powered Development - MCPs + BMAD Method integration

---

📁 Project Structure

os-postinstall-scripts/
├── scripts/                    # All executable scripts
│   ├── install/               # Installation scripts
│   │   ├── ai-tools.sh       # AI development tools
│   │   ├── bmad.sh           # BMAD Method installer
│   │   ├── rust-tools.sh     # Modern Rust CLI tools
│   │   └── git-focused.sh    # Git configuration
│   ├── setup/                 # Setup and configuration
│   │   ├── main.sh           # Main setup script
│   │   ├── with-profile.sh   # Profile-based setup
│   │   └── ai-project.sh     # AI project setup
│   └── utils/                 # Shared utilities
│       └── logging.sh         # Logging functions
├── platforms/                  # Platform-specific code
│   ├── linux/                 # Linux distributions
│   ├── macos/                 # macOS support
│   └── windows/               # Windows PowerShell
├── configs/                    # Configuration files
│   ├── profiles/              # Installation profiles
│   ├── templates/             # Reusable templates
│   └── shell/                 # Shell configurations
├── docs/                       # Documentation
│   ├── guides/                # User guides
│   └── architecture/          # Technical decisions
├── tests/                      # Test suite
└── tools/                      # Development tools

---

📚 Documentation

• 📖 User Guide - Detailed instructions
• 🏗️ Architecture - How it works
• 🤖 AI Tools Setup - MCPs + BMAD configuration
• 🤝 Contributing - Help us improve
• 📋 Changelog - What's new
• 🗺️ Roadmap - Where we're going

For Developers

• 🏛️ Architecture Decisions - Why we built it this way
• 📋 Project Status - Current development status
• 📖 Product Requirements - Project objectives and scope
• 📚 User Stories - User journeys and requirements
• 🧪 Testing Strategy - Testing approach and guidelines
• 🤖 AI Context - For AI-assisted development

---

🤝 Contributing

We love contributions! See CONTRIBUTING.md for guidelines.

Quick Contribution Guide

1. 🍴 Fork the repository
2. 🌿 Create a feature branch
3. 📝 Make your changes
4. ✅ Run tests: ./tests/test_harness.sh
5. 📤 Submit a pull request

Priority Areas

• 🍎 macOS scripts - Expand platform support
• 🧪 Tests - Increase coverage
• 📚 Documentation - Improve guides
• 🌍 Translations - Make it global

---

🛡️ Security

• ✅ No forced lock removal - Safe APT operations
• ✅ Input validation - Protected against injection
• ✅ Audit logging - Track all operations
• 🐛 Found a vulnerability? See SECURITY.md

---

📄 License

MIT License - see LICENSE for details.

---

_{Built with ❤️ by Bragatte, M.A.S}