README.md

January 23, 2026 · View on GitHub

Helm Logo

Helm

License: MIT Go Report Card GitHub Release Build Status

A minimalistic TUI Pomodoro-like timer designed for pure focus. Protect your focus and time. Customize timers, switch between modes, and control everything with simple keyboard shortcuts; right from your terminal.

Helm Demo

Installation/Update

Homebrew

brew install 0xjuanma/tap/helm

Script

curl -sSL https://raw.githubusercontent.com/0xjuanma/helm/main/scripts/install.sh | sh

Build from Source

git clone https://github.com/0xjuanma/helm.git
cd helm
go build
./helm

Usage

Start the Helm TUI by running helm in your terminal. From there, you can start, create and customize your own timer workflows to match your needs.

Controls

KeyAction
j/k or / arrowsNavigate
enterSelect
spaceStart/Pause
rReset
nSkip to next step
cCustomize workflows
escBack
qQuit

Workflows

  • Pomodoro - Classic 25/5 minute work/break cycle
  • Design Interview - Structured interview practice (customizable)
  • Custom - Create your own workflow

Sound

  • Toggle alerts on/off and switch between the terminal bell or the default macOS system sound from the workflow editor (c → pick a workflow, then adjust the sound lines).

Settings are stored in ~/.helm/settings.json. Press c to customize workflows (sound settings live inside each editor).

Author: @0xjuanma