🎯 claude-blocker - Focus Better When It Matters

📖 Overview

Claude Blocker helps you manage distractions. It blocks distracting websites whenever Claude Code is running. The idea is simple: focus on your tasks while Claude handles the heavy lifting. When Claude stops, the distractions return.

How It Works

┌─────────────────┐     hooks      ┌─────────────────┐    websocket    ┌─────────────────┐
│   Claude Code   │ ─────────────► │  Blocker Server │ ◄─────────────► │ Chrome Extension│
│   (terminal)    │                │  (localhost)    │                 │   (browser)     │
└─────────────────┘                └─────────────────┘                 └─────────────────┘
       │                                   │                                   │
       │ UserPromptSubmit                  │ tracks sessions                   │ blocks sites
       │ PreToolUse                        │ broadcasts state                  │ shows modal
       │ Stop                              │                                   │ bypass button
       └──────────────────────

🚀 Getting Started

System Requirements

• Operating System: Windows 10 or later, macOS 10.14 or later, or a recent version of Linux.
• Browser: Google Chrome or Chromium-based browsers.
• Internet Connection: Required for initial setup and updates.

Install Claude Blocker

1. Visit the GitHub Releases Page

   Click the link below to access the downloads:

   Download claude-blocker

2. Download the Latest Version

   On the releases page, find the most recent version. Click on the download link for your operating system. The file will save to your computer.

3. Run the Installer

   Locate the downloaded file and double-click it. Follow the installation prompts to complete the process.

4. Setup Claude Code

   Before using Claude Blocker, you need to run Claude Code. Open a terminal or command prompt, and launch Claude Code. Once it’s running, you can open the Chrome extension.

5. Open the Chrome Extension

   Launch Google Chrome and navigate to the extensions menu. Find Claude Blocker in your extensions list and open it.

6. Configure Settings

   Adjust settings to your liking. You can choose which websites to block or keep unblocked.

7. Start Using Claude Blocker

   With Claude Code running, Claude Blocker will now block the distracting sites you've selected. Focus on your work and enjoy the distraction-free environment.

🌐 Download & Install

To get started with Claude Blocker, follow the link below to access the downloads:

Download claude-blocker

🛠 Troubleshooting

Common Issues

• Extension Not Blocking Websites: Ensure Claude Code is running properly. The connection between Claude Code and the Blocker Server is essential.
• Installation Errors: If the installer fails, make sure you have the required permissions on your device. Try running as an administrator.

Support

If you need further assistance, check the Issues tab on the GitHub repository. You can report bugs or seek help from the community.

📄 License

Claude Blocker is open-source software licensed under the MIT License. You can view the full license on the repository.

🙌 Contributions

Contributions are welcome! If you'd like to help improve Claude Blocker, feel free to submit a pull request or open an issue.

📣 Acknowledgments

Thank you to everyone who contributed to Claude Blocker. Your support helps make this project better for everyone.