PomoDomate CLI
El Pomodoro que vive en tu terminal
Concéntrate sin salir de la línea de comandos: sesiones Pomodoro, descansos y estadísticas con un solo comando.
$ pomodomate
🍅 PomoDomate — 25:00
━━━━━━━━━━░░░░░░░░░░ 12:34
[space] pausa · [s] saltar · [q] salir
Instalación
Instálalo con un comando desde crates.io, descarga el binario de Linux desde la página de releases, o compílalo desde el código: github.com/Zapayox30/Pomodomate-cli/releases
$ cargo install pomodomate-cli
$ git clone https://github.com/Zapayox30/Pomodomate-cli.git
$ cd Pomodomate-cli
$ cargo build --release
Hay binarios ya compilados para Linux (x86_64 y aarch64). Compilar desde el código requiere una toolchain estable de Rust; el binario queda en target/release/pomodomate. El binario x86_64 de las releases trae sonido ambiental; el de aarch64 no (ALSA no cross-compila). Con cargo, añade --features audio para el sonido.
Comandos
| Comando | Descripción |
|---|---|
pomodomate | Inicia el temporizador con tu configuración guardada (-w 50 cambia la duración solo de esa ejecución) |
pomodomate stats | Muestra tus estadísticas sin abrir el temporizador (--json para scripts y barras de estado) |
pomodomate daemon | Deja el temporizador corriendo en segundo plano para manejarlo desde cualquier sitio |
pomodomate ctl toggle | Envía una orden al daemon en marcha: toggle, pause, resume, skip, reset o quit |
La referencia completa, las guías y el fichero de configuración están documentados en el README del repositorio.
¿Por qué un CLI?
Funciona offline
Sin cuenta, sin conexión, sin esperas. Solo tú y tu terminal.
Ligero y sin distracciones
Nada de pestañas ni notificaciones: solo un temporizador en texto plano.
Código abierto
Todo el código en GitHub: léelo, propón mejoras o haz tu fork.
El espíritu PomoDomate
La misma técnica Pomodoro de la app web y móvil, en su forma más minimalista.
Sigue el proyecto en GitHub
El código, las releases y las guías están en GitHub, con licencia MIT.
Qué es PomoDomate CLI
PomoDomate CLI es un temporizador Pomodoro que vive dentro de tu terminal: un comando arranca el ciclo de trabajo y descanso, con la mascota Domate dibujada en la propia terminal, una notificación de escritorio al terminar cada fase y un mapa de calor de los días que te concentraste. Es un único binario en Rust con licencia MIT y funciona del todo offline: sin cuenta, sin telemetría y con todo guardado en tu máquina. Está publicado en crates.io (cargo install pomodomate-cli), hay binarios ya compilados para Linux (x86_64 y aarch64) en GitHub, y también puedes compilarlo desde el código fuente. Es un programa aparte de la app web: las sesiones de la terminal se quedan en local y todavía no se sincronizan con tu cuenta de PomoDomate.
Preguntas frecuentes
¿Cómo instalo PomoDomate CLI?
La vía más rápida si tienes Rust es cargo install pomodomate-cli — el crate está publicado en crates.io. Sin Rust, descarga el archivo de tu arquitectura desde la página de releases de GitHub, descomprímelo y mueve el binario pomodomate a algún sitio de tu PATH; por ejemplo: sudo install -m 755 pomodomate /usr/local/bin/. También puedes clonar el repositorio y ejecutar cargo build --release; el binario queda en target/release/pomodomate.
¿Qué comandos y atajos tiene?
Ejecutar pomodomate a secas abre el temporizador. pomodomate stats imprime tus totales sin abrirlo, con --json para scripts y barras de estado y --by-tag para ver a dónde se fueron tus pomodoros; pomodomate daemon deja el temporizador corriendo en segundo plano, mientras que pomodomate status y pomodomate ctl lo leen y lo manejan desde cualquier sitio. Las banderas cambian las duraciones solo de esa ejecución (-w, -b, -l, -i) y --mute lo silencia; tus valores por defecto viven en ~/.config/pomodomate/config.toml. Dentro del temporizador, espacio inicia y pausa, r reinicia, s salta la fase, h muestra el mapa de calor, d cambia la tipografía del reloj, + y - ajustan los minutos, ? abre la ayuda y q sale.
¿Las sesiones de la terminal cuentan para mi cuenta de PomoDomate?
Todavía no. El CLI es offline primero: guarda tu historial en un fichero local, no pide cuenta y no envía nada a ninguna parte. La sincronización con pomodomate.com está en la hoja de ruta del proyecto, pero aún no ha llegado: las monedas, la XP, los desafíos semanales y los rankings solo se mueven cuando usas la app web.
¿Funciona en macOS o Windows?
Las releases publicadas son binarios de Linux, y funciones como las notificaciones de escritorio o la detección de inactividad están hechas para escritorios Linux, así que hoy no hay descarga para macOS ni Windows. En esos sistemas usa la versión web desde el navegador: hace el mismo ciclo Pomodoro y, con cuenta, conserva tus estadísticas.