🌿 Grass Toucher

A VS Code extension that forces you to leave your workspace alone and go touch some grass.

Note

On Supervised Vibe Coding This project is built using supervised vibe coding: where intuition drives exploration, and discipline shapes what stays.

🤔 The Problem

It's 11 PM. You've been "fixing one more bug" for the last four hours. Your eyes are dry, your neck hurts, and your dinner went cold two hours ago. You know you should stop, but there's always one more thing. The problem isn't that you don't know when to stop - it's that your tools don't stop you.

✅ The Solution

A VS Code extension that locks your entire workspace during a configured time window. No alerts you can dismiss, no snooze buttons — the editor is gone, replaced by a green screen reminding you to go outside. You can unlock, but only after writing down your reason (logged to a local SQLite database) and confirming three times that you really mean it.

✨ Features

• Time-Based Workspace Lockdown — Configure a start and end time; during that window, your editors, sidebar, and panels are replaced with a full-screen grass reminder
• Unlock with Accountability — Submit your reason (saved to a local database), then confirm three times before the workspace unlocks
• Unlock History — Browse all past unlock reasons with timestamps and workspace paths
• Cross-Midnight Support — Lockdown windows that cross midnight (e.g. 22:00–06:00) work correctly
• Theme-Aware — Uses VS Code's theme colors (background, foreground, buttons, inputs) so it blends in naturally
• Session-Based Unlock — Once unlocked, stays unlocked until you close VS Code; reopening within the lockdown window re-locks automatically

🖥 Screenshots

🔬 Technologies Used

⌨️ Setup

Install from VSIX

vsce package --no-dependencies --allow-missing-repository
code --install-extension grass-toucher-0.0.1.vsix

Development

git clone <repo>
cd grass-toucher
pnpm install
pnpm run compile

Press F5 in VS Code to launch an Extension Development Host.

Configuration

Setting	Default	Description
grass-toucher.lockdown.enabled	true	Enable workspace lockdown
grass-toucher.lockdown.startTime	19:00	Lockdown start time (24h)
grass-toucher.lockdown.endTime	21:00	Lockdown end time (24h)

Commands

Command	Description
I need to work — Unlock Workspace	Unlock the workspace during lockdown
View Unlock History	Browse all past unlock reasons

📁 Project Structure

src/
├── extension.ts              # Extension entry point (activate/deactivate)
├── html/                     # Webview HTML templates
│   ├── lockdown.html         # Full-screen grass reminder
│   ├── unlock.html           # Unlock reason form
│   └── history.html          # Unlock history table
└── lib/
    ├── core/
    │   ├── locker.ts         # enterLockdown, exitLockdown, enforceLockdown, checkAndApplyLockdown
    │   ├── scheduler.ts      # Time-window checking logic (dayjs)
    │   └── unlocker.ts       # Unlock flow (reason prompt + 3 confirmations)
    ├── history/
    │   ├── database.ts       # SQLite database (sql.js)
    │   └── viewer.ts         # History command + webview
    └── shared/
        ├── config.ts         # LockdownConfig, getConfig, LOCKDOWN_VIEW_TYPE
        ├── html.ts           # loadHtml template loader
        └── state.ts          # Shared mutable state + createState helper

🔌 Schema

Unlock Log Schema

Column	Type	Description
id	INTEGER	Auto-incrementing primary key
timestamp	TEXT	ISO 8601 timestamp
workspace	TEXT	Workspace folder path (or empty)
reason	TEXT	User-submitted unlock reason

📈 Status

All core functionality is complete. The extension locks, unlocks with accountability logging, and persists unlock history. Bug reports and feature requests are welcome.

🙏 Credits

• OpenCode — Assisted with construction of the extension architecture and implementation

📄 License

This project is licensed under the MIT License.