hub / github.com/0xjuanma/helm
github.com/0xjuanma/helm
Chat with this repo
116 symbols
349 edges
21 files
4 documented · 3%
● updated 6mo agov0.6.0 · 2025-12-11★ 1422 open issues
Browse by type
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
Helm
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.
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
| Key | Action |
|---|---|
j/k or ↑/↓ arrows |
Navigate |
enter |
Select |
space |
Start/Pause |
r |
Reset |
n |
Skip to next step |
c |
Customize workflows |
esc |
Back |
q |
Quit |
Workflows
- Pomodoro - Classic 25/5 minute work/break cycle
- Design Interview - Structured interview practice (customizable)
- Custom - Create your own workflow
- Quick Timer -
helm --quick <minutes>for a single-stage timer, no menu
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
Core symbols most depended-on inside this repo
Shape
Languages
Go100%
Modules by API surface
internal/tui/customize.go16 symbols
internal/config/config.go15 symbols
internal/tui/update.go11 symbols
internal/timer/timer.go11 symbols
internal/timer/session_test.go10 symbols
internal/timer/timer_test.go9 symbols
internal/tui/model.go8 symbols
internal/timer/session.go7 symbols
internal/tui/view.go6 symbols
internal/config/storage.go5 symbols
internal/workflow/workflow.go3 symbols
internal/sound/sound.go3 symbols
Dependencies from manifests, versioned
github.com/aymanbagabas/go-osc52/v2v2.0.1 · 1×
github.com/charmbracelet/bubblesv0.21.0 · 1×
github.com/charmbracelet/bubbleteav1.3.10 · 1×
github.com/charmbracelet/colorprofilev0.2.3-0.20250311203 · 1×
github.com/charmbracelet/harmonicav0.2.0 · 1×
github.com/charmbracelet/lipglossv1.1.0 · 1×
github.com/charmbracelet/x/ansiv0.10.1 · 1×
github.com/charmbracelet/x/cellbufv0.0.13-0.2025031120 · 1×
github.com/charmbracelet/x/termv0.2.1 · 1×
github.com/erikgeiser/coninputv0.0.0-2021100415322 · 1×
github.com/inconshreveable/mousetrapv1.1.0 · 1×
github.com/lucasb-eyer/go-colorfulv1.2.0 · 1×