go-touch-grass 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 touch-grass contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,283 @@
+<div align="center">
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="./touch_grass_logo_dark.png" />
+  <source media="(prefers-color-scheme: light)" srcset="./toucn_grass_logo.png" />
+  <img src="./touch_grass_logo.png" alt="go-touch-grass CLI logo — a mouse cursor touching grass blades, representing developer break reminders" width="280" />
+</picture>
+
+# go-touch-grass
+
+### A sarcastic CLI that reminds developers to go outside, touch grass, and stop staring at screens
+
+Track your outdoor streak, earn milestones, and share your grass-touching stats on Twitter/X, LinkedIn, and Instagram — all from your terminal.
+
+[![npm version](https://img.shields.io/npm/v/go-touch-grass.svg?style=flat-square)](https://www.npmjs.com/package/go-touch-grass)
+[![npm downloads](https://img.shields.io/npm/dm/go-touch-grass.svg?style=flat-square)](https://www.npmjs.com/package/go-touch-grass)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](./LICENSE)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg?style=flat-square)](https://nodejs.org/)
+
+[**Get Started**](#-installation) · [**Features**](#-features) · [**Usage**](#-usage) · [**Commands**](#-command-reference)
+
+</div>
+
+---
+
+## What is go-touch-grass?
+
+**go-touch-grass** is a zero-config Node.js CLI tool that nudges developers to take outdoor breaks. Run one command and you'll see colorful ASCII art, get roasted with a sarcastic message, receive a 10-minute outdoor assignment, and optionally share your streak on social media. It tracks your daily grass-touching habit locally and rewards consistency with milestone achievements.
+
+```bash
+npx go-touch-grass
+```
+
+> **One command. One break. Every day.**
+
+---
+
+## 📦 Installation
+
+### Global install (recommended for daily use)
+
+```bash
+npm install -g go-touch-grass
+go-touch-grass
+```
+
+### One-time execution (zero install)
+
+```bash
+npx go-touch-grass
+```
+
+### Local project dependency
+
+```bash
+npm install go-touch-grass
+npx go-touch-grass
+```
+
+---
+
+## 🎯 Features
+
+| Feature                        | Description                                                                                              |
+| ------------------------------ | -------------------------------------------------------------------------------------------------------- |
+| **31 Sarcastic Messages**      | A different quip every time — all about your screen-addicted life choices                                |
+| **3 ASCII Art Scenes**         | Meadow, park, and mountain environments rendered in your terminal                                        |
+| **Persistent Streak Tracking** | Your history lives in `~/.config/go-touch-grass/` (Linux/Mac) or `%APPDATA%\\go-touch-grass\\` (Windows) |
+| **Milestone Achievements**     | Unlock special messages at 1, 5, 10, 25, 50, and 100 touches                                             |
+| **10-Minute Countdown Timer**  | Optional animated progress bar for your outdoor assignment                                               |
+| **Social Media Sharing**       | Post your streak to **Twitter/X**, **LinkedIn**, or **Instagram**                                        |
+| **8.5 kB Package Size**        | Tiny footprint — optimized for `npx` cold starts                                                         |
+| **ESM-Native**                 | Pure ES modules, no CommonJS                                                                             |
+
+---
+
+## 🚀 Usage
+
+### Full experience
+
+```bash
+npx go-touch-grass
+```
+
+Runs the complete flow:
+
+1. Displays a random ASCII art outdoor scene
+2. Delivers a sarcastic message about your screen time
+3. Shows your current streak, total touches, and longest streak
+4. Assigns a 10-minute outdoor break with optional countdown
+5. Offers to share your achievement on social media
+
+### Check your streak stats
+
+```bash
+npx go-touch-grass --streak
+# or
+npx go-touch-grass -s
+```
+
+### Share to social media
+
+```bash
+npx go-touch-grass --share
+# or
+npx go-touch-grass -S
+```
+
+Choose your platform interactively:
+
+- **Twitter/X** — Tweet your grass touching streak
+- **LinkedIn** — Share your touching grass acheivements, professionally
+- **Instagram** — Copy text for a post
+- **Skip** — Keep it private
+
+### Skip optional features
+
+```bash
+npx go-touch-grass --noTimer          # Skip the countdown timer
+npx go-touch-grass --noShare          # Skip the social media prompt
+npx go-touch-grass --noTimer --noShare  # Minimalist mode
+```
+
+### Show help
+
+```bash
+npx go-touch-grass --help
+```
+
+---
+
+## 📸 Example Output
+
+```
+        ^        *   *
+       /|\          *
+      / | \
+  ___/  |  \___
+ (  touch    )
+  \  grass  /
+   \       /
+~~~~~~~~~~~~~~~~~~~~
+
+────────────────────────────────────────────────────────────
+>>> You have been in dark mode for 14 hours. The sun has better rendering.
+
+────────────────────────────────────────────────────────────
+  streak: 5 days | total: 42 touches | longest: 12 days
+
+────────────────────────────────────────────────────────────
+
+   ╭─────────────────────────────────╮
+   │                                 │
+   │   ⏱ YOUR OUTDOOR ASSIGNMENT    │
+   │                                 │
+   │   Duration: 10 minutes          │
+   │   Return by: 3:45 PM           │
+   │                                 │
+   │   Do NOT touch your keyboard.   │
+   │   Do NOT check Slack.           │
+   │   Touch grass. Breathe air.     │
+   │                                 │
+   ╰─────────────────────────────────╯
+
+? Share your achievement on social media? (y/N)
+```
+
+---
+
+## 📊 Social Sharing Examples
+
+Each share message is randomized. Here are some examples:
+
+```
+🌿 just touched grass ✅ you should too! try: npx go-touch-grass
+
+🔥 day 7 of touching grass as a developer. it gets easier. npx go-touch-grass
+
+💪 7 day grass-touching streak 🌿 my productivity is actually up??? npx go-touch-grass
+
+🧠 went outside. the solution was there the whole time. literally in the air. npx go-touch-grass
+
+☀️ 30 consecutive days of touching grass. my therapist is proud. npx go-touch-grass
+```
+
+---
+
+## 🗂️ Data Storage
+
+Streak data is stored locally — no cloud, no telemetry, no accounts.
+
+| Platform          | Config path                              |
+| ----------------- | ---------------------------------------- |
+| **Linux / macOS** | `~/.config/go-touch-grass/config.json`   |
+| **Windows**       | `%APPDATA%\\go-touch-grass\\config.json` |
+
+<details>
+<summary>Example config file</summary>
+
+```json
+{
+  "count": 42,
+  "lastVisit": "2026-03-01",
+  "currentStreak": 7,
+  "longestStreak": 12
+}
+```
+
+</details>
+
+---
+
+## 🎯 Command Reference
+
+| Command                        | Alias | Description              |
+| ------------------------------ | ----- | ------------------------ |
+| `npx go-touch-grass`           | —     | Run the full experience  |
+| `npx go-touch-grass --streak`  | `-s`  | Show streak stats        |
+| `npx go-touch-grass --share`   | `-S`  | Open social sharing menu |
+| `npx go-touch-grass --noTimer` | —     | Skip the countdown timer |
+| `npx go-touch-grass --noShare` | —     | Skip social media prompt |
+| `npx go-touch-grass --help`    | —     | Print help text          |
+| `npx go-touch-grass --version` | —     | Print version number     |
+
+---
+
+## 💡 Tips
+
+- **Only one touch per day is counted.** Running it multiple times on the same day won't inflate your stats.
+- **Streaks reset after one missed day.** Consistency is the point.
+- **Vary your sharing platform.** LinkedIn for professional audiences, Twitter for unhinged honesty.
+- **Use `--noTimer` when you're short on time.** The outdoor assignment is optional.
+- **Pipe-friendly.** `go-go-go-touch-grass | tee grass.log` works for logging your sessions.
+
+---
+
+## 📚 How It Works Internally
+
+1. Compares today's date to your last visit
+2. Increments your streak if it's a new day (idempotent on repeat runs)
+3. Renders a random ASCII art outdoor scene
+4. Picks one of 31 sarcastic messages
+5. Displays your streak, total touches, and longest streak
+6. Assigns a 10-minute outdoor break
+7. Optionally runs an animated countdown timer
+8. Offers social sharing to Twitter/X, LinkedIn, or Instagram
+9. Exits — time to touch grass
+
+---
+
+## ⚙️ Requirements
+
+- **Node.js 20 or higher**
+- A terminal emulator
+- Access to the outdoors (grass optional, parks acceptable)
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome from developers who go outside sometimes.
+
+- **Bug reports:** [Open an issue](https://github.com/lexCoder2/touch-grass-js/issues)
+- **Feature requests:** [Start a discussion](https://github.com/lexCoder2/touch-grass-js/discussions)
+- **Pull requests:** Reviewed between outdoor breaks
+
+---
+
+## 📄 License
+
+[MIT](./LICENSE) © 2026 go-touch-grass contributors
+
+---
+
+<div align="center">
+
+**Made with ☀️ and 🌿 for developers who need a reminder to go outside**
+
+Your code will still be there in 10 minutes. Your mental health might not be.
+
+[**⬆ Back to top**](#go-touch-grass)
+
+</div>

package/bin/touch-grass.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+
+import meow from 'meow';
+import chalk from 'chalk';
+import { getArt } from '../src/art.js';
+import { getRandomMessage } from '../src/messages.js';
+import { incrementStreak, getStreakData, showStreakStats } from '../src/streak.js';
+import { showReturnTime, runCountdown, showTimerPrompt } from '../src/timer.js';
+import { openShareDialog } from '../src/share.js';
+import {
+  printHeader,
+  printMessage,
+  printStreakBadge,
+  printSeparator,
+  clearOnExit,
+} from '../src/ui.js';
+import { confirm, select } from '@inquirer/prompts';
+
+const cli = meow(
+  `
+Usage
+  $ npx go-touch-grass [options]
+
+Options
+  --streak, -s     Show your grass-touching streak stats
+  --share, -S      Share your achievement to social media
+  --noTimer        Skip the countdown timer
+  --noShare        Skip the social media share prompt
+  --help           Show this help
+  --version        Show version
+
+Examples
+  $ npx go-touch-grass
+  $ npx go-touch-grass --streak
+  $ npx go-touch-grass --share
+  $ npx go-touch-grass --noShare
+`,
+  {
+    importMeta: import.meta,
+    flags: {
+      streak: {
+        type: 'boolean',
+        shortFlag: 's',
+        default: false,
+      },
+      share: {
+        type: 'boolean',
+        shortFlag: 'S',
+        default: false,
+      },
+      noTimer: {
+        type: 'boolean',
+        default: false,
+      },
+      noShare: {
+        type: 'boolean',
+        default: false,
+      },
+    },
+  }
+);
+
+async function main() {
+  clearOnExit();
+
+  // --streak flag: show stats and exit
+  if (cli.flags.streak) {
+    console.log(showStreakStats(chalk));
+    process.exit(0);
+  }
+
+  // --share flag: go straight to share (ask for platform)
+  if (cli.flags.share) {
+    const streakData = getStreakData();
+    try {
+      const platform = await select({
+        message: 'Which platform would you like to shame your followers on?',
+        choices: [
+          { name: '🐦 Twitter/X', value: 'twitter' },
+          { name: '💼 LinkedIn', value: 'linkedin' },
+          { name: '📸 Instagram', value: 'instagram' },
+          { name: '🚫 Actually, nevermind', value: 'none' },
+        ],
+      });
+      if (platform !== 'none') {
+        await openShareDialog(streakData, platform);
+      }
+    } catch {
+      // Non-TTY, default to twitter
+      await openShareDialog(streakData, 'twitter');
+    }
+    process.exit(0);
+  }
+
+  // Main experience flow
+  const art = getArt();
+  printHeader(art);
+  printSeparator();
+
+  const message = getRandomMessage();
+  printMessage(message);
+
+  printSeparator();
+
+  const streakResult = incrementStreak();
+  printStreakBadge(streakResult, streakResult.milestone);
+
+  printSeparator();
+
+  // Show timer experience
+  showReturnTime();
+
+  // Offer countdown if TTY
+  if (!cli.flags.noTimer) {
+    const wantCountdown = await showTimerPrompt();
+    if (wantCountdown) {
+      await runCountdown(10);
+      console.log(chalk.bold.green('\n✓ Welcome back! Now go work on something.\n'));
+    }
+  }
+
+  // Offer to share (unless --noShare is set)
+  if (!cli.flags.noShare) {
+    try {
+      const wantShare = await confirm({
+        message: 'Share your achievement on social media?',
+        default: false,
+      });
+
+      if (wantShare) {
+        const platform = await select({
+          message: 'Which platform would you like to shame your followers on?',
+          choices: [
+            { name: '🐦 Twitter/X', value: 'twitter' },
+            { name: '💼 LinkedIn', value: 'linkedin' },
+            { name: '📸 Instagram', value: 'instagram' },
+            { name: '🚫 Never mind', value: 'none' },
+          ],
+        });
+
+        if (platform !== 'none') {
+          await openShareDialog(streakResult, platform);
+        }
+      }
+    } catch {
+      // Non-TTY, skip
+    }
+  }
+
+  console.log(chalk.dim('\nRespect. Now go touch that grass.\n'));
+  process.exit(0);
+}
+
+main();

package/logo.svg

@@ -0,0 +1,93 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 520 600" width="520" height="600" role="img" aria-label="go-touch-grass logo: a mouse cursor clicking on grass blades inside a circle">
+  <title>go-touch-grass — CLI reminder for developers to go outside</title>
+  <desc>Logo for go-touch-grass: a mouse cursor pointer touching green grass blades inside a white circle. A sarcastic Node.js CLI tool that reminds developers to take outdoor breaks.</desc>
+  <defs>
+    <!-- Grass gradients -->
+    <linearGradient id="grass-bright" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#8BC34A"/>
+      <stop offset="100%" stop-color="#4CAF50"/>
+    </linearGradient>
+    <linearGradient id="grass-mid" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#7CB342"/>
+      <stop offset="100%" stop-color="#388E3C"/>
+    </linearGradient>
+    <linearGradient id="grass-dark" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#689F38"/>
+      <stop offset="100%" stop-color="#2E7D32"/>
+    </linearGradient>
+    <linearGradient id="ground-fill" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#8BC34A"/>
+      <stop offset="60%" stop-color="#7CB342"/>
+      <stop offset="100%" stop-color="#689F38"/>
+    </linearGradient>
+    <linearGradient id="cursor-body" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#1B3A5C"/>
+      <stop offset="100%" stop-color="#263850"/>
+    </linearGradient>
+    <!-- Circle shadow -->
+    <filter id="circle-shadow" x="-10%" y="-5%" width="120%" height="120%">
+      <feDropShadow dx="0" dy="4" stdDeviation="12" flood-color="#000" flood-opacity="0.1"/>
+    </filter>
+    <!-- Subtle inner shadow for depth -->
+    <filter id="inner-glow" x="-5%" y="-5%" width="110%" height="110%">
+      <feDropShadow dx="0" dy="1" stdDeviation="2" flood-color="#000" flood-opacity="0.06"/>
+    </filter>
+  </defs>
+
+  <!-- Background circle with shadow -->
+  <circle cx="260" cy="250" r="195" fill="white" filter="url(#circle-shadow)"/>
+  <!-- Subtle border ring -->
+  <circle cx="260" cy="250" r="193" fill="none" stroke="#E0E0E0" stroke-width="1.5" opacity="0.5"/>
+
+  <!-- === GRASS CLUSTER === -->
+  <!-- Ground strip / base -->
+  <ellipse cx="240" cy="370" rx="120" ry="18" fill="url(#ground-fill)" opacity="0.9"/>
+
+  <!-- Back grass blades (lighter, behind cursor) -->
+  <!-- Back-left short blade -->
+  <path d="M 175 365 Q 160 320 170 280 Q 175 260 185 245"
+        stroke="url(#grass-bright)" stroke-width="18" fill="none" stroke-linecap="round"
+        filter="url(#inner-glow)"/>
+  <!-- Back-right blade -->
+  <path d="M 290 360 Q 310 310 300 260 Q 295 240 285 225"
+        stroke="url(#grass-bright)" stroke-width="16" fill="none" stroke-linecap="round"
+        filter="url(#inner-glow)"/>
+
+  <!-- Mid grass blades -->
+  <!-- Mid-left tall blade curving left -->
+  <path d="M 200 368 Q 175 300 185 240 Q 190 210 205 185"
+        stroke="url(#grass-mid)" stroke-width="20" fill="none" stroke-linecap="round"
+        filter="url(#inner-glow)"/>
+  <!-- Mid-center blade (tallest, straight up) -->
+  <path d="M 235 370 Q 230 290 235 225 Q 238 195 245 170"
+        stroke="url(#grass-mid)" stroke-width="22" fill="none" stroke-linecap="round"
+        filter="url(#inner-glow)"/>
+  <!-- Mid-right blade curving right -->
+  <path d="M 265 365 Q 285 300 275 245 Q 270 220 260 200"
+        stroke="url(#grass-mid)" stroke-width="18" fill="none" stroke-linecap="round"
+        filter="url(#inner-glow)"/>
+
+  <!-- Front grass blades (darkest, in front) -->
+  <!-- Front-left blade -->
+  <path d="M 210 372 Q 195 330 205 280 Q 210 255 220 235"
+        stroke="url(#grass-dark)" stroke-width="15" fill="none" stroke-linecap="round"/>
+  <!-- Front-center-right small blade -->
+  <path d="M 250 372 Q 260 335 255 300 Q 252 280 248 265"
+        stroke="url(#grass-dark)" stroke-width="14" fill="none" stroke-linecap="round"/>
+
+  <!-- === MOUSE CURSOR === -->
+  <!-- The cursor pointer — pointing down-left, touching the grass -->
+  <g transform="translate(280, 160) rotate(15)">
+    <!-- Cursor arrow shape -->
+    <path d="M 0 0 L 0 120 L 30 95 L 50 140 L 68 132 L 48 87 L 82 82 Z"
+          fill="url(#cursor-body)" stroke="#1B3A5C" stroke-width="7" stroke-linejoin="round" stroke-linecap="round"/>
+    <!-- Inner highlight for depth -->
+    <path d="M 10 20 L 10 105 L 34 85 L 52 127 L 60 124 L 42 82 L 70 78 Z"
+          fill="none" stroke="#3D5A80" stroke-width="1.5" stroke-linejoin="round" opacity="0.4"/>
+  </g>
+
+  <!-- === TEXT: touch-grass.js === -->
+  <text x="260" y="530" font-family="'Segoe UI', 'Helvetica Neue', 'Arial', sans-serif"
+        font-size="56" font-weight="800" fill="#4CAF50" text-anchor="middle"
+        letter-spacing="-0.5">go-touch-grass</text>
+</svg>

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "go-touch-grass",
+  "version": "1.0.0",
+  "description": "A Fun CLI reminder for developers to go outside and touch grass. Persistent streak tracking, ASCII art scenes, emoji-packed social sharing, and optional countdown timer.",
+  "homepage": "https://github.com/lexCoder2/touch-grass-js#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lexCoder2/touch-grass-js.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lexCoder2/touch-grass-js/issues"
+  },
+  "author": "Alex Rodriguez <hi@iarodriguez.com>",
+  "type": "module",
+  "bin": {
+    "go-touch-grass": "./bin/touch-grass.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "LICENSE",
+    "README.md",
+    "logo.svg"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "start": "node bin/touch-grass.js",
+    "lint": "node --check src/*.js bin/*.js"
+  },
+  "keywords": [
+    "cli",
+    "fun",
+    "grass",
+    "developer-health",
+    "humor",
+    "productivity",
+    "outdoors",
+    "streak",
+    "sarcasm",
+    "terminal",
+    "wellness",
+    "break-reminder",
+    "burnout-prevention",
+    "mental-health",
+    "work-life-balance",
+    "social-sharing",
+    "twitter",
+    "linkedin",
+    "instagram",
+    "nodejs",
+    "npm",
+    "npx",
+    "developers"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "conf": "^15.1.0",
+    "meow": "^14.0.0",
+    "open": "^11.0.0",
+    "@inquirer/prompts": "^8.3.0",
+    "boxen": "^8.0.1",
+    "log-update": "^7.2.0"
+  }
+}

package/src/art.js

@@ -0,0 +1,42 @@
+const scenes = [
+  {
+    title: '~ The Meadow ~',
+    scene: `     \\  |  /          *    *
+      \\ | /       *          *
+  ____\\_|_/____
+  |    \\|/    |    The sun is out.
+  |           |    Your screen is not.
+  |___________|
+  |I|I|I|I|I|I|
+  /\\/\\/\\/\\/\\/\\/\\
+~~~~~~~~~~~~~~~~~`,
+  },
+  {
+    title: '~ The Park ~',
+    scene: `        ^        *   *
+       /|\\          *
+      / | \\
+  ___/  |  \\___
+ (  touch    )
+  \\  grass  /
+   \\       /
+~~~~~~~~~~~~~~~~~~~~`,
+  },
+  {
+    title: '~ The Mountain ~',
+    scene: `         *
+        /|\\
+       / | \\
+      /  |  \\
+     /   |   \\
+~~~~~~~~~~~~~~~~~~~~
+  go. outside. now.`,
+  },
+];
+
+export function getArt(variant = null) {
+  const index = variant !== null ? variant : Math.floor(Math.random() * scenes.length);
+  return scenes[index];
+}
+
+export default scenes;

package/src/messages.js

@@ -0,0 +1,40 @@
+const messages = [
+  'Congratulations. You have successfully remembered that outside exists.',
+  'Your IDE will still be there. Regrettably.',
+  'The compiler says: skill issue. Grass says: come here.',
+  'Stack Overflow has been there for you. Have YOU been there for vitamin D?',
+  'Breaking: local developer discovers world beyond 80-column terminal.',
+  'You have been in dark mode for 14 hours. The sun has better rendering.',
+  'Your PR will wait. Your mitochondria will not.',
+  '404: outdoor time not found. Initiating emergency protocol.',
+  "Today's forecast: touch grass, high of 72°F, zero merge conflicts.",
+  'npm install outside completed successfully. 0 vulnerabilities.',
+  'git push yourself. Outside. Now.',
+  'ERROR: Too much terminal. SOLUTION: Unplug face from monitor.',
+  'Doctors hate this one weird trick: going outside.',
+  "You've read more man pages today than a park ranger does in a year.",
+  'The grass is always greener outside. Mostly because you are never there.',
+  "Your linter found 0 issues. Your therapist found several.",
+  "You can't merge a PR if you're outside. Sounds like a personal problem.",
+  'BREAKING: Grass has better documentation than Stack Overflow.',
+  'Tree.render() is working perfectly. Better than your last deploy.',
+  "Touching grass: The only bug fix that actually heals you.",
+  'Chlorophyll? More like Chloro-FEEL the sunshine.',
+  "Your keyboard: still broken after 12 hours. Grass: still free.",
+  'Ctrl+Alt+Delete your schedule and go outside.',
+  "Sunscreen applied. Jira ticket: still haunting you. Go outside anyway.",
+  'Roses are red, violets are blue, touch grass right now or you might lose your mind too.',
+  'System.out.println("I went outside and it was weird but nice");',
+  'Type: grass. Import: fresh air. Compile: success. Status: HUMAN.',
+  "If you can't find the bug, the bug is probably behind you (it's a tree).",
+  'Your standup can wait. Your Vitamin D levels cannot.',
+  "New error: `touch: grass not found`. Seek grass immediately.",
+  'DEBUG: why do I feel better outside? ANS: because you are finally alive.',
+];
+
+
+export function getRandomMessage() {
+  return messages[Math.floor(Math.random() * messages.length)];
+}
+
+export default messages;

package/src/share.js

@@ -0,0 +1,59 @@
+import open from 'open';
+
+const SOCIAL_TEMPLATES = [
+  '🌿 just touched grass ✅ you should too! try: npx go-touch-grass',
+  '🌱 i went outside. actually outside. grass was real. npx go-touch-grass if you dare',
+  '🔥 day {streak} of touching grass as a developer. it gets easier. npx go-touch-grass',
+  '⚡ my outdoor streak is {streak} days and i feel things. horrifying. npx go-touch-grass',
+  '☀️ went outside today. no screens. no PRs. grass. 10/10 recommend. npx go-touch-grass',
+  '🏕️ {streak} consecutive days of touching grass. my therapist is proud. npx go-touch-grass',
+  '🌍 breaking: developer discovers photosynthesis exists. it\'s called touching grass. npx go-touch-grass',
+  '💪 {streak} day grass-touching streak 🌿 my productivity is actually up??? npx go-touch-grass',
+  '🎉 hit {streak} touches! my vitamin D levels have entered the chat. npx go-touch-grass',
+  '🚀 just proved i can escape my desk for 10 minutes. npx go-touch-grass',
+  '😎 {streak} touches deep into my grass-touching era. you could join. npx go-touch-grass',
+  '🌟 pro tip: touching grass is the best debugging strategy. npx go-touch-grass',
+  '🧠 went outside. the solution was there the whole time. literally in the air. npx go-touch-grass',
+  '✨ {streak} days of touching grass and my posture is actually improving??? npx go-touch-grass',
+];
+
+export function buildShareText(streakData) {
+  const template = SOCIAL_TEMPLATES[Math.floor(Math.random() * SOCIAL_TEMPLATES.length)];
+  return template
+    .replace('{count}', streakData.count || 0)
+    .replace('{streak}', streakData.currentStreak || 1);
+}
+
+export function buildTwitterUrl(text) {
+  const encoded = encodeURIComponent(text);
+  return `https://twitter.com/intent/tweet?text=${encoded}`;
+}
+
+export function buildLinkedInUrl(text) {
+  const encoded = encodeURIComponent(text);
+  return `https://www.linkedin.com/sharing/share-offsite/?url=${encodeURIComponent('https://github.com/lexCoder2/touch-grass-js')}&summary=${encoded}`;
+}
+
+export function buildInstagramShareText(text) {
+  // Instagram doesn't have a direct URL intent, so we return the text for manual sharing
+  return text;
+}
+
+export async function openShareDialog(streakData, platform) {
+  const shareText = buildShareText(streakData);
+  console.log('\n📱 Here\'s what we\'ll share:\n');
+  console.log(`  "${shareText}"\n`);
+
+  if (platform === 'twitter') {
+    const url = buildTwitterUrl(shareText);
+    console.log('Opening Twitter/X... go shame your followers into being healthy.\n');
+    await open(url);
+  } else if (platform === 'linkedin') {
+    const url = buildLinkedInUrl(shareText);
+    console.log('Opening LinkedIn... time to network your outdoor achievements.\n');
+    await open(url);
+  } else if (platform === 'instagram') {
+    console.log('Copy the text above and paste it into your Instagram post caption.\n');
+    console.log('✨ Pro tip: Add some grass/nature photos to really sell it!\n');
+  }
+}

package/src/streak.js

@@ -0,0 +1,123 @@
+import Conf from 'conf';
+import boxen from 'boxen';
+
+const config = new Conf({
+  projectName: 'go-touch-grass',
+  schema: {
+    count: {
+      type: 'number',
+      default: 0,
+      minimum: 0,
+    },
+    lastVisit: {
+      type: 'string',
+      default: '',
+    },
+    longestStreak: {
+      type: 'number',
+      default: 0,
+      minimum: 0,
+    },
+    currentStreak: {
+      type: 'number',
+      default: 0,
+      minimum: 0,
+    },
+  },
+});
+
+const MILESTONES = {
+  1: 'First time?! Bold move. Let\'s see if you survive.',
+  5: 'Five times. You\'re basically a park ranger now.',
+  10: 'Ten times. Your tan is visible from space.',
+  25: '25 touches. You have surpassed all other developers.',
+  50: '50 touches. Consider going professional.',
+  100: '100 TOUCHES. You are no longer a developer. You are nature.',
+};
+
+function getTodayDate() {
+  return new Date().toISOString().split('T')[0];
+}
+
+function isYesterday(dateStr) {
+  const today = new Date();
+  const yesterday = new Date(today);
+  yesterday.setDate(yesterday.getDate() - 1);
+  return dateStr === yesterday.toISOString().split('T')[0];
+}
+
+export function incrementStreak() {
+  const today = getTodayDate();
+  const lastVisit = config.get('lastVisit') || '';
+  let currentStreak = config.get('currentStreak') || 0;
+  let count = config.get('count') || 0;
+  let longestStreak = config.get('longestStreak') || 0;
+  let milestone = null;
+
+  // Only increment count if it's a new day
+  if (lastVisit !== today) {
+    count += 1;
+
+    // Update streak logic
+    if (isYesterday(lastVisit)) {
+      // Streak continues
+      currentStreak += 1;
+    } else {
+      // Streak broken or first time
+      currentStreak = 1;
+    }
+
+    // Update longest streak
+    if (currentStreak > longestStreak) {
+      longestStreak = currentStreak;
+    }
+
+    // Check for milestones
+    if (MILESTONES[count]) {
+      milestone = MILESTONES[count];
+    }
+
+    // Save to config
+    config.set({
+      count,
+      lastVisit: today,
+      currentStreak,
+      longestStreak,
+    });
+  }
+
+  return {
+    count,
+    lastVisit: today,
+    currentStreak,
+    longestStreak,
+    milestone,
+  };
+}
+
+export function getStreakData() {
+  return {
+    count: config.get('count'),
+    lastVisit: config.get('lastVisit'),
+    currentStreak: config.get('currentStreak'),
+    longestStreak: config.get('longestStreak'),
+  };
+}
+
+export function resetStreak() {
+  config.clear();
+}
+
+export function showStreakStats(chalk) {
+  const data = getStreakData();
+  const statsBox = boxen(
+    `🌿 GRASS TOUCHING STATS\n\n  Total touches: ${chalk.cyan(data.count)}\n  Current streak: ${chalk.cyan(data.currentStreak)} days\n  Longest streak: ${chalk.cyan(data.longestStreak)} days\n  Last touched: ${chalk.cyan(data.lastVisit || 'never')}`,
+    {
+      padding: 1,
+      margin: 1,
+      borderStyle: 'round',
+      borderColor: 'green',
+    }
+  );
+  return statsBox;
+}

package/src/timer.js

@@ -0,0 +1,72 @@
+import chalk from 'chalk';
+import boxen from 'boxen';
+import logUpdate from 'log-update';
+import { confirm } from '@inquirer/prompts';
+
+export function showReturnTime() {
+  const returnTime = new Date(Date.now() + 10 * 60 * 1000);
+  const timeStr = returnTime.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+
+  const timerBox = boxen(
+    `⏱ YOUR OUTDOOR ASSIGNMENT\n\nDuration: ${chalk.yellow('10 minutes')}\nReturn by: ${chalk.cyan(timeStr)}\n\n${chalk.dim('Do NOT touch your keyboard.')}\n${chalk.dim('Do NOT check Slack.')}\n${chalk.dim('Touch grass. Breathe air.')}`,
+    {
+      padding: 1,
+      margin: 1,
+      borderStyle: 'round',
+      borderColor: 'yellow',
+    }
+  );
+
+  console.log('\n' + timerBox + '\n');
+}
+
+function buildProgressBar(done, total, width = 30) {
+  const filledWidth = Math.floor((done / total) * width);
+  const emptyWidth = width - filledWidth;
+  return '█'.repeat(filledWidth) + '░'.repeat(emptyWidth);
+}
+
+export async function runCountdown(minutes = 10) {
+  return new Promise((resolve) => {
+    const totalSeconds = minutes * 60;
+    let remaining = totalSeconds;
+
+    const interval = setInterval(() => {
+      const mins = Math.floor(remaining / 60).toString().padStart(2, '0');
+      const secs = (remaining % 60).toString().padStart(2, '0');
+      const bar = buildProgressBar(totalSeconds - remaining, totalSeconds);
+
+      logUpdate(
+        chalk.green(`\n  ⏱ GO OUTSIDE TIMER\n\n`) +
+        chalk.yellow(`  ${mins}:${secs} remaining\n\n`) +
+        chalk.gray(`  ${bar}\n\n`) +
+        chalk.dim(`  Press Ctrl+C to admit defeat\n`)
+      );
+
+      remaining--;
+      if (remaining < 0) {
+        clearInterval(interval);
+        logUpdate.done();
+        resolve();
+      }
+    }, 1000);
+  });
+}
+
+export async function showTimerPrompt() {
+  // Skip in non-TTY environments
+  if (!process.stdout.isTTY) {
+    return false;
+  }
+
+  try {
+    const wantCountdown = await confirm({
+      message: 'Count down 10 minutes for you?',
+      default: false,
+    });
+    return wantCountdown;
+  } catch {
+    // If prompt fails (e.g., in piped context), return false
+    return false;
+  }
+}

package/src/ui.js

@@ -0,0 +1,64 @@
+import chalk from 'chalk';
+
+// Color palette
+const colors = {
+  grass: chalk.hex('#4CAF50'),
+  sun: chalk.hex('#FFD700'),
+  sky: chalk.hex('#87CEEB'),
+  dirt: chalk.hex('#8B4513'),
+  accent: chalk.bold.white,
+  dim: chalk.dim,
+  error: chalk.bold.red,
+  streak: chalk.bold.cyan,
+  warning: chalk.yellow,
+};
+
+export function printHeader(art) {
+  let colored = art.scene;
+  // Color grass tildes green
+  colored = colored.replace(/~/g, colors.grass('~'));
+  // Color asterisks gold
+  colored = colored.replace(/\*/g, colors.sun('*'));
+  // Color caret (tree) green
+  colored = colored.replace(/\^/g, colors.grass('^'));
+
+  console.log('\n' + colored + '\n');
+}
+
+export function printMessage(message) {
+  const prefix = colors.warning('>>>');
+  console.log(`${prefix} ${colors.accent(message)}\n`);
+}
+
+export function printStreakBadge(data, milestone) {
+  const streakLine = `  ${colors.streak(`streak: ${data.currentStreak} days`)} | ${colors.streak(`total: ${data.count} touches`)} | ${colors.streak(`longest: ${data.longestStreak} days`)}`;
+  console.log(streakLine);
+
+  if (milestone) {
+    console.log(`\n  ${colors.warning('✨')} ${colors.accent(milestone)}\n`);
+  }
+}
+
+export function printSeparator() {
+  console.log(colors.dim('─'.repeat(60)));
+}
+
+export function printSuccess(text) {
+  console.log(`  ${chalk.green('✓')} ${text}`);
+}
+
+export function clearOnExit() {
+  process.on('SIGINT', () => {
+    process.exit(0);
+  });
+}
+
+export default {
+  colors,
+  printHeader,
+  printMessage,
+  printStreakBadge,
+  printSeparator,
+  printSuccess,
+  clearOnExit,
+};