PomoDomate CLI
Der Pomodoro, der in deinem Terminal lebt
Bleib fokussiert, ohne die Kommandozeile zu verlassen: Pomodoro-Sitzungen, Pausen und Statistiken mit einem einzigen Befehl.
$ pomodomate
🍅 PomoDomate — 25:00
━━━━━━━━━━░░░░░░░░░░ 12:34
[space] pause · [s] überspringen · [q] beenden
Installation
Installiere es mit einem Befehl von crates.io, lade das Linux-Binary von der Releases-Seite herunter oder baue es aus dem Quellcode: 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
Für Linux (x86_64 und aarch64) gibt es fertige Binaries. Zum Selbstbauen brauchst du eine stabile Rust-Toolchain; das Binary liegt danach unter target/release/pomodomate. Das x86_64-Release-Binary enthält Ambient-Sound; das aarch64-Binary nicht (ALSA lässt sich nicht cross-kompilieren). Mit cargo fügst du für Ton --features audio hinzu.
Befehle
| Befehl | Beschreibung |
|---|---|
pomodomate | Startet den Timer mit deinen gespeicherten Einstellungen (-w 50 ändert die Dauer nur für diesen Lauf) |
pomodomate stats | Gibt deine Statistiken aus, ohne den Timer zu öffnen (--json für Skripte und Statusleisten) |
pomodomate daemon | Lässt den Timer im Hintergrund laufen, damit du ihn von überall steuern kannst |
pomodomate ctl toggle | Schickt einen Befehl an den laufenden Daemon: toggle, pause, resume, skip, reset oder quit |
Die vollständige Referenz, die Anleitungen und die Konfigurationsdatei sind im README des Repositories dokumentiert.
Warum ein CLI?
Funktioniert offline
Kein Konto, keine Verbindung, kein Warten. Nur du und dein Terminal.
Leicht und ablenkungsfrei
Keine Tabs, keine Benachrichtigungen: nur ein Timer in reinem Text.
Open Source
Der gesamte Code auf GitHub: lies ihn, schlage Verbesserungen vor oder forke ihn.
Der PomoDomate-Geist
Dieselbe Pomodoro-Technik wie in der Web- und Mobile-App, in ihrer minimalsten Form.
Verfolge das Projekt auf GitHub
Code, Releases und Anleitungen liegen auf GitHub, unter MIT-Lizenz.
Was PomoDomate CLI ist
PomoDomate CLI ist ein Pomodoro-Timer, der in Ihrem Terminal läuft: Ein Befehl startet den Zyklus aus Arbeit und Pause, mit dem Domate-Maskottchen direkt im Terminal, einer Desktop-Benachrichtigung am Ende jeder Phase und einer Heatmap der Tage, an denen Sie konzentriert gearbeitet haben. Es ist ein einzelnes Rust-Binary unter MIT-Lizenz und funktioniert vollständig offline: kein Konto, keine Telemetrie, alles bleibt auf Ihrem Rechner. Es ist auf crates.io veröffentlicht (cargo install pomodomate-cli), fertige Binaries für Linux (x86_64 und aarch64) liegen auf GitHub, und Sie können es auch selbst aus dem Quellcode bauen. Es ist ein eigenständiges Programm neben der Web-App: Terminal-Sitzungen bleiben lokal und werden noch nicht mit Ihrem PomoDomate-Konto synchronisiert.
Häufige Fragen
Wie installiere ich PomoDomate CLI?
Der schnellste Weg mit installiertem Rust ist cargo install pomodomate-cli — das Crate ist auf crates.io veröffentlicht. Ohne Rust laden Sie das Archiv für Ihre Architektur von der Releases-Seite auf GitHub herunter, entpacken es und legen das Binary pomodomate in Ihren PATH — zum Beispiel mit: sudo install -m 755 pomodomate /usr/local/bin/. Sie können auch das Repository klonen und cargo build --release ausführen; das Binary liegt danach unter target/release/pomodomate.
Welche Befehle und Tastenkürzel gibt es?
Ein einfaches pomodomate öffnet den Timer. pomodomate stats gibt Ihre Summen aus, ohne ihn zu öffnen — mit --json für Skripte und Statusleisten und mit --by-tag, um zu sehen, wohin Ihre Pomodoros geflossen sind; pomodomate daemon lässt den Timer im Hintergrund laufen, während pomodomate status und pomodomate ctl ihn von überall auslesen und steuern. Flags ändern die Dauern nur für einen Lauf (-w, -b, -l, -i), --mute schaltet Ton und Benachrichtigungen stumm; Ihre Standardwerte stehen in ~/.config/pomodomate/config.toml. Im Timer selbst: Leertaste startet und pausiert, r setzt zurück, s überspringt die Phase, h blendet die Heatmap ein, d wechselt die Uhrentypografie, + und - passen die Minuten an, ? öffnet die Hilfe und q beendet.
Zählen Terminal-Sitzungen für mein PomoDomate-Konto?
Noch nicht. Das CLI ist offline-first: Es speichert Ihren Verlauf in einer lokalen Datei, verlangt kein Konto und sendet nichts nach außen. Die Synchronisierung mit pomodomate.com steht auf der Roadmap des Projekts, ist aber noch nicht da — Münzen, XP, Wochen-Challenges und Ranglisten bewegen sich nur, wenn Sie die Web-App nutzen.
Läuft es unter macOS oder Windows?
Die veröffentlichten Releases sind Linux-Binaries, und Funktionen wie Desktop-Benachrichtigungen oder die Inaktivitätserkennung sind für Linux-Desktops gebaut — einen Download für macOS oder Windows gibt es derzeit nicht. Nutzen Sie dort die Web-Version im Browser: Sie fährt denselben Pomodoro-Zyklus und bewahrt mit einem Konto Ihre Statistiken.