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

Commands

📁 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

📈 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.