Skip to content
ccmods.app

pomodoro

v0.5.0

Pomodoro timer band above the prompt with one-click 30/45/60-minute focus blocks, a break pane with chimes, and a config pane.

by @sneycampos1Updated Minimal accessGitHub

Installation

  1. Install from your shell (answer y to add the marketplace)

    $ claude plugin install pomodoro --marketplace sneycampos/claude-pomodoro

Already in a session? Type this at the Claude Code prompt:

$ /plugin install pomodoro --marketplace sneycampos/claude-pomodoro

Pick a scope and the mod is active right away. Needs Claude Code 2.1.287 or later, in a terminal. Full install guide

What does pomodoro do?

  • Idle band buttons start 30, 45 or 60 minute focus blocks (hotkeys 1, 2, 3)
  • Running band shows phase, time left and a progress bar with pause, skip and stop; turns red in the last minute
  • Break pane opens with a chime and toast; a long break follows every 4 focus blocks by default
  • Config pane and /pomodoro config set focus, break and long-break lengths
  • /pomodoro start, pause, resume, skip and stop

What do you need?

  • Claude Code 2.1.287 or later (terminal)

What can this mod access?

Read from the mod's code with claude plugin validate on Claude Code 2.1.296, synced Oct 12, 2026. This is a capability list, not a security audit. Mods run with your permissions, so install only from authors you trust.

Minimal access

No file, process, network, prompt or tool-call access found.

Hooks and engine calls (7 + 17)

hooks

  • command.run{command=pomodoro}
  • config.set{key=theme}
  • session.end
  • session.start
  • ui.render{component=AbovePrompt}
  • ui.render{component=Pane, requestId=pomodoro-config}
  • ui.render{component=Pane, requestId=pomodoro}

calls

  • $.audio.play
  • $.clock.after
  • $.clock.every
  • $.clock.now
  • $.command.register
  • $.state.get
  • $.state.set
  • $.store.delete
  • $.store.get
  • $.store.set
  • $.ui.close
  • $.ui.invalidate
  • $.ui.open
  • $.ui.panes
  • $.ui.resolve
  • $.ui.status
  • $.ui.toast

How do you uninstall pomodoro?

$ claude plugin uninstall pomodoro

To switch it off without removing it, use claude plugin disable with the same name.

Do you maintain pomodoro?

Add this badge to your README so users can jump to this page for the install command and access report.

Listed on ccmods.app
[![Listed on ccmods.app](https://ccmods.app/badge.svg)](https://ccmods.app/mods/pomodoro)

Related mods

human-in-the-loop

tzafrir/human-in-the-loop

22

Claude assigns you the tasks only you can do; they wait in a pane until you answer, and your answer goes back to Claude.

UIPromptToolsBroad access
$ claude plugin install human-in-the-loop --marketplace tzafrir/human-in-the-loop

cc-arcade

sezaakgun/cc-arcade

44

Snake, Tetris, 2048, Minesweeper, Pong and more above the prompt, plus a pet that grows as Claude tests and commits.

UIToolsCommandsModerate access
$ claude plugin install cc-arcade --marketplace sezaakgun/cc-arcade

mindful-claude

halluton/Mindful-Claude

100

Shows a guided breathing animation above the prompt while Claude works and puts the current breath phase in the spinner.

UICommandsMinimal access
$ claude plugin install mindful-claude --marketplace halluton/Mindful-Claude