# Chadodoro

> The Uncompromising GigaChad Pomodoro + Zero-Latency Git Voice Vault (Hacktoberfest 2026: "Touch Grass")

Chadodoro is a stoic, client-side productivity application designed to eliminate developer screen-lock through disciplined focus intervals followed by mandatory outdoor breaks. Pre-synthesized using open-weight Gemma 4 26B and ElevenLabs baritone audio.

## Primary Resources

- [Chadodoro Web Application](https://chadodoro.ntsd.dev/): The live production deployment of Chadodoro.
- [GitHub Repository](https://github.com/ntsd/pomodoro-chad): Full open-source repository, code, audio assets, and documentation.
- [WebMCP Tool Manifest](https://chadodoro.ntsd.dev/.well-known/webmcp.json): Web Model Context Protocol manifest declaring callable client-side tools.
- [ARD Catalog Manifest](https://chadodoro.ntsd.dev/.well-known/ard.json): Standard Agentic Resource Discovery manifest (ARD v0.91).
- [AI Catalog Manifest](https://chadodoro.ntsd.dev/.well-known/ai-catalog.json): Backward-compatible ARD discovery catalog.
- [DEV.to Challenge Article](https://dev.to/ntsd/chadodoro-the-stoic-gigachad-pomodoro-coach-that-forces-you-to-touch-physical-grass-c4n): Official Hacktoberfest 2026 challenge submission and architecture breakdown.

## Architecture & Core Tools

- [Timer Controller](https://github.com/ntsd/pomodoro-chad/blob/main/src/scripts/timerController.js): Core Pomodoro countdown engine, keyboard shortcuts, and WebMCP integration.
- [Voice Vault Scripts](https://github.com/ntsd/pomodoro-chad/tree/main/vault/scripts): 24 pre-rendered GigaChad stoic scripts generated by Gemma 4 26B and ElevenLabs.
- [Audio Manifest](https://github.com/ntsd/pomodoro-chad/blob/main/public/vault/manifest.json): JSON catalog mapping phases (Focus, Short Break, Long Break) to clips and anthems.
- [Render Deployment Spec](https://github.com/ntsd/pomodoro-chad/blob/main/render.yaml): Render static deployment configuration with edge cache rules.

## WebMCP Tools

- [getTimerState](https://chadodoro.ntsd.dev/.well-known/webmcp.json#getTimerState): Returns current Pomodoro phase, seconds remaining, running state, and grass counter.
- [startTimer](https://chadodoro.ntsd.dev/.well-known/webmcp.json#startTimer): Starts or resumes the active Pomodoro countdown.
- [pauseTimer](https://chadodoro.ntsd.dev/.well-known/webmcp.json#pauseTimer): Pauses the countdown timer.
- [resetTimer](https://chadodoro.ntsd.dev/.well-known/webmcp.json#resetTimer): Resets the current phase to its initial duration.
- [skipPhase](https://chadodoro.ntsd.dev/.well-known/webmcp.json#skipPhase): Skips immediately to the next phase (Focus -> Break -> Long Break).
- [setMode](https://chadodoro.ntsd.dev/.well-known/webmcp.json#setMode): Switches timer mode to focus, break, or long_break.
- [touchGrass](https://chadodoro.ntsd.dev/.well-known/webmcp.json#touchGrass): Increments the physical grass counter and triggers reward confetti.
- [playMotivation](https://chadodoro.ntsd.dev/.well-known/webmcp.json#playMotivation): Plays a stoic GigaChad motivational voice line from the vault.
- [toggleVoice](https://chadodoro.ntsd.dev/.well-known/webmcp.json#toggleVoice): Toggles GigaChad voice coach audio.
- [toggleBgm](https://chadodoro.ntsd.dev/.well-known/webmcp.json#toggleBgm): Toggles background anthem music.

## Optional & Related Links

- [Hacktoberfest 2026 Challenge](https://dev.to/challenges/hacktoberfest-week1-2026-10-05): Week 1 "Touch Grass" open-source AI challenge guidelines.
- [llms.txt Specification](https://llmstxt.org/): The official specification for llms.txt files.
- [Agentic Resource Discovery](https://agenticresourcediscovery.org/): The official ARD specification for autonomous agent discovery.