tsk installieren und anmelden

tsk ist das Kommandozeilen-Programm von tasks: eine einzelne Datei ohne Abhängigkeiten für macOS, Linux und Windows. Damit legst Du Aufgaben im Terminal an, listest sie auf und hakst sie ab, und Skripte bekommen mit --json saubere Daten.

1. Herunterladen

Wähle die Datei für Dein System und lade die Prüfsummen dazu:

• macOS (Apple Silicon)
• macOS (Intel)
• Linux (x86-64)
• Linux (ARM64)
• Windows (x86-64)
• Prüfsummen (sha256sums.txt)

Im Terminal geht es auch so. Setz bei file Deine Datei ein:

base=https://me-squibble-tasks--production.s3.eu-central-2.amazonaws.com/public/tsk/latest
file=tsk-darwin-arm64
curl -fsSLO "$base/$file"
curl -fsSLO "$base/sha256sums.txt"

2. Prüfsumme kontrollieren

So stellst Du sicher, dass die Datei unverändert bei Dir ankommt:

grep " ${file}\$" sha256sums.txt | shasum -a 256 -c -

Die Ausgabe muss tsk-darwin-arm64: OK lauten. Unter Linux geht auch sha256sum -c - statt shasum -a 256 -c -. Unter Windows vergleichst Du in PowerShell die Ausgabe von Get-FileHash tsk-windows-amd64.exe -Algorithm SHA256 mit der passenden Zeile in sha256sums.txt.

3. Installieren

mkdir -p ~/.local/bin
install -m 0755 "$file" ~/.local/bin/tsk
tsk version

tsk version zeigt die Version und die Adresse, mit der tsk spricht. Liegt ~/.local/bin noch nicht auf Deinem Pfad, ergänze ihn in Deiner Shell-Konfiguration. Unter Windows benennst Du die Datei in tsk.exe um und legst sie in einen Ordner auf Deinem PATH. Blockiert macOS den Start, hilft xattr -d com.apple.quarantine ~/.local/bin/tsk.

4. Anmelden

Erstelle in tasks unter Einstellungen → API-Tokens ein Token mit Aufgaben lesen und Aufgaben schreiben. Ohne Schreibrecht funktionieren nur ls und show. Dann:

tsk login

tsk fragt nach dem Token, ohne es anzuzeigen, prüft es bei tasks und nennt Deine Arbeitsbereiche. Gespeichert wird es in ~/.config/tsk/config.toml, lesbar nur für Dich. Ein falsches Token speichert tsk gar nicht erst. In Skripten und in CI setzt Du stattdessen die Umgebungsvariable TSK_TOKEN.

5. Die wichtigsten Befehle

tsk add '$familie #garten !p1 fr Hecke schneiden'
tsk ls
tsk ls --upcoming
tsk ls --inbox --json
tsk done 4
tsk add -p '#4' --item 'Schere kaufen' --item 'Heckenschneider mieten'
tsk mv '#5' --parent none

• tsk add versteht dieselbe Schnelleingabe wie die Web-App. Setz die Zeile in einfache Anführungszeichen, sonst liest die Shell # und ! selbst.
• tsk ls zeigt Heute, --upcoming die nächsten Termine, --inbox den Eingang.
• tsk show 4, tsk edit 4 --due 2026-10-30, tsk done 4, tsk reopen 4, tsk rm 4 und tsk restore 4 arbeiten mit der Aufgabennummer.
• Unteraufgaben: tsk add -p '#4' 'Text' (oder --parent) legt eine Unteraufgabe unter #4 an, im Arbeitsbereich der übergeordneten Aufgabe. Mit wiederholtem --item 'Text' oder Zeilen über - (stdin) entstehen mehrere auf einmal, mit oder ohne -p. Die Erfassung stoppt beim ersten Fehler, bereits angelegte Aufgaben bleiben. Die Ausgabe lautet etwa #5 Schere kaufen (under #4). Setz '#4' in Anführungszeichen, sonst liest die Shell es selbst; 4 oder die uuid gehen auch.
• tsk mv '#5' --parent '#9' hängt um, --parent none macht daraus wieder eine Aufgabe auf oberster Ebene, und tsk mv '#4' --workspace privat verschiebt eine Aufgabe in einen anderen Arbeitsbereich, Unteraufgaben ziehen mit. mv nimmt mehrere Aufgaben pro Aufruf.
• tsk ls rückt Unteraufgaben unter ihrer Aufgabe ein; passt nur die Unteraufgabe zur Ansicht, steht die übergeordnete Aufgabe als Kontextzeile dabei. tsk ls --json bleibt flach.
• Schlagwörter, Priorität und Kategorie sind Optionen: tsk ls --tag garten --priority 1, tsk edit 4 --tag +garten --priority 2 --category Haus/Garten.
• Jeder Befehl kennt --json. tsk <befehl> --help zeigt alle Optionen.

Wenn es nicht klappt

tsk endet mit einem Code, auf den sich Skripte verlassen können:

Code	Bedeutung
0	Alles gut
1	tasks hat abgelehnt, zum Beispiel ein unbekannter Arbeitsbereich
2	Falscher Aufruf, --help zeigt die Optionen
3	Nicht angemeldet oder Token ungültig: tsk login erneut ausführen