Your AI can write code.
It can't touch grass.
The automated Git-native protocol that pauses your commits, generates an AI outdoor challenge, and verifies focus before pushing.
Same commands, any environment.
Plug into your setup anywhere.
npm
install
-g
git-grass
A natural rhythm for building.
Three concise steps designed to integrate intentional physical recovery into everyday source control.
Trigger a break
Run git grass or trigger your pre-commit hook after your focus interval expires. Git-Grass finger-prints your staged index safely in memory.
$ git commit -m "feat: cache"
[git-grass] Break interval reached.
Staged index preserved in memory.
Complete an outdoor challenge
Scan the terminal session link with your phone over local Wi-Fi. Step outside into open air for a 10-minute screen-free reflection tailored to your code.
Return and commit
Check in from your phone. Workstation verifies cryptographic token equality, releases the lock, and executes your commit atomically.
[ok] Token verified (constant-time).
[ok] Staged tree SHA-1 verified.
[main 8e4b2] commit created atomically.
Project-aware outdoor challenges
AST and diff analysis generates stack-relevant analogies across systems, web, graphics, audio, and ML.
Use in your preferred workflow
Wherever you code, Git-Grass hooks integrate seamlessly with terminal, Git hooks, VS Code, and Cursor.
Write custom intervals and rules
Configure focus intervals, minimum outdoor walk durations, and verification rules per repository.
# Set focus window to 90 minutes
git grass config --interval 90m
# Set outdoor walk duration
git grass config --duration 15m
# Verify local LAN environment
git grass doctor
See the CLI and hook in action.
Interactive step-by-step console demonstration from hook intercept to confirmed outdoor completion.
Learn more
Get started with Git-Grass CLI
Installation guides, Git hook setup, configuration options, and phone QR pairing.
System Architecture & Hook Gate
Local vs. cloud trust boundaries, atomic write-tree safety, and constant-time token verification.
Outdoor Challenge Catalog
Curated physical analogies across systems, web, graphics, audio, and ML.
Privacy Policy & Trust Commitments
Zero code telemetry, zero trackers, and local LAN execution guarantees.
Try Git-Grass CLI.
npm
install
-g
git-grass