devfocus/README.md

CLI tool for developers to block distracting websites

# DevFocus 🚀
A cross-platform CLI tool designed for developers to block distracting websites, enabling a distraction-free coding environment by modifying the system hosts file.

## Why DevFocus CLI 🤔? 
- **🆓 Zero cost - Keep your money for coffee**
- **🛡️ Block everything - No limits, no leaks**
- **🖥️ Terminal simple - Clean, fast commands**
- **✨ No ads - Distraction-free zone**
- **🧑‍💻 Developer native - Speaks your language**

## Features ✨
- **Block Websites** 🚫: Add websites to a block list to prevent access during coding sessions.
- **Focus Mode** ⚡: Toggle focus mode to block or unblock websites instantly (`on` or `off`).
- **Focus Mode Scheduled** ⏰: Specify hours to focus, and it will schedule the unblocking for you.
- **Cross-Platform** 🌍: Works on macOS, Linux, and Windows.
- **Developer-Friendly** 👨‍💻: Simple commands to manage distractions, ideal for deep work and coding sprints.

## Installation 📦

### Via npm
```bash
sudo npm install --location=global devfocus
```
Requires Node.js v16 or higher.

## Usage 💻
Run commands with `sudo` on macOS/Linux or as Administrator on Windows for commands that modify the hosts file (`focus`, `clear`).

- **Add websites to block**:
  ```bash
  devfocus add youtube.com instagram.com reddit.com
  ```
- **Remove websites**:
  ```bash
  devfocus remove youtube.com
  ```
- **Toggle focus mode**:
  ```bash
  sudo devfocus on   # Block websites
  sudo devfocus on -h 2 # Block websites for 2 hours

  sudo devfocus off  # Unblock websites
  ```
- **List blocked websites**:
  ```bash
  devfocus list
  ```
- **Clear block list**:
  ```bash
  sudo devfocus clear
  ```

## Requirements 📋
- **Node.js**: v16 or higher (for npm/source installation).
- **Administrative Privileges**: Required for modifying the hosts file (`/etc/hosts` on macOS/Linux, `C:\Windows\System32\drivers\etc\hosts` on Windows).

## Contributing 🤝
Contributions are welcome! Fork the repository, make changes, and submit a pull request.

## What's coming next? 🔮

 - Have the package also in the Homebrew 🍺
 - Stronger block that builds discipline 🔒, you might want to do some hacking for unblocking it again 🤞