🌿

Touch Grass

A plugin that teaches your AI agent to remind you to go outside.

Weather-aware. Sunset-aware. Session-aware. Never interrupts your flow.

Claude Code

$/plugin install nalediym/touch-grass

What your agent sees

Every session starts with a context injection pulled from live weather, sunset timing, and your grass streak. Your agent decides when and how to nudge.

SessionStart hook → Claude Code context

# 🌿 Touch Grass Conditions

**72°F (22°C), clear** outside in Brooklyn.
⚠️ SUNSET IN 22 MINUTES. This is golden hour. If the user hits any natural pause, push them outside NOW.
✨ It's genuinely nice out. Suggest 🌅 catch the sunset at the next natural pause.

## User's Grass Status
🔥 3-day streak— needs to touch grass today to keep it alive. Don't let them end the session without mentioning it.

## How to Act on This
At a natural pause (feature complete, bug fixed, tests green, waiting for input), gently suggest the user step outside. Match the urgency:

- Sunset soon + nice out → push hard, specific, now
- Nice day + no grass today → firm nudge at next pause
- Streak at risk → remind before session ends

How it works

🔌

Install the plugin

One command. Bundles a SessionStart hook, MCP server, and agent skill.

📡

Ambient context

Your agent gets real weather, sunset timing, and streak state the moment a session starts.

🌿

Smart nudges

At natural pauses, your agent suggests you step outside. Specific, timely, never preachy.

What's in the box

☀️

Weather-aware

Live temperature and conditions from open-meteo. Skips nudging when the weather sucks.

🌅

Golden hour detection

Pushes harder when sunset is imminent. Golden-hour-specific activity suggestions.

🔥

Streak tracking

Local file tracks consecutive days outside. Your agent reminds you before the streak dies.

⏰

Session telemetry

Detects when you've been coding all day and firms up the nudge.

🤖

Cross-agent

MCP server works in Claude Code, Cursor, Claude Desktop, Codex. The hook is Claude Code bonus for proactive nudging.

🔒

Local and private

Everything in ~/.touch-grass/. No accounts, no API keys, no tracking.

MCP tools exposed to your agent

Any MCP-compatible agent can call these directly.

check_grass_conditionsWeather, temperature, minutes to sunset, streak state

suggest_activityRandom activity recommendation (golden-hour-aware)

log_touch_grassRecords that the user went outside, updates streak

get_statsCurrent streak, longest, total, session counts

🌿

Ready to touch grass?

Install the plugin. Start coding. Let your agent do the reminding.

$/plugin install nalediym/touch-grass