Table of Contents
- The Problem
- The Solution
- Installation
- Quick Start
- Choose Your Style 🎨
- Supported AI Providers
- Real-World Examples
- Configuration
- When It Shines ⭐
- Why You'll Love It
- Get Started Now
- Contributing
- License
Take back the web. One clean page at a time.
A powerful CLI tool that strips away the chaos of the modern web and gives you pure, distraction-free content—archived locally, beautifully formatted, and ready to read.
Remember when reading online was actually... enjoyable?
The modern web has become an assault course:
- 🚨 Popups ambush you before you read a single word
- 📢 Ads scream for attention from every corner
- 🔒 Paywalls block you from content you came to see
- 🎯 Tracking scripts harvest your every move
- 📊 Navigation clutter devours your screen space
You didn't come to fight through noise. You came to read.
Declutter uses AI to intelligently extract the content you actually want—the article, the story, the information—and discards everything else. Then it saves a beautifully formatted version locally, giving you:
✅ Zero distractions - No ads, popups, or clutter
✅ Offline access - Read anywhere, anytime
✅ Beautiful formatting - Six professional styles to choose from
✅ Multiple formats - Save as Markdown, HTML, or PDF
✅ Fast & flexible - Works with Gemini, Claude, GPT, OpenRouter, or local Ollama models
 |
 |
|---|
The easiest way to install on Mac is via Homebrew:
brew tap subranag/declutter
brew install declutterDownload the latest release for your architecture:
# For x86_64
curl -L https://github.com/subranag/declutter/releases/download/vlatest/declutter-linux-x64.tar.gz -o declutter-linux-x64.tar.gz
tar -xzf declutter-linux-x64.tar.gz
chmod +x declutter-linux-x64
sudo mv declutter-linux-x64 /usr/local/bin/declutter
# For ARM64
curl -L https://github.com/subranag/declutter/releases/download/vlatest/declutter-linux-arm64.tar.gz -o declutter-linux-arm64.tar.gz
tar -xzf declutter-linux-arm64.tar.gz
chmod +x declutter-linux-arm64
sudo mv declutter-linux-arm64 /usr/local/bin/declutterDownload the latest Windows executable from the releases page:
- Download
declutter-windows-x64.tar.gzfrom the latest release - Extract the archive (using 7-Zip, WinRAR, or Windows native extraction)
- Rename the extracted executable
declutter-windows-x64todeclutter.exe - Move it to a directory in your PATH, or add its location to your PATH environment variable
Or use PowerShell:
# Download and extract
Invoke-WebRequest -Uri "https://github.com/subranag/declutter/releases/download/vlatest/declutter-windows-x64.tar.gz" -OutFile "declutter-windows-x64.tar.gz"
tar -xzf declutter-windows-x64.tar.gz
# Rename and move to a directory in your PATH (e.g., C:\Program Files\declutter\)
Rename-Item -Path "declutter-windows-x64" -NewName "declutter.exe"
Move-Item -Path "declutter.exe" -Destination "C:\Program Files\declutter\"declutter --help# Using default settings (Gemini + PDF output)
declutter exec https://example.com/article
# With your preferred provider
declutter exec https://news.site/story --provider anthropic
# Choose your style
declutter exec https://blog.com/post --style CLASSIC_BOOK --format pdf# Launch REPL mode
declutter repl --provider openai --style MINIMALIST_MODERN
# Then paste URLs one at a time as you browse# Turn your markdown files into styled PDFs or HTML
declutter convert ~/Documents/notes.md --format pdf --style REFINED_ELEGANCEDeclutter offers six carefully crafted visual styles:
| Style | Perfect For |
|---|---|
| MINIMALIST_SWISS | Clean, grid-based reading (default) |
| BRUTALIST_CONCRETE | Bold, statement typography |
| CLASSIC_BOOK | Traditional, book-like elegance |
| TECH_TERMINAL | Monospace, developer-friendly |
| MINIMALIST_MODERN | Contemporary and spacious |
| REFINED_ELEGANCE | Sophisticated and polished |
Pick the model that works for you:
- Gemini - Fast and free (default:
gemini-2.5-flash) - Anthropic - High quality (default:
claude-haiku-4-5) - OpenAI - Reliable classic (default:
gpt-4o-mini) - OpenRouter - Access to many models (default:
google/gemini-2.0-flash-exp:free) - Ollama - Run locally, 100% private (default:
deepseek-r1:7b)
Configure with environment variables or command flags. See the full documentation for API key setup.
Save a research article for offline reading:
declutter exec https://research.edu/paper \
--provider anthropic \
--style CLASSIC_BOOK \
--format pdf \
--directory ~/ResearchQuickly grab news articles during your commute prep:
declutter repl --provider gemini --format md --directory ~/ToRead
# Then paste URLs from your browserConvert your markdown notes into beautiful PDFs:
declutter convert ~/Notes/meeting-notes.md \
--format pdf \
--style REFINED_ELEGANCEArchive documentation with monospace styling:
declutter exec https://docs.framework.com/guide \
--style TECH_TERMINAL \
--max_tokens 20000 \
--format htmlSet up your API keys (pick one or more):
export GEMINI_API_KEY="your-key-here"
export ANTHROPIC_API_KEY="your-key-here"
export OPENAI_API_KEY="your-key-here"
export OPENROUTER_API_KEY="your-key-here"
# Ollama requires no API keySet your preferred default model (optional):
export DEFAULT_DECLUTTER_MODEL="gpt-4o"Declutter works brilliantly for:
- 📰 News articles and journalism
- 📝 Blog posts and essays
- 📚 Documentation and guides
- 🔬 Research papers and reports
- 💬 Long-form content of any kind
Fair warning: Heavily JavaScript-dependent sites, complex web apps, or aggressive anti-scraping measures may not work perfectly. For 95% of the web's content, though? Declutter delivers.
🎯 Laser-focused on content - Gets the signal, kills the noise
⚡ Blazingly fast - Process pages in seconds
🎨 Gorgeous output - Professional styling out of the box
🔒 Privacy-first - Use local models if you want
🛠️ Flexible - Works with your preferred AI provider
📦 Portable - Take your archived content anywhere
# Try it on this README!
declutter exec https://github.com/yourusername/declutterThe web doesn't have to be exhausting. Take it back.
Issues, ideas, and pull requests welcome! Let's make the web readable again.
GNU General Public License v3.0
Made with ❤️ for people who just want to read