PomoDomate CLI
Il timer Pomodoro nel tuo terminale
Concentrati senza lasciare la riga di comando: sessioni Pomodoro, pause e statistiche con un solo comando.
$ pomodomate
🍅 PomoDomate — 25:00
━━━━━━━━━━░░░░░░░░░░ 12:34
[space] pausa · [s] salta · [q] esci
Installazione
Installalo con un comando da crates.io, scarica il binario Linux dalla pagina delle versioni oppure compilalo dal codice sorgente: 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
I binari pronti sono disponibili per Linux x86_64 e aarch64. La compilazione richiede una versione stabile di Rust; il binario si trova in target/release/pomodomate. La versione x86_64 include i suoni ambientali, quella aarch64 no: ALSA non supporta la compilazione incrociata utilizzata. Con cargo, aggiungi --features audio per attivare il suono.
Comandi
| Comando | Descrizione |
|---|---|
pomodomate | Avvia il timer con le impostazioni salvate (-w 50 modifica la durata solo per questo avvio) |
pomodomate stats | Mostra le statistiche delle sessioni senza aprire il timer (--json è utile per script e barre di stato) |
pomodomate daemon | Esegue il timer in background per controllarlo da qualsiasi terminale |
pomodomate ctl toggle | Invia un comando al processo attivo: toggle, pause, resume, skip, reset o quit |
La documentazione completa dei comandi, le guide e il file di configurazione sono descritti nel README del repository.
Perché usare la CLI?
Funziona offline
Nessun account, connessione o attesa. Solo tu e il tuo terminale.
Leggera ed essenziale
Nessuna scheda del browser: un semplice timer testuale nel terminale.
Codice aperto
Tutto il codice è su GitHub: consultalo, proponi miglioramenti o crea la tua versione.
Lo spirito di PomoDomate
La stessa tecnica Pomodoro delle app web e mobile, nella sua forma più essenziale.
Segui il progetto su GitHub
Il codice, le versioni e le guide sono su GitHub con licenza MIT.
Che cos’è PomoDomate CLI
PomoDomate CLI è un timer Pomodoro che funziona nel terminale: un comando avvia il ciclo di lavoro e pausa, con Domate disegnato nell’interfaccia, una notifica del desktop alla fine di ogni fase e una mappa dei giorni di concentrazione. È un singolo binario Rust con licenza MIT e funziona completamente offline: nessun account o telemetria, tutti i dati restano sul tuo dispositivo. Il pacchetto è pubblicato su crates.io (cargo install pomodomate-cli); su GitHub trovi i binari Linux x86_64 e aarch64. Puoi anche compilare il codice sorgente. È un programma separato dall’app web: le sessioni del terminale restano locali e non si sincronizzano ancora con l’account PomoDomate.
Domande frequenti
Come si installa PomoDomate CLI?
Se hai Rust, esegui cargo install pomodomate-cli: il pacchetto è pubblicato su crates.io. Senza Rust, scarica l’archivio per la tua architettura dalla pagina delle versioni GitHub, estrailo e sposta il binario pomodomate in una cartella del PATH, per esempio con sudo install -m 755 pomodomate /usr/local/bin/. Puoi anche clonare il repository ed eseguire cargo build --release; il binario verrà creato in target/release/pomodomate.
Quali comandi e scorciatoie sono disponibili?
pomodomate apre il timer. pomodomate stats mostra i totali senza aprire l’interfaccia; --json serve per script e barre di stato e --by-tag mostra il riepilogo per etichetta. pomodomate daemon mantiene il timer in background, mentre pomodomate status e pomodomate ctl permettono di leggerne lo stato e controllarlo. I parametri -w, -b, -l e -i cambiano le durate per un solo avvio, e --mute disattiva suoni e notifiche. Le impostazioni predefinite sono in ~/.config/pomodomate/config.toml. Nel timer, spazio avvia e mette in pausa, r azzera, s salta la fase, h mostra o nasconde la mappa, d cambia lo stile dell’orologio, + e - modificano i minuti, ? apre la guida e q chiude il programma.
Le sessioni del terminale contano nell’account PomoDomate?
Non ancora. La CLI conserva la cronologia in un file locale, non richiede un account e non invia dati in rete. La sincronizzazione con pomodomate.com è prevista ma non è stata ancora pubblicata: monete, esperienza, sfide settimanali e classifiche dell’account avanzano usando l’app web.
Funziona su macOS o Windows?
Le versioni pubblicate sono binari Linux e le notifiche del desktop e il rilevamento dell’inattività sono pensati per Linux. Non sono disponibili download per macOS o Windows. Su questi sistemi puoi usare la versione web nel browser: offre lo stesso ciclo Pomodoro e conserva le statistiche quando accedi al tuo account.


