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

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:

  devfocus add youtube.com instagram.com reddit.com

• Remove websites:

  devfocus remove youtube.com

• Toggle focus mode:

  sudo devfocus on   # Block websites
  sudo devfocus on -h 2 # Block websites for 2 hours
  
  sudo devfocus off  # Unblock websites

• List blocked websites:

  devfocus list

• Clear block list:

  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 🤞