utask ist eine hochperformante, asynchrone CLI & TUI App zur Synchronisation von Aufgaben zwischen Apple Reminders, Google Tasks und Microsoft To Do. Entwickelt für Power-User, die absolute Kontrolle über ihre Tasks benötigen, ohne den Terminal-Fokus zu verlieren.
👉 Offizielle Website: utask.sh
Neu hier? QUICKSTART.md (English): die ersten 10 Minuten.
Für macOS (Apple Silicon) gibt es eine fertige Datei, kein Python und kein Setup-Skript nötig. Preis nach Wahl ab 5 €: uTask Standalone. Der Quellcode bleibt offen (siehe unten).
Nach dem Klonen des Repos einfach das Setup-Skript ausführen. Es bereinigt alte Umgebungen und installiert alle Abhängigkeiten (Python 3.10+ erforderlich).
./setup.shDas Setup erstellt einen Wrapper in ~/.local/bin/utask. Stelle sicher, dass dieser Pfad in deinem $PATH ist (z.B. in deiner .zshrc oder .bash_profile).
export PATH="$HOME/.local/bin:$PATH"utask läuft "Headless". Die Sync-Engine arbeitet unsichtbar im Hintergrund, damit das UI niemals blockiert.
utask daemon-start: Installiert utask als macOSLaunchAgent. Der Sync läuft ab jetzt vollautomatisch im Hintergrund.utask daemon-stop: Stoppt den Hintergrunddienst und entfernt ihn aus dem System.utask logs: Zeigt die letzten Aktivitäten und den Status des Hintergrund-Syncs an.
utask unterstützt die Synchronisation deiner Account-Konfiguration über mehrere Macs hinweg.
Verschiebe deine Provider-Liste in den iCloud Drive (oder einen anderen Cloud-Ordner), um auf allen Geräten dieselben Listen zu sehen:
utask config set-shared "~/Library/Mobile Documents/com~apple~CloudDocs/utask"Wenn du utask auf einem weiteren Mac (z.B. Mac Studio oder MacBook) einrichtest:
- Repo klonen & Setup:
git clone ...und./setup.shausführen. - Shared Path setzen: Führe den obigen
set-sharedBefehl mit demselben Pfad aus. - Verifizieren:
utask config show(Der Pfad muss auf deinen iCloud-Ordner zeigen). - Erster Sync:
utask sync(Erkennt automatisch alle Provider aus der Cloud).
Hinweis: Deine Passwörter/Tokens werden sicher über den iCloud Schlüsselbund synchronisiert.
- Single Source of Truth: Eine lokale SQLite-Datenbank (
state.db) sorgt für blitzschnelle Latenzzeiten beim Arbeiten. - Shared State: Die
providers.jsonim Shared Directory hält die Liste deiner aktiven Provider über alle Geräte synchron. - Keychain Security: Sensitive Daten werden niemals im Klartext gespeichert, sondern direkt im nativen macOS Schlüsselbund abgelegt.
utask setup (oder in utask ui die Taste A) zeigt alle Accounts mit ihrem echten Zustand (der Login wird ausprobiert), erlaubt Hinzufügen, erneut Anmelden (r) und Entfernen (d). Auf einer frischen Installation öffnet er sich von selbst. Die Kopfzeile meldet ✖ n Accounts brauchen Anmeldung, wenn ein Login abgelaufen ist. Jeder Account hat seinen eigenen Login (zwei Google-Konten nebeneinander sind möglich), Tokens liegen im macOS-Schlüsselbund.
Alternativ per Kommandozeile, Accounts mit individuellen Labels:
- Google Tasks:
utask auth-google --label "Privat"(Folge den Anweisungen im Terminal). - Microsoft To Do:
utask auth-microsoft --client-id "DEINE_ID" --label "FH". - Apple Reminders: Wird auf macOS automatisch erkannt.
Sollte ein Provider nicht mehr synchronisieren (z.B. Fehler invalid_grant im Log), zeigt utask doctor und die Kopfzeile des Interfaces das an. Im Assistenten (A, dann r) meldest du dich erneut an. Per Kommandozeile geht es mit dem ursprünglichen Auth-Befehl und demselben Label:
# Beispiel für Google Re-Auth
utask auth-google --label "Google"Hinweis: Dank der integrierten Safety-Sync Logik bleiben deine lokalen Aufgaben bei Authentifizierungsfehlern erhalten und werden nicht gelöscht.
Starte das Interface mit: utask ui
- Sidebar (Links): Listen sind nach Provider und Label gruppiert.
j/koder Pfeiltasten: Durch die Listen oder Aufgaben navigieren.ENTER: Liste auswählen oder im Suchergebnis zum Task springen./: Globale Fuzzy-Search – Suche über alle Listen und Provider hinweg.TAB: Fokus wechseln zwischen Sidebar, Aufgabenliste und Details.
SPACE: Aufgabe erledigen / wieder öffnen.a: Schnelles Hinzufügen einer neuen Aufgabe. Mit@Datumam Ende bekommt sie eine Fälligkeit (Steuer @24.12.,Anruf @morgen).d: Markierte Aufgabe löschen.u: Letzte Löschung rückgängig machen (Undo-Stack).p: Focus Mode (Pomodoro) – Startet einen 25min Zen-Timer für volle Konzentration.i: Insights – Öffnet das Dashboard mit deinen Produktivitäts-Statistiken.v: Visual Mode – Mehrere Tasks markieren (Lila Highlight +[V]Marker):SPACE: Alle markierten auf einmal erledigen.d: Alle markierten gleichzeitig löschen.S: Alle markierten auf "Morgen" verschieben.
:: Command Bar – Profi-Befehle::theme <name>:mocha(Standard),macchiato,frappe,latte,terminal(übernimmt die Farben deines Terminals,terminal-lightfür helle) und alle Textual-Themes (nord,dracula,gruvbox,tokyo-night…);^pöffnet die Palette mit Theme-Auswahl:due <morgen | 24.12. | friday | none>(Fälligkeit der markierten Task; wird mit synchronisiert):recur <freq>(daily, weekly, monthly, none):template add "Alias" "Titel" "Beschreibung":use "Alias"(Task aus Vorlage erstellen):create list "Name" [Provider]:move <Label>(Markierte Tasks zu anderem Provider migrieren):log(Sync-Historie & technische Logs einsehen)
Templates sparen Zeit bei wiederkehrenden Projektstrukturen:
- Vorlage speichern:
:template add "deploy" "Release Deployment" "Run build, check logs, sync to origin" - Vorlage nutzen: In der Ziel-Liste einfach
:use "deploy"eingeben.
Wenn etwas nicht rund läuft oder du einen neuen Mac einrichtest, hilft der Doctor-Befehl:
utask doctorEr prüft Schreibrechte, die Erreichbarkeit deines iCloud-Pfads, den Status des Hintergrund-Daemons und die Gültigkeit deiner API-Tokens.
Füge Aufgaben direkt aus dem Terminal mit menschlicher Sprache hinzu:
utask add "Meeting mit Projektgruppe nächsten Dienstag 14:00"- Intelligenz: Erkennt automatisch Daten wie "morgen", "nächsten Freitag", "in 2 weeks".
- Automatische Zuordnung: Nutzt das Label im Listennamen (z.B.
[Apple] Reminders).
utask bietet fertige Script-Commands für Raycast, um Aufgaben blitzschnell ohne Terminal-Fokus zu verwalten.
- Öffne die Raycast Einstellungen -> Extensions -> Scripts.
- Klicke auf Add Directories und wähle den Ordner
Raycastin diesem Repository aus.
- Add Task: Tippe
add, gib deine Aufgabe ein (z.B.Pizza essen morgen 20:00) und drücke Enter. - View Today's Tasks: Zeigt dir sofort eine Liste aller Aufgaben an, die heute fällig sind.
- Keine Passwörter in Plaintext: Alle Secrets werden sicher im macOS Schlüsselbund (Keyring) gespeichert.
- Privacy First: Deine Daten gehören dir. Es gibt keinen utask-Server; der Sync erfolgt direkt zwischen deinem Mac und den Provider-APIs.
- Local-First: utask funktioniert auch offline. Änderungen werden vorgemerkt und automatisch synchronisiert, sobald du wieder online bist.
"Nice Data, No bloat, System-Integrity."