{
  "markdown": "# Timeout - Break Reminder Plugin for Claude Code\n\nA lightweight plugin that estimates task duration, automatically opens a timer, and reminds you to step away while Claude works. Reduce passive screen time during AI-assisted coding.\n\n## Install\n\n```bash\nclaude plugin marketplace add timeout-plugin --source github --repo almandsky/timeout\nclaude plugin install timeout@timeout-plugin --scope user\n```\n\nRestart your Claude Code session to activate.\n\n## How It Works\n\n1. **You send a task** — Claude estimates how long it will take. For prompts longer than a few words, you'll see a `⏰ [Timeout]` system message reminding you that `/break` is available.\n2. **Auto timer** — If the estimate is 3+ minutes, Claude opens a Google timer in your browser and starts working immediately. No confirmation needed.\n3. **Multi-step work** — When Claude creates sub-tasks, you'll get a one-time reminder per prompt to step away while it plans.\n4. **Task reminders** — While Claude works on a single task, you'll see `⏰ [Timeout]` reminders every 3 minutes in your terminal.\n5. **Session reminders** — After 30 and 60 minutes of continuous session time, you'll get a nudge to take a break.\n\n## Skills\n\n| Skill | Description |\n|-------|-------------|\n| `/break [minutes]` | Manually open a break timer (default: 5 min) |\n| `/timeout-status` | Show session stats |\n| `/timeout-settings` | Configure the plugin |\n\n## Configuration\n\nRun `/timeout-settings` or edit `~/.timeout-plugin/config.json`:\n\n| Setting | Default | Description |\n|---------|---------|-------------|\n| `enabled` | `true` | Enable/disable the plugin |\n| `reminder_thresholds_minutes` | `[30, 60]` | Session duration reminders |\n| `default_break_minutes` | `5` | Default break duration |\n\n## Uninstall\n\n```bash\nclaude plugin uninstall timeout@timeout-plugin\nrm -rf ~/.timeout-plugin\n```\n\n## Privacy\n\nThis plugin stores only timestamps and counters locally in `~/.timeout-plugin/`. No conversation content, code, or personal data is collected or transmitted. See [PRIVACY.md](PRIVACY.md) for details.\n",
  "bytes": 2052,
  "sha": "9c9fefa1812b96dfc26fc6da26a2ce1a36db6c6fcf5f13073e873a30e5ab639a",
  "repo_slug": "almandsky/timeout",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_almandsky_timeout_timeout_c12d96f2/readme"
}