"Because life's too short to install things manually like it's 1995"
Welcome, weary traveler, to our chaotic collection of shell scripts that actually work (most of the time). These are the scripts that the Modular Misfits use when we're too lazy to remember all those installation commands... which is basically always.
This repository is organized into focused modules, each handling a specific aspect of development environment setup:
Your AI Command Line Companions
Install and configure multiple AI CLI tools in one go:
- Claude Code CLI - Anthropic's Claude in your terminal
- OpenAI Codex CLI - GPT-powered coding assistant
- Google Gemini CLI - Google's AI at your fingertips
Perfect for developers who want AI assistance without leaving the comfort of bash.
Quick Start:
cd AI-CLI-setup
./install-ai-cli.shBrowser Automation MCP Server
Set up a Model Context Protocol (MCP) server for Chromium browser automation using Playwright. Let your AI assistant control a real browser!
Features:
- Headless Chromium automation
- Python-based MCP server
- Integration with Continue extension
- Console logging and network monitoring
Quick Start:
cd chromium-setup
./mcp-chromium-setup.shVSCodium Installation & Configuration
Because we like our code editors like we like our coffee: free and open source.
codium-setup.sh- Install VSCodium (the telemetry-free VS Code)codium-postinstall.sh- Essential extensions for Python, Docker, Git, and more
Quick Start:
cd codium-setup
./codium-setup.sh
./codium-postinstall.shContinue Extension MCP Integration
A complete guide and scripts for setting up MCP servers with the Continue extension in VSCodium. Enables local AI tool execution for browser automation and system interaction.
Features:
- Node.js + Playwright setup
- TypeScript MCP server implementation
- Continue extension configuration
- Browser control tools (click, type, screenshot, eval JS)
Quick Start:
cd continue-mcp
# See README.md for detailed setup instructionsMulti-Model AI Development Assistant
A full-featured MCP server with Codium extension that provides multi-model AI assistance using both Anthropic Claude and OpenAI GPT models.
Features:
- Rust-based MCP server (high performance!)
- TypeScript VSCodium extension
- Code generation and review
- Dynamic model switching
- Context management
- Secure OAuth token handling
Quick Start:
cd multi-model-mcp
./install-prerequisites.sh
./build.shEach directory is self-contained with its own README and setup instructions. Generally:
# Navigate to the tool you want
cd <directory-name>
# Read the specific README
cat README.md
# Run the setup script
./<script-name>.shThese scripts are primarily tested on:
- ✅ macOS (Apple Silicon & Intel)
- ✅ Linux (Debian/Ubuntu-based systems)
- ✅ Raspberry Pi (aarch64, Debian)
⚠️ Windows - Use WSL2 (Windows Subsystem for Linux)
- Always read the script first:
cat script-name.sh - Check prerequisites: Most READMEs list what you need
- Have backups: We're not responsible for your data
- Use common sense:
sudois not a magic wand
Many scripts handle API keys and sensitive credentials. We follow best practices:
- Keys stored in system keychain (macOS) or secure environment variables
- No hardcoded credentials in scripts
- Clear prompts before storing sensitive data
- Option to skip credential setup
Never commit API keys to version control!
Found a bug? Want to add a script? Think our jokes are terrible?
Pull requests welcome! Just remember:
- Keep it functional
- Keep it funny (optional but encouraged)
- Keep it open source
- Don't be evil
- Test on at least one platform before submitting
- Use
#!/usr/bin/env bashor#!/usr/bin/env python3 - Make scripts idempotent (safe to run multiple times)
- Provide helpful output messages
- Include a README in the directory
- Handle errors gracefully with
set -euo pipefail
Each subdirectory contains:
- README.md - Overview, features, and usage
- Scripts - The actual automation
- Configuration examples - When applicable
Start with the main directory README, then dive into specifics!
We're just a bunch of tech enthusiasts who believe that:
- Software should be free (as in freedom, and preferably as in beer)
- Automation beats repetition
- Good documentation includes bad jokes
- The best code is the code you don't have to write
- AI should help developers, not replace them
- Read before executing - Even our scripts (especially our scripts)
- Check for updates -
git pullbefore running old scripts - Customize - These scripts are starting points, not gospel
- Share improvements - Found a better way? PR it!
- Have fun - Technology should be enjoyable
chmod +x script-name.shMake sure prerequisites are installed. Check the specific README for requirements.
- Check your internet connection
- Verify API keys are set correctly
- Look for error messages in the output
- Check the specific directory's README for known issues
First: Don't panic.
Second: Check what changed with git diff
Third: Restore from backup (you have backups, right?)
Fourth: Open an issue with details
See LICENSE.md for the boring legal stuff.
TL;DR: MIT License - Use it, modify it, share it, just give us credit (or a high-five, that works too).
If these scripts saved you time, prevented a headache, or made you smile, consider giving us a star! It helps others discover these tools and motivates us to keep improving them.
- Issues: Report bugs and request features via GitHub Issues
- Discussions: Share your setups and ask questions
- Pull Requests: Contributions always welcome!
| Directory | Purpose | Key Scripts |
|---|---|---|
| AI-CLI-setup | AI CLI tools | install-ai-cli.sh |
| chromium-setup | Browser automation MCP | mcp-chromium-setup.sh |
| codium-setup | VSCodium installation | codium-setup.sh, codium-postinstall.sh |
| continue-mcp | Continue MCP integration | See README |
| multi-model-mcp | Multi-AI assistant | build.sh, install-prerequisites.sh |
Made with ❤️, ☕, and probably too much time on our hands by the Modular Misfits
Remember: With great power comes great responsibility... but also great fun! 🎉