PomoDomate CLI
O Pomodoro que mora no seu terminal
Mantenha o foco sem sair da linha de comando: sessões Pomodoro, pausas e estatísticas com um único comando.
$ pomodomate
🍅 PomoDomate — 25:00
━━━━━━━━━━░░░░░░░░░░ 12:34
[space] pausar · [s] pular · [q] sair
Instalação
Instale com um comando a partir do crates.io, baixe o binário de Linux na página de releases, ou compile do código-fonte: 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
Há binários prontos para Linux (x86_64 e aarch64). Compilar do código-fonte exige uma toolchain estável do Rust; o binário sai em target/release/pomodomate. O binário x86_64 das releases vem com som ambiente; o de aarch64 não (ALSA não faz cross-compile). Com cargo, adicione --features audio para o som.
Comandos
| Comando | Descrição |
|---|---|
pomodomate | Inicia o timer com as suas configurações salvas (-w 50 muda a duração só desta execução) |
pomodomate stats | Mostra suas estatísticas sem abrir o timer (--json para scripts e barras de status) |
pomodomate daemon | Deixa o timer rodando em segundo plano para você controlá-lo de qualquer lugar |
pomodomate ctl toggle | Envia um comando ao daemon em execução: toggle, pause, resume, skip, reset ou quit |
A referência completa, os guias e o arquivo de configuração estão documentados no README do repositório.
Por que um CLI?
Funciona offline
Sem conta, sem conexão, sem espera. Só você e seu terminal.
Leve e sem distrações
Nada de abas nem notificações: só um timer em texto puro.
Código aberto
Todo o código no GitHub: leia, sugira melhorias ou faça um fork.
O espírito PomoDomate
A mesma técnica Pomodoro do app web e mobile, na sua forma mais minimalista.
Acompanhe o projeto no GitHub
O código, as releases e os guias estão no GitHub, sob licença MIT.
O que é o PomoDomate CLI
O PomoDomate CLI é um timer Pomodoro que mora dentro do seu terminal: um comando inicia o ciclo de trabalho e pausa, com o mascote Domate desenhado no próprio terminal, uma notificação do sistema ao fim de cada fase e um mapa de calor dos dias em que você focou. É um único binário em Rust com licença MIT e funciona totalmente offline: sem conta, sem telemetria e com tudo guardado na sua máquina. Ele está publicado no crates.io (cargo install pomodomate-cli), há binários prontos para Linux (x86_64 e aarch64) no GitHub, e você também pode compilá-lo a partir do código-fonte. É um programa separado do app web: as sessões do terminal ficam locais e ainda não sincronizam com a sua conta do PomoDomate.
Perguntas frequentes
Como instalo o PomoDomate CLI?
O caminho mais rápido com Rust instalado é cargo install pomodomate-cli — o crate está publicado no crates.io. Sem Rust, baixe o arquivo da sua arquitetura na página de releases do GitHub, descompacte e mova o binário pomodomate para algum lugar do seu PATH — por exemplo: sudo install -m 755 pomodomate /usr/local/bin/. Você também pode clonar o repositório e rodar cargo build --release; o binário sai em target/release/pomodomate.
Quais comandos e atalhos ele tem?
Rodar pomodomate sozinho abre o timer. pomodomate stats imprime seus totais sem abri-lo, com --json para scripts e barras de status e --by-tag para ver para onde foram seus pomodoros; pomodomate daemon deixa o timer rodando em segundo plano, enquanto pomodomate status e pomodomate ctl leem e controlam ele de qualquer lugar. As flags mudam as durações só daquela execução (-w, -b, -l, -i) e --mute silencia som e notificações; seus padrões ficam em ~/.config/pomodomate/config.toml. Dentro do timer, espaço inicia e pausa, r reinicia, s pula a fase, h mostra o mapa de calor, d troca a tipografia do relógio, + e - ajustam os minutos, ? abre a ajuda e q sai.
As sessões do terminal contam para a minha conta do PomoDomate?
Ainda não. O CLI é offline primeiro: guarda seu histórico em um arquivo local, não pede conta e não envia nada para lugar nenhum. A sincronização com o pomodomate.com está no roadmap do projeto, mas ainda não chegou: moedas, XP, desafios semanais e rankings só se movem quando você usa o app web.
Funciona no macOS ou no Windows?
As releases publicadas são binários de Linux, e recursos como notificações de desktop e detecção de inatividade foram feitos para desktops Linux, então hoje não há download para macOS nem Windows. Nesses sistemas, use a versão web no navegador: ela faz o mesmo ciclo Pomodoro e, com conta, guarda suas estatísticas.