Debil

A modern CLI to block websites and distractions.

Features

• Block websites by domain
• Unblock websites
• List blocked websites
• Linux support (modifies /etc/hosts)

Requirements

• Python 3.14+
• uv package manager (recommended)

Installation

# Clone the repository
git clone https://github.com/DanielAdari/debil.git
cd debil

# Install using uv
uv sync

Usage

Note: You likely need sudo or root privileges to modify /etc/hosts.

# Block a site
sudo uv run debil block facebook.com

# Unblock a site
sudo uv run debil unblock facebook.com

# List blocked sites
uv run debil list-blocked

Development

# Run tests
uv run pytest

# Run linter
uv run ruff check .