🔥 Vibe Coding Environment

Deep work, zero distractions. Automatically blocks time-wasting websites at the network level.

vibe is a ultra-minimal workspace orchestrator designed to help you enter flow state. It goes beyond simple browser extensions by blocking distractions at the system level using both /etc/hosts and Linux Firewall (iptables).

🚀 Why Vibe?

Most website blockers fail because:

1. Chrome DNS Caching: Browsers already know the IP, so /etc/hosts is ignored.
2. Secure DNS (DoH): Chrome bypasses system DNS entirely.
3. Weak Enforcement: It's too easy to just open a different browser.

Vibe solves this by implementing Dual-Layer Protection:

• Layer 1 (Hosts): Redirects domain names to 127.0.0.1.
• Layer 2 (Firewall): Rejects all outgoing packets to the resolved IPs of blocked sites using iptables.

🛠️ Installation

# Install globally via npm
npm install -g vibe-start

⚡ Usage

1. Initial Setup

Initialize the configuration directory (~/.vibe).

vibe setup

2. Add Distractions

Add the websites you want to stay away from.

vibe add youtube.com
vibe add instagram.com

3. Start Vibe Mode

Enter deep focus for a specified number of minutes. This requires sudo permissions to modify firewall rules.

vibe start 45

4. Stop Anytime

If you finish early or need to unblock.

vibe stop

🖥️ Platform Support

• Linux: Full support (Hosts + Firewall).
• macOS: partial support (Hosts-level only).
• Windows: Not currently supported.

🛡️ Safety & Cleanup

Vibe is designed to be robust:

• Automatic Restore: If the timer expires, settings are automatically reverted.
• State Recovery: If your terminal closes or computer crashes, running vibe stop or another vibe start will cleanly restore your original system state.
• Custom Chain: Firewall rules are managed in a separate VIBE_BLOCK chain, ensuring your existing firewall configuration is never touched.

📄 License

MIT © Priyanshu